Docs
Se connecter

User Agents API

Endpoint gratuit, à débit limité, qui retourne une chaîne User-Agent aléatoire optimisée pour le crawling web. À utiliser lorsque vous exécutez votre propre crawler en dehors du pipeline Crawlbase.

Gratuit à l'usage

L'API User Agents est entièrement gratuite, quel que soit votre plan Crawlbase. Limitée à 1 requête par seconde.

Vue d'ensemble

Retourne une chaîne User-Agent aléatoire optimisée pour le crawling web. La logique de sélection privilégie les UA qui paraissent naturels dans le trafic de production : versions modernes de Chrome, Firefox et Safari sur desktop et mobile, pondérées pour correspondre à l'usage réel.

Endpoint :https://api.crawlbase.com/user_agents

Démarrage rapide

curl 'https://api.crawlbase.com/user_agents?token=YOUR_TOKEN'

Retourne une seule chaîne User-Agent. Utilisez-la directement dans l'en-tête User-Agent de votre requête HTTP sortante.

Paramètres

token
chaînerequis
Votre token Crawlbase. L'endpoint est gratuit, mais le token est nécessaire pour la comptabilisation du débit limité.
device
desktop | tablet | mobiledesktop
Filtre par classe d'appareil. Utile lorsque votre scraper a besoin d'UA réalistes pour un mix de plateformes spécifique.
size
entier1
Nombre d'UA à retourner par appel. Maximum 10. Combinez avec device pour pré-filtrer, puis mettez le lot en cache côté client et faites tourner localement : c'est à la fois plus rapide et cela évite la limite de 1 req/s.

Limite de débit

1 requête par seconde. Mettez les chaînes UA en cache côté client et faites-les tourner vous-même plutôt que d'appeler à chaque requête : c'est à la fois plus rapide et cela évite d'atteindre la limite.

Quand l'utiliser

Vous n'en avez besoin que si vous exécutez votre propre crawler contre des sites qui ne passent pas par Crawlbase. La Crawling API et le Smart AI Proxy gèrent déjà la randomisation des UA automatiquement : vous n'avez pas besoin de définir User-Agent sur les requêtes qui les traversent.