Limites
Le débit autorisé par clé, les en-têtes qui l'annoncent, la conduite à tenir en cas de dépassement et les autres limites de l'API.
Documentation de l'APIGuides · Limites
Débit par clé
Chaque clé dispose de 120 appels par minute. La fenêtre est la minute calendaire, en UTC : le compteur repart de zéro au début de chaque minute.
- Chaque appel avec clé compte pour un appel, y compris ceux qui reçoivent une page vide. Deux exceptions : la demande d'un brouillon à l'IA,
POST /v1/reviews/{reviewId}/reply-drafts, compte pour 5, et l'envoi d'un événement de test,POST /v1/webhook-endpoints/{endpointId}/test, pour 10. GET /v1/healthetGET /v1/openapi.jsonne demandent pas de clé et ne comptent pas.- Une clé qui dépasse sa limite ne pénalise pas les autres clés du compte. Donnez une clé à chaque intégration.
Au-delà de la limite, l'API répond 429 rate_limited, sans effet sur vos données.
En-têtes de débit
Les réponses aux appels admis et les réponses 429 portent l'état de la minute en cours :
| En-tête | Valeur |
|---|---|
RateLimit-Limit | Nombre d'appels autorisés par minute pour la clé. |
RateLimit-Remaining | Nombre d'appels restants dans la minute en cours. |
RateLimit-Reset | Nombre de secondes avant la minute suivante. |
Retry-After | Sur une réponse 429 ou 503 : nombre de secondes à attendre avant de renvoyer la requête. |
HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json; charset=utf-8
RateLimit-Limit: 120
RateLimit-Remaining: 0
RateLimit-Reset: 17
Retry-After: 17
X-Request-Id: req_Qm9uam91ciBNYSBCZWxsZQ
Ces en-têtes peuvent manquer, par exemple sur une erreur d'authentification : ne les supposez pas toujours présents. GET /v1/me renvoie aussi la limite de la clé dans rateLimit (limit appels par fenêtre de windowSeconds secondes).
Bonnes pratiques
- Respectez
Retry-Afteravant de renvoyer une requête refusée. - Étalez vos appels sur la minute plutôt que de tous les lancer en rafale.
- Sur une réponse
503 service_unavailable, attendez le délai indiqué, puis augmentez l'attente à chaque nouvel échec. - Lisez la limite dans les en-têtes ou dans
GET /v1/meplutôt que de l'écrire en dur : elle peut être relevée.
Autres limites
| Limite | Valeur |
|---|---|
| Clés actives par compte | 10 |
| Éléments par page d'une liste | de 1 à 100, 25 par défaut |
| Période des statistiques | 366 jours au pas journalier, 10 ans au pas mensuel, 30 derniers jours par défaut |
| Taille d'un corps de requête, pour les opérations qui en acceptent un | 1 Mio, au-delà 413 payload_too_large |
| Historique des appels affiché dans l'application | 14 jours |
| Clé d'idempotence | 255 caractères, conservée 24 heures |
| Points de réception webhook par compte | 10, désactivés compris |
| Réponse attendue d'un point de réception | statut 2xx en moins de 10 secondes |
| Conservation des événements et des livraisons | 30 jours |
Deux opérations ont en plus une limite propre : la validation des codes promo limite les tentatives par clé, contre la recherche de codes au hasard, et la publication sur Google limite les écritures de chaque établissement. Au-delà, elles répondent aussi 429 rate_limited, avec Retry-After.
Ces valeurs peuvent être relevées sans préavis : augmenter une limite n'est jamais un changement cassant.
Mis à jour le 25 octobre 2026