Limites de débit
Chaque offre a un plafond par minute et un plafond par heure ou par jour. Chaque réponse dit où vous en êtes, avant que la limite ne tombe.
Mis à jour le 10 novembre 2026
Quotas par offre
| Offre | Limites | Compté par | Prix |
|---|---|---|---|
Sans clé anonyme | 10 par minute ; 60 par heure | adresse IP | 0 € |
Gratuit gratuit | 60 par minute ; 5 000 par jour | clé | 0 € |
Pro pro | 300 par minute ; 100 000 par jour | clé | 29 € HT / mois |
Entreprise entreprise | 1 200 par minute ; 1 000 000 par jour | clé | 99 € HT / mois |
Les fenêtres sont fixes : une minute pleine de l'horloge, une heure pleine, un jour du calendrier en temps universel (de 1 h à 1 h du matin à Paris en hiver, de 2 h à 2 h en été). Une requête refusée ne compte pas : réessayer après un 429 ne repousse pas la remise à zéro. Toutes les requêtes comptent de la même façon, quel que soit le point d'accès ou la taille de la réponse.
Les en-têtes de chaque réponse
L'API suit le projet de norme de l'IETF sur les en-têtes de limite de débit. Ils décrivent la fenêtre la plus proche de la limite : le plafond par minute en cas de rafale, le plafond par heure ou par jour sinon.
RateLimit-Limit: 60
RateLimit-Remaining: 57
RateLimit-Reset: 2280
RateLimit-Policy: 10;w=60, 60;w=3600RateLimit-Limit: le plafond de la fenêtre décrite ;RateLimit-Remaining: les requêtes qui restent dans cette fenêtre ;RateLimit-Reset: le nombre de secondes avant sa remise à zéro (une durée, pas une date) ;RateLimit-Policy: toutes les fenêtres de l'offre, sous la formeplafond;w=durée en secondes.
Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset des premières versions restent envoyés ; le dernier y est une date Unix, comme à l'origine.
Quand la limite est atteinte
L'API répond 429 rate_limited avec un en-tête Retry-After en secondes. Attendez au moins ce délai avant de réessayer ; un client qui insiste n'obtient rien de plus, et ses requêtes refusées ne sont pas comptées.
async function get(url, key) {
for (let attempt = 0; attempt < 3; attempt++) {
const res = await fetch(url, { headers: { Authorization: `Bearer ${key}` } });
if (res.status !== 429) return res;
const wait = Number(res.headers.get("retry-after") ?? 60);
await new Promise((r) => setTimeout(r, wait * 1000));
}
throw new Error("Limite atteinte trois fois de suite");
}Rester sous les limites
- Mettez les réponses en cache au moins cinq minutes : c'est la durée de
Cache-Control, et la plupart des données ne changent qu'une fois par heure (publications), toutes les six heures (abonnés) ou par jour (Wikipédia)./api/v1/etatdit quand la collecte a écrit pour la dernière fois. - Filtrez côté serveur :
candidat,reseau,depuisetjusquaréduisent la réponse sans coûter de requête en plus. - Pour un historique complet, une requête CSV vaut mieux que cent requêtes JSON.
- Pour un besoin ponctuel au-delà des quotas (une étude, un traitement unique), écrivez à contact@isoloir2027.fr avant de lancer le traitement.