Aller au contenu
POST AI agent ready /v1/useragent/parse

API User Agent Parser - Détecter le navigateur, le système d'exploitation et l'appareil

Analyse une chaîne d'agent utilisateur en composants de navigateur, de moteur, de système d'exploitation et de périphérique. Détecte les robots, les robots d'exploration et les navigateurs sans tête. Si aucun champ user_agent n'est fourni, l'en-tête User-Agent de l'appelant est utilisé.

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

Créer un tableau de bord de compatibilité du navigateur

Analysez les chaînes d'agent utilisateur de vos journaux d'analyse pour calculer le pourcentage de visiteurs sur chaque navigateur et version. Identifiez quand les anciennes versions du navigateur tombent en dessous de votre seuil de support afin de pouvoir supprimer les polyfills et réduire la taille du bundle.

Filtrer le trafic des robots à partir des mesures de conversion

Avant de compter une page vue ou un événement d'inscription, analysez l'agent utilisateur et vérifiez l'indicateur is_bot. Excluez le trafic des robots de vos rapports sur l'entonnoir de conversion pour obtenir des chiffres précis sur les vrais visiteurs humains.

Proposer des réponses optimisées pour les appareils

Analysez l'agent utilisateur en périphérie pour déterminer si le visiteur est sur mobile, tablette ou ordinateur de bureau. Renvoyez une charge utile plus légère pour les utilisateurs mobiles ou redirigez les visiteurs des tablettes vers une mise en page optimisée pour le toucher.

Frequently asked questions

Quels types de robots ce point de terminaison détecte-t-il ?
Il détecte les robots des moteurs de recherche (Googlebot, Bingbot), les robots des réseaux sociaux (Twitterbot, Facebot), les outils de surveillance, les navigateurs sans tête (Puppeteer, Playwright) et les bibliothèques de scraping courantes.
Que se passe-t-il si la chaîne de l'agent utilisateur est mal formée ?
L'analyseur extrait autant d'informations que possible. Les champs qu'il ne peut pas déterminer sont renvoyés comme nuls. Le point de terminaison ne renvoie pas d'erreur pour les chaînes non reconnues.
Puis-je détecter le fabricant de l’appareil ?
Oui. L'objet appareil inclut le fournisseur (par exemple Apple, Samsung, Google) et le modèle (par exemple iPhone, Galaxy S24) lorsque l'agent utilisateur contient ces informations.
Cela fonctionne-t-il avec des agents utilisateurs non-navigateurs ?
Oui. Il gère les agents utilisateurs des requêtes curl, Postman, Python et autres bibliothèques HTTP. Ceux-ci sont analysés avec le nom et la version de leur outil.
Que faire si je n'envoie pas de champ user_agent ?
Le point de terminaison analyse automatiquement l'en-tête User-Agent de votre requête HTTP. Cela vous permet de détecter le navigateur et l'appareil de votre propre client sans extraire vous-même l'en-tête.

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