--- title: "Limites de débit et quotas de l'API Surfer" description: "Une référence rapide des limites de débit par point de terminaison, des quotas d'utilisation par outil, et de la façon de les surveiller par programmation, pour que vos intégrations ne se heurtent pas à des obstacles inattendus." url: https://docs.surferseo.com/fr/articles/12944182-limites-de-debit-et-quotas-de-l-api-surfer collection: "API" updated: 2026-10-22 language: fr alternates: [en, de] --- # Limites de débit et quotas de l'API Surfer Une référence rapide des limites de débit par point de terminaison, des quotas d'utilisation par outil, et de la façon de les surveiller par programmation, pour que vos intégrations ne se heurtent pas à des obstacles inattendus. ## ⏱ Limites de débit Tous les points de terminaison appliquent une **limite de débit par seconde ou par minute**. Le dépassement renvoie `429 Too Many Requests`.

Groupe de points de terminaison	Limite de débit
La plupart des points de terminaison (GET + POST)	10 requêtes / sec
Lot Analyse SERP	10 requêtes / min
AI Detector	60 requêtes / min

Lorsque vous recevez une erreur 429, attendez avant de réessayer. Consultez l'en-tête `Retry-After` de la réponse pour savoir combien de temps attendre, puis réessayez. Utilisez un backoff exponentiel pour les flux de travail automatisés. ##### Surveiller les limites de débit via les en-têtes de réponse Chaque réponse de l'API V2 inclut ces en-têtes pour que vous puissiez suivre les limites avant de les atteindre :

En-tête	Type	Ce qu'il vous indique
`x-ratelimit-limit`	integer	Nombre maximal de requêtes autorisées dans la fenêtre actuelle pour ce point de terminaison
`x-ratelimit-remaining`	integer	Requêtes restantes avant d'être soumis à une limite de débit (`0` = la prochaine requête sera bloquée)
`x-ratelimit-reset`	integer	Timestamp Unix (en secondes) du moment où la fenêtre se réinitialise

Lire `x-ratelimit-remaining` dans votre intégration vous permet de ralentir de manière proactive, au lieu d'attendre un 429. * * * ## 📊 Quotas d'utilisation Les quotas sont distincts des limites de débit : ils suivent le nombre de requêtes que vous avez consommées au cours d'une période de facturation. Les limites ci-dessous sont conformes à notre [Politique d'utilisation équitable](https://docs.surferseo.com/en/articles/12944161-fair-usage-policy.md), pour l'offre Peace of Mind. Les limites Enterprise étant personnalisées, contactez votre Customer Success Manager pour vérifier votre quota, ou consultez votre tableau de bord [Utilisation](https://app.surferseo.com/settings/current_usage) dans les Paramètres.

Outil	Quota (mensuel · annuel)	Ce qui se passe en cas de dépassement
Éditeur de contenu (Documents)	500 / mois · 6 000 / an (Peace of Mind) · Personnalisé (Enterprise)	`422 Quota exceeded`
Audit	100 / mois · 1 200 / an	`422 Quota exceeded`
Analyse SERP	100 requêtes / jour	`422 Quota exceeded`
Auto-optimisation	100 / jour	`422 Quota exceeded`
Humanizer et AI Detector	50 000 mots / mois · 600 000 mots / an (tous les plans)	`422 Quota exceeded`

> **Success:** Remarque : il n'existe actuellement aucun point de terminaison API pour vérifier les crédits restants ou l'utilisation du quota par programmation. Pour éviter d'atteindre les limites en cours d'exécution, suivez votre propre utilisation ou consultez votre tableau de bord avant les tâches de traitement par lots importantes. * * * ## **Ressources supplémentaires :** [Introduction à l'API Surfer](https://docs.surferseo.com/en/articles/5700335-surfer-api-introduction.md) [Documentation de l'API Surfer (v1)](https://app.surferseo.com/api/v1/docs#section/Introduction) [Documentation de l'API Surfer (v2)](https://app.surferseo.com/api/v2/docs) [Exemples d'utilisation de l'API Surfer](https://docs.surferseo.com/en/articles/8201326-surfer-api-examples-of-use.md)