Límites de frecuencia y presupuestos

Solicitudes por minuto, el presupuesto diario de empresas, los límites de página y los bloqueos temporales. Las cifras de esta página son las vigentes.

Las cifras siguientes se leen de la configuración en vivo al cargar esta página.

Por plan

Plan	Revelaciones al mes	Solicitudes por minuto, por clave	Empresas al día, por cuenta	Última página
Scale	10.000	60	200.000	200
Enterprise	100.000	60	500.000	200

Solicitudes por minuto

Cada clave tiene su límite por minuto, y cuentan todas las solicitudes REST y MCP. Cada respuesta te indica cómo vas:

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

Si superas el límite, recibes 429 rate_limited con una cabecera Retry-After en segundos. Las revelaciones tienen además ese mismo límite por minuto, por cuenta.

Presupuesto diario de empresas

Tu cuenta puede ver un número de empresas distintas cada día, sea cual sea la clave o el cliente que las pida. Ver la misma empresa dos veces cuenta una sola vez, y las empresas que ya revelaste no cuentan. Si superas el presupuesto, las empresas ya vistas hoy siguen pasando y las nuevas reciben 429 budget_exhausted. Los recuentos y las consultas de valores no gastan presupuesto. GET /quota te indica cuánto has usado; esa cifra es una estimación aproximada.

Otros límites

Límite	Valor
Solicitudes por minuto, una clave	60
Solicitudes por minuto, toda la cuenta	600
Solicitudes al día, toda la cuenta	100.000
Solicitudes por minuto sin clave válida, por dirección	30
Solicitudes al día sin clave válida, por dirección	500
Máximo de filas en una página	50
Ids consecutivos que cuentan como recorrer la base de datos	10
Duración de un bloqueo temporal, en horas	24
Rechazos por límite de frecuencia en un día antes de un bloqueo	200
Intentos por encima del presupuesto antes de un bloqueo, en presupuestos	4

Bloqueos temporales

Algunos patrones ponen en pausa el acceso a los datos de empresas durante 24 horas con 429 blocked: leer 10 ids de empresa consecutivos, 200 rechazos por límite de frecuencia en un día, o intentos por encima del presupuesto que lleguen a 4 presupuestos. Tu cuenta y tu página de claves siguen funcionando. Si crees que es un error, escríbenos.

Buenas prácticas

Espera lo que indica Retry-After en un 429 en lugar de reintentar enseguida: los rechazos repetidos llevan a un bloqueo.
Usa /businesses/count para medir el tamaño de una búsqueda antes de paginarla.
Acota tus filtros en lugar de leer listas largas.

Volver a findbytown