Rate limits

Aplicamos límites por minuto, día y mes según el plan contratado. Los contadores se calculan por API key activa.

Límites por plan

Plan	Req / min	Req / día	Req / mes
Demo	30	500	100
Starter	60	5,000	1,000
Pro	300	50,000	10,000
Business	1,000	200,000	50,000
Enterprise	Custom	Custom	Custom

Nota: los volúmenes mensuales se expresan en miles. Demo tiene tope total de 100 consultas mensuales por IP.

Headers de respuesta

Cada respuesta incluye headers para monitorear tu uso en tiempo real:

X-RateLimit-Limit: cuota total disponible en la ventana actual.
X-RateLimit-Remaining: solicitudes restantes antes de bloquearse.
X-RateLimit-Reset: timestamp Unix en el que se reinicia el contador.

Comportamiento al exceder

Cuando superas el límite, la API responde con HTTP 429 Too Many Requests e incluye un header Retry-After con los segundos a esperar antes de reintentar.

HTTP/1.1 429 Too Many Requests
Retry-After: 47
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0

{
  "ok": false,
  "error": "Rate limit excedido. Reintenta en 47 segundos.",
  "status": 429
}

Cómo ampliar tu cuota

Revisa los planes disponibles en /pricing y actualiza desde el panel. El nuevo límite aplica de inmediato.