Limites de requêtes et budgets

Requêtes par minute, budget quotidien d’entreprises, limites de page et blocages temporaires. Les chiffres de cette page sont ceux en vigueur.

Les chiffres ci-dessous sont lus dans les réglages actifs au chargement de cette page.

Par offre

Offre	Révélations par mois	Requêtes par minute, par clé	Entreprises par jour, par compte	Dernière page
Scale	10 000	60	200 000	200
Enterprise	100 000	60	500 000	200

Requêtes par minute

Chaque clé a sa limite par minute, et chaque requête REST et MCP compte. Chaque réponse vous indique où vous en êtes :

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1893456000
X-Request-Id: 00000000-0000-4000-8000-000000000000

Au-delà de la limite, vous obtenez 429 rate_limited avec un en-tête Retry-After en secondes. Les révélations ont en plus cette même limite par minute, par compte.

Budget quotidien d’entreprises

Votre compte peut voir un certain nombre d’entreprises distinctes chaque jour, quels que soient la clé ou le client qui demande. Voir deux fois la même entreprise compte une seule fois, et les entreprises déjà révélées ne comptent pas. Au-delà du budget, les entreprises déjà vues aujourd’hui passent toujours et les nouvelles reçoivent 429 budget_exhausted. Les comptages et les listes de référence ne consomment aucun budget. GET /quota vous indique votre consommation ; ce chiffre est une estimation proche.

Autres limites

Limite	Valeur
Requêtes par minute, une clé	60
Requêtes par minute, tout le compte	600
Requêtes par jour, tout le compte	100 000
Requêtes par minute sans clé valide, par adresse	30
Requêtes par jour sans clé valide, par adresse	500
Nombre maximal de lignes sur une page	50
Identifiants consécutifs considérés comme un parcours de la base	10
Durée d’un blocage temporaire, en heures	24
Refus pour limite de requêtes en une journée avant un blocage	200
Tentatives au-delà du budget avant un blocage, en nombre de budgets	4

Blocages temporaires

Certains comportements suspendent l’accès aux données d’entreprises pendant 24 heures avec 429 blocked : la lecture de 10 identifiants d’entreprises consécutifs, 200 refus pour limite de requêtes en une journée, ou des tentatives au-delà du budget atteignant 4 budgets. Votre compte et votre page de clés restent accessibles. Si vous pensez qu’il s’agit d’une erreur, écrivez-nous.

Bonnes pratiques

Attendez Retry-After après un 429 au lieu de réessayer aussitôt : des refus répétés mènent à un blocage.
Utilisez /businesses/count pour évaluer la taille d’une recherche avant de la parcourir page par page.
Affinez vos filtres plutôt que de lire de longues listes.

Retour à findbytown