Quotas & limites

L’usage est régi par deux limites : un quota mensuel (selon l’offre) et une limite horaire. Les deux s’appliquent par clé API.

En-têtes de limite#

Chaque réponse indique votre usage courant pour vous permettre de réguler à l’avance :

X-RateLimit-Limit: 50000
X-RateLimit-Remaining: 48766
X-RateLimit-Reset: 1751328000
X-Plan: pro

• X-RateLimit-Limit — votre quota mensuel.
• X-RateLimit-Remaining — appels restants pour la période.
• X-RateLimit-Reset — heure Unix de réinitialisation.
• X-Plan — votre offre actuelle.

Quand vous atteignez une limite#

Dépasser la limite horaire ou le quota mensuel renvoie 429 Too Many Requests avec l’heure de réinitialisation. Les appels à /me ne comptent pas dans votre quota.

{
  "success": false,
  "error": "Monthly quota exceeded",
  "plan": "free",
  "limit": 1000,
  "resetAt": "2026-07-01T00:00:00.000Z"
}