Erreurs API et limites de débit

Les erreurs retournent { "error": { "code": "…", "message": "…", "details": … } } avec un statut HTTP correspondant.

• 400 invalid_parameter : un paramètre de requête tel que since, until ou outcome est mal formé.
• 401 unauthorized : clé manquante, invalide ou révoquée.
• 403 plan_required : l'accès API nécessite un plan Scale ou supérieur sur au moins un site web.
• 403 insufficient_scope : la clé est en lecture seule.
• 429 cooldown, concurrency, daily_quota, monthly_quota, competitor_quota ou host_busy : une limite d'audit SEO s'applique ; voir retry_at et Retry-After.
• 403 org_suspended : contactez le support.
• 404 not_found : la ressource n'existe pas dans votre organisation.
• 409 conflict : le terme de recherche existe déjà pour ce pays et cet appareil.
• 422 validation_failed / limit_exceeded / plan_required / project_unverified : voir message et détails.
• 429 rate_limited : attendez Retry-After secondes.
• 500 internal_error : réessayez ; contactez le support si cela persiste.
• 503 unavailable : l'API est temporairement indisponible ; réessayez avec un délai progressif.

Limites de débit

120 requêtes par minute par clé. Une réponse 429 inclut Retry-After : 60. Chaque requête est enregistrée contre la clé, et la dernière utilisation de la clé (mise à jour au maximum une fois par minute) est affichée dans Paramètres → Clés API.

Limites du forfait

Ajouter ou modifier des termes ne réduit jamais silencieusement vos chiffres : si une requête dépasse la limite de termes de recherche ou de clics par jour du site web, elle échoue avec 422 et indique ce qui reste.