Skip to main content
L’API accepte 120 requêtes par minute et par clé. La fenêtre est fixe : le compteur repart de zéro à chaque nouvelle minute, il ne glisse pas. La limite s’applique par clé, pas par workspace. Deux clés du même workspace disposent chacune de leur propre budget — c’est un argument de plus pour créer une clé par usage.

En-têtes

Toute réponse authentifiée porte l’état du compteur :
Une réponse 401 ne porte pas ces en-têtes : le compteur n’est consulté qu’une fois la clé reconnue. Une clé invalide ne consomme donc pas votre budget.

Dépassement

Au-delà de 120 requêtes, l’API répond 429 :
Attendez le délai indiqué par Retry-After puis rejouez la requête. Elle n’a produit aucun effet : l’API est en lecture seule, un 429 ne laisse rien derrière lui.

Respecter la limite

Ne remplacez pas Retry-After par un back-off exponentiel maison. Sur une fenêtre fixe, un back-off qui double à l’aveugle attend systématiquement plus longtemps qu’il ne faut, et plusieurs clients repartent en même temps à la réouverture.

Rester loin de la limite

  • Paginez à limit=200 plutôt qu’à 50 : quatre fois moins de requêtes pour le même volume.
  • Utilisez since pour ne relire que ce qui a bougé.
  • Ne sondez pas l’API en boucle courte. Les données bougent au rythme des visites de votre site : un passage toutes les cinq à quinze minutes suffit très largement, même pour une remontée « temps réel » perçue.