Erreurs de l'API

L’API Web Scraping renvoie des codes de statut HTTP standard. Les réponses non-2xx incluent un corps JSON avec un champ error décrivant le problème rencontré.

Codes d’erreur

Code	Signification
400	Bad Request. La requête est mal formée ou contient des paramètres invalides. Également renvoyé lorsque l’URL cible n’a pas pu être scrapée.
401	Unauthorized. La clé API est manquante, invalide, ou le quota de crédits est dépassé.
403	Forbidden. Votre plan n’inclut pas cette fonctionnalité (par exemple le rendu JavaScript ou la géolocalisation par pays). Mettez à niveau votre abonnement pour l’utiliser.
406	Not Acceptable. Le format de réponse demandé n’est pas pris en charge.
422	Unprocessable Entity. La requête était valide mais n’a pas pu être satisfaite. Causes courantes : le site cible a renvoyé un CAPTCHA sous un 200 OK, le HTML de la réponse est vide, un profil Instagram a renvoyé la page de connexion, ou un sélecteur wait_for_css n’est jamais apparu.
429	Too Many Requests. Vous envoyez des requêtes trop rapidement ou en exécutez trop en parallèle. Google peut également renvoyer ce code lorsqu’il détecte le scraper.
500	Internal Server Error. Un problème est survenu de notre côté. Réessayez sous peu.
503	Service Unavailable. L’API est temporairement hors ligne pour maintenance. Réessayez plus tard.

Sémantique des tentatives

Note

Les réponses 422 et 5xx peuvent être retentées sans risque après un court délai d’attente. Les réponses 4xx autres que 429 indiquent généralement un problème côté client qu’une nouvelle tentative ne résoudra pas.

• Retentez 500 et 503 avec un délai d’attente exponentiel (par exemple 1s, 2s, 4s).
• Retentez 429 après une pause, et réduisez la concurrence des requêtes.
• Ne retentez pas 400, 401, 403, ou 406 sans modifier la requête.

Voir aussi

• Web Scraping API - point d’entrée du endpoint
• Basic request - exemple d’appel minimal