Démarrer
Limites et quotas
Les limites portent sur votre compte, toutes clés confondues : créer une clé de plus ne donne pas plus de requêtes. Les réponses indiquent ce qu’il vous reste.
Les limites d’un compte
| Limite | Bêta, par défaut | Fonctionnement |
|---|---|---|
| Débit | 60 requêtes par minute | Compté sur une minute glissante. |
| Plafond par seconde | Aucun, sauf réglage du compte | Requêtes au plus sur toute seconde glissante, en plus du débit par minute. |
| Quota du jour | 10 000 requêtes par jour | Jour de Paris : le compteur repart de zéro à minuit, heure de Paris. |
| Requêtes simultanées | 4 au plus | Requêtes en cours au même instant, toutes clés du compte confondues. |
Le débit, le plafond par seconde et le quota sont réglés compte par compte : les vôtres peuvent différer. GET /v1/me les donne (limits, rate_per_second nul si votre compte n’a pas de plafond par seconde), avec la consommation du jour (usage).
Les en-têtes de chaque réponse
| En-tête | Sens |
|---|---|
RateLimit-Limit | Requêtes permises par minute. |
RateLimit-Remaining | Requêtes encore permises dans la minute. |
RateLimit-Reset | Secondes avant la minute suivante. |
X-Quota-Limit | Quota du jour. |
X-Quota-Remaining | Requêtes restantes aujourd’hui. |
Retry-After | Sur une réponse 429 ou 503 : secondes à attendre avant de réessayer. |
Les en-têtes RateLimit-* et X-Quota-* accompagnent les réponses aux requêtes qui ont passé l’authentification et le contrôle des droits. Lisez RateLimit-Remaining pour ralentir avant d’être refusé.
Quand une limite est atteinte : 429
| Code | Cause | Retry-After |
|---|---|---|
rate_limited | Débit de la minute atteint, ou plafond par seconde atteint. | Secondes avant la minute suivante ; 1 seconde pour le plafond par seconde. |
quota_exceeded | Quota du jour atteint. | Secondes jusqu’à minuit, heure de Paris. |
too_many_concurrent_requests | 4 requêtes déjà en cours pour le compte. | 1 seconde. |
too_many_auth_failures | Trop de clés invalides présentées depuis votre adresse IP. | Attente restante, jusqu’à 15 minutes. |
Une requête refusée par une limite ne consomme ni débit ni quota. Une requête admise compte, même si elle échoue ensuite (paramètre invalide, bien introuvable…).
Requête trop large : 503
Le temps de calcul d’une requête est borné. Au-delà, la réponse est 503 query_timeout, avec Retry-After: 5. Un nouvel essai peut aboutir ; si l’erreur se répète, réduisez le secteur ou ajoutez des filtres.
Bonnes pratiques
- Après un 429, attendez
Retry-Aftersecondes avant de réessayer, jamais moins ; ne relancez pas en boucle serrée. - Sur
quota_exceeded, arrêtez-vous : le quota repart à minuit, heure de Paris. - Gardez au plus 4 requêtes en parallèle, toutes vos clés et tous vos serveurs confondus.
- Si votre compte a un plafond par seconde, espacez vos appels en conséquence : à 1 requête par seconde, attendez la réponse puis une seconde avant la suivante.
- Demandez de grandes pages (
limitjusqu’à 100 annonces, 200 ventes ou 500 changements) : moins de requêtes pour les mêmes données. - Pour suivre un secteur, lisez le flux des changements plutôt que de tout relire. Voir Synchroniser un secteur.