Rate limits y cuotas
Cotizave aplica rate limiting por API Key con cuotas mensuales que dependen de tu Plan.
Cuotas por Plan
| Plan | Requests / mes | RPS (sostenido) | Burst | Keys simultáneas | Precio |
|---|---|---|---|---|---|
| Free | 1.500 | 2 | 5 | 1 clave | $0 |
| Hobby | 3.000 | 3 | 8 | 1 clave | $3 / mes |
| Starter | 10.000 | 5 | 15 | Hasta 2 claves | $7 / mes |
| Indie | 50.000 | 15 | 30 | Hasta 5 claves | $15 / mes |
| Pro | 300.000 | 30 | 100 | Ilimitadas | $59 / mes |
| Business | 0 | 0 | 0 | Ilimitadas | $0 |
| Business | A medida | A medida | A medida | Negociado | Contactar |
Los contadores mensuales se resetean el día 1 de cada mes a las 00:00 UTC. El plan Free también tiene límite mensual de 1.500 requests.
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: requests exitosos (200 OK) · requests a endpoints autenticados.
No cuentan: fallos por autenticación (401, 403) · fallos por rate limit (429) · requests malformados (400, 422) · fallos del lado de Cotizave (5xx).
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:
| Header | Descripción |
|---|---|
| X-RateLimit-Limit | Cuota total mensual de tu Plan |
| X-RateLimit-Remaining | Requests disponibles en el mes actual |
| X-RateLimit-Reset | Fecha ISO 8601 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: 2026-06-01T00:00:00Z
Esto significa:
- Tu Plan Indie te permite 50.000 requests por mes
- Te quedan 48.273 requests este mes
- El contador se resetea el 1 de junio de 2026 a las 00:00 UTC
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: 2026-06-01T00:00:00Z Retry-After: 2592000 { "code": "rate_limit_exceeded", "message": "Rate limit exceeded." }
El header Retry-After indica en segundos cuánto falta para el reset.
Tus opciones
- Hacer upgrade del Plan desde el dashboard. El cambio es inmediato y el nuevo contador se aplica al instante.
- Esperar al próximo ciclo. El contador se resetea automáticamente el día 1 del próximo mes.
¿Necesitas más?
Si necesitas más cuota que la del plan más alto disponible, Business escala a medida de tu volumen — contáctanos en support@cotizave.com.
- Cuotas a medida
- SLA y soporte a conversar