Limites de débit & quotas

Skoup applique deux sortes de limites : les limites de débit, qui protègent l’API des abus, et les quotas métier, qui viennent de votre plan. Les deux sont exposés sur chaque réponse concernée : votre intégration n’a jamais à deviner.

Limites de débit

Les limites sont comptées par clé API :

Limite	Valeur
Requêtes par minute	120
Requêtes par jour	20 000
Écritures (`POST`, `PATCH`, `DELETE`) par minute	50

Chaque réponse porte l’état courant des limites :


X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 1790150460
X-RateLimit-Daily-Limit: 20000
X-RateLimit-Daily-Remaining: 19842
X-RateLimit-Daily-Reset: 1790208000

Les valeurs *-Reset sont des timestamps Unix (secondes, UTC) auxquels la fenêtre repart à zéro.

Au-delà d’une limite, les requêtes échouent en 429 rate_limit_exceeded, avec un en-tête Retry-After donnant le nombre de secondes à attendre :


HTTP/1.1 429 Too Many Requests
Retry-After: 23

Les requêtes sans clé ou avec une clé invalide sont limitées par adresse IP. Des échecs d’authentification répétés depuis une même adresse la bloquent temporairement.

Besoin d’une limite plus haute ? Écrivez-nous avec votre cas d’usage. La plupart des intégrations qui atteignent la limite font du polling — les webhooks sont en général le bon outil.

Quotas métier

Certaines ressources sont plafonnées par votre plan. Les endpoints concernés exposent le quota dans un en-tête Skoup-Quota-{Nom}, au format des en-têtes RateLimit de l’IETF :


Skoup-Quota-Queries: limit=150, remaining=12
Skoup-Quota-Verifications: limit=10, remaining=7, reset=1790208000
Skoup-Quota-Competitors: limit=5, remaining=2

En-tête	Envoyé sur	Compte
`Skoup-Quota-Queries`	`…/queries`	Requêtes actives, tous marchés confondus, face au quota de votre plan.
`Skoup-Quota-Verifications`	`…/alerts/{id}/verify`	Re-samplings ciblés par marque et par jour.
`Skoup-Quota-Competitors`	`…/competitors`	Marques concurrentes suivies, tous marchés confondus.

reset n’est présent que si le quota se libère de lui-même avec le temps. Quand un quota est atteint, l’écriture échoue en 422 quota_exceeded et param nomme le quota.