Перейти к содержимому
POST AI agent ready /v1/useragent/parse

API-интерфейс User Agent Parser — определение браузера, ОС и устройства

Разбирает строку пользовательского агента на компоненты браузера, ядра, ОС и устройства. Обнаруживает ботов, сканеров и автономные браузеры. Если поле user_agent не указано, используется заголовок User-Agent вызывающей стороны.

Parameters

stringrequired

User agent string to parse.

Code examples

curl -X POST https://api.botoi.com/v1/useragent/parse \
  -H "Content-Type: application/json" \
  -d '{"user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"}'

When to use this API

Создайте панель совместимости браузера

Анализируйте строки пользовательского агента из журналов аналитики, чтобы рассчитать процент посетителей в каждом браузере и версии. Определите, когда старые версии браузера окажутся ниже порога поддержки, чтобы вы могли прекратить использование полифилов и уменьшить размер пакета.

Фильтрация трафика ботов по показателям конверсии

Прежде чем подсчитывать просмотр страницы или событие регистрации, проанализируйте пользовательский агент и проверьте флаг is_bot. Исключите трафик ботов из отчетов по воронке конверсии, чтобы получить точные цифры по реальным посетителям.

Предоставляйте ответы, оптимизированные для устройств

Анализируйте пользовательский агент на границе, чтобы определить, использует ли посетитель мобильное устройство, планшет или настольный компьютер. Уменьшите полезную нагрузку для мобильных пользователей или перенаправьте посетителей с планшетов на макет, оптимизированный для сенсорного управления.

Frequently asked questions

Какие типы ботов обнаруживает эта конечная точка?
Он обнаруживает сканеры поисковых систем (Googlebot, Bingbot), ботов социальных сетей (Twitterbot, Facebot), инструменты мониторинга, безголовые браузеры (Puppeteer, Playwright) и распространенные библиотеки очистки.
Что произойдет, если строка пользовательского агента имеет неверный формат?
Парсер извлекает как можно больше информации. Поля, которые он не может определить, возвращаются как нулевые. Конечная точка не возвращает ошибку для нераспознанных строк.
Могу ли я определить производителя устройства?
Да. Объект устройства включает производителя (например, Apple, Samsung, Google) и модель (например, iPhone, Galaxy S24), если пользовательский агент содержит эту информацию.
Работает ли это с пользовательскими агентами, не являющимися браузерами?
Да. Он обрабатывает пользовательские агенты из запросов Curl, Postman, Python и других HTTP-библиотек. Они анализируются с указанием имени и версии инструмента.
Что если я не отправлю поле user_agent?
Конечная точка автоматически анализирует заголовок User-Agent из вашего HTTP-запроса. Это позволяет вам определить браузер и устройство вашего клиента, не извлекая заголовок самостоятельно.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs