Límites de tasa

Todas las solicitudes a la API están sujetas a límites de tasa según tu plan.

Límites del plan gratuito

Límite	Valor
Solicitudes mensuales	10.000
Solicitudes diarias	1.000
Solicitudes por minuto (RPM)	60
API tokens	5

Headers de límite de tasa

Cada respuesta de la API incluye headers de límite de tasa:

Header	Descripción
X-RateLimit-Limit	Máximo de solicitudes por minuto
X-RateLimit-Remaining	Solicitudes restantes en la ventana actual
X-RateLimit-Reset	Marca de tiempo Unix cuando la ventana se reinicia

Manejo de errores 429

Cuando excedes el límite de tasa, la API devuelve 429 Too Many Requests:

{
  "error": "Rate limit exceeded",
  "retryAfter": 42
}

Buenas prácticas:

• Implementa backoff exponencial ante respuestas 429
• Usa el header X-RateLimit-Remaining para limitar proactivamente las solicitudes
• Almacena en caché las respuestas cuando sea posible para reducir las llamadas a la API

Headers de cuota

Cada respuesta de la API incluye headers de cuota:

Header	Descripción
X-Quota-Limit	Cuota mensual de solicitudes
X-Quota-Remaining	Solicitudes mensuales restantes
X-Quota-Daily-Limit	Cuota diaria de solicitudes
X-Quota-Daily-Remaining	Solicitudes diarias restantes

Cuota mensual

Cuando tu cuota mensual se agota, las solicitudes devuelven 429 con un mensaje indicando la fecha de reinicio de la cuota (primer día del mes siguiente).

Cuota diaria

Cuando tu cuota diaria se agota, las solicitudes devuelven 429 hasta el siguiente día UTC.

Planes de pago

Planes de pago con límites superiores estarán disponibles próximamente.