Limites de taux

Limites

Chaque clé API peut faire des requêtes 60 par minute. La limite est comptée par clé, de sorte que les clés séparées ont des budgets séparés.

La période d'essai active, Basic ou Pro dispose également d'une allocation de demande d'API totale. Les demandes qui les consomment sont comptées par entreprise et par période. Sans période active, les demandes de données protégées retournent 403 forbidden; après sa 429 rate_limited. GET /v1/usage indique l'allocation actuelle sans la consommer. La limite par clé de 60/minute s'applique toujours.

Lorsque vous atteignez la limite

L'API répond avec 429 Too Many Requests, le corps d'erreur standard et un en-tête Retry-After avec le nombre de secondes à attendre.

{
    "error": {
        "code": "rate_limited",
        "message": "Too many requests."
    },
    "request_id": "0c998db5-ab69-49f5-8058-227973e19dbc"
}

Rester dans la limite

• Attendez Retry-After avant de réessayer, et ajoutez jitter si plusieurs travailleurs partagent une clé.
• Utilisez per_page jusqu'à 100 pour en savoir plus sur chaque demande.
• Donnez des clés séparées de systèmes pour qu'une intégration occupée ne ralentisse pas une autre.