← Volver a docs

Rate limits y cuotas

Cotizave aplica rate limiting por API Key con cuotas mensuales que dependen de tu Plan.


Cuotas por Plan

PlanRequests / mesKeys simultáneasPrecio
Free1.0001$0
Indie50.0005$9 / mes
Pro500.000Ilimitadas$29 / mes
EnterpriseA medidaIlimitadasContactar

Los contadores se resetean el día 1 de cada mes a las 00:00 UTC.

Cómo se cuenta cada request

Un “request” es cualquier llamada autenticada a la API que reciba código de respuesta 2xx. Específicamente:

Sí cuentan:

No cuentan:

En la práctica, esto significa que solo pagas por los requests que realmente recibiste con datos válidos.

Headers de rate limiting

Cada respuesta de la API incluye estos headers para que monitorees tu uso en tiempo real:

HeaderDescripción
X-RateLimit-LimitCuota total mensual de tu Plan
X-RateLimit-RemainingRequests disponibles en el mes actual
X-RateLimit-ResetTimestamp Unix cuando se resetea el contador (siempre el día 1 del próximo mes)

Ejemplo:

HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 50000
X-RateLimit-Remaining: 48273
X-RateLimit-Reset: 1714521600

Esto significa:

Qué pasa cuando excedes tu cuota

Cuando haces un request pero ya agotaste tu cuota mensual:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
X-RateLimit-Limit: 50000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1714521600
Retry-After: 1728000

{
  "code": "rate_limit_exceeded",
  "message": "Monthly quota exceeded. Your plan allows 50000 requests per month. Upgrade your plan or wait until reset."
}

El header Retry-After indica en segundos cuánto falta para el reset.

Tus opciones:

  1. Hacer upgrade del Plan desde el dashboard. El cambio es inmediato y el nuevo contador se aplica al instante.
  2. Esperar al próximo ciclo. El contador se resetea automáticamente el día 1 del próximo mes.
  3. Hacer upgrade del Plan para aumentar tu cuota mensual.

Plan Enterprise

Si tu caso de uso excede los 500.000 requests/mes del Plan Pro, o si necesitas features especiales (SLA personalizado, integración dedicada, volumen mayor, soporte prioritario, white-label), contáctanos en hello@cotizave.com.

El Plan Enterprise se cotiza a medida y puede incluir: