Pular para o conteúdo
POST AI agent ready /v1/useragent/parse

API User Agent Parser - Detectar navegador, sistema operacional e dispositivo

Analisa uma string de agente de usuário em componentes de navegador, mecanismo, sistema operacional e dispositivo. Detecta bots, rastreadores e navegadores headless. Se nenhum campo user_agent for fornecido, o cabeçalho User-Agent do chamador será usado.

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

Crie um painel de compatibilidade do navegador

Analise strings de agente de usuário de seus registros analíticos para calcular a porcentagem de visitantes em cada navegador e versão. Identifique quando as versões antigas do navegador ficam abaixo do seu limite de suporte para que você possa desativar os polyfills e reduzir o tamanho do pacote.

Filtre o tráfego de bot a partir de métricas de conversão

Antes de contar uma visualização de página ou evento de inscrição, analise o agente do usuário e verifique o sinalizador is_bot. Exclua o tráfego de bot dos seus relatórios de funil de conversão para obter números precisos de visitantes humanos reais.

Sirva respostas otimizadas para dispositivos

Analise o agente do usuário na borda para determinar se o visitante está em um celular, tablet ou desktop. Devolva uma carga útil mais leve para usuários de dispositivos móveis ou redirecione os visitantes de tablets para um layout otimizado para toque.

Frequently asked questions

Que tipos de bot esse endpoint detecta?
Ele detecta rastreadores de mecanismos de pesquisa (Googlebot, Bingbot), bots de mídia social (Twitterbot, Facebot), ferramentas de monitoramento, navegadores sem cabeça (Puppeteer, Playwright) e bibliotecas comuns de scraping.
O que acontece se a string do agente do usuário estiver malformada?
O analisador extrai o máximo de informações possível. Os campos que ele não pode determinar são retornados como nulos. O endpoint não retorna um erro para strings não reconhecidas.
Posso detectar o fabricante do dispositivo?
Sim. O objeto do dispositivo inclui o fornecedor (por exemplo, Apple, Samsung, Google) e o modelo (por exemplo, iPhone, Galaxy S24) quando o agente do usuário contém essas informações.
Isso funciona com agentes de usuário que não são de navegador?
Sim. Ele lida com agentes de usuário de solicitações curl, Postman, Python e outras bibliotecas HTTP. Eles são analisados ​​com o nome e a versão da ferramenta.
E se eu não enviar um campo user_agent?
O endpoint analisa automaticamente o cabeçalho User-Agent da sua solicitação HTTP. Isso permite detectar o navegador e o dispositivo do seu próprio cliente sem extrair o cabeçalho sozinho.

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