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 | 150.000 | 30 | 100 | Ilimitadas | $39 / mes |
| A medida | A medida | A medida | A medida | Negociado | Contactar |
Los contadores mensuales se reinician al comienzo del ciclo de tu Plan, anclado a la fecha de activación (en el plan Free, a la fecha de creación de la cuenta) — es decir, en ese día del mes, no necesariamente el día 1 del calendario.
Cómo se cuenta cada request
Un "request" descuenta cuota cuando recibe un código 2xx o un error de cliente 400/404 (input inválido o ruta/market inexistente — responsabilidad del caller). Específicamente:
Sí cuentan: requests exitosos (2xx) · errores de cliente por input o ruta inválida (400, 404).
No cuentan (casos en los que no se entregó servicio): fallos por autenticación (401, 403) · falta de pago (402) · rate limit (429) · fallos del lado de Cotizave (5xx).
En la práctica: no pagas por requests sin servicio (auth, pago, rate limit o errores nuestros); sí cuentan los 400/404 originados por input o rutas inválidas.
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 del próximo reinicio del ciclo (el día de activación de tu Plan, no necesariamente el día 1) |
Ejemplo:
Esto significa:
- Tu Plan Indie te permite 50.000 requests por mes
- Te quedan 48.273 requests este mes
- El contador se reinicia el 23 de junio de 2026 a las 00:00 UTC (día de activación de tu Plan)
Qué pasa cuando excedes tu cuota
Cuando haces un request pero ya agotaste tu cuota mensual:
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 reinicia automáticamente en la fecha indicada por
X-RateLimit-Reset(el día de activación de tu Plan).
Abuso y suspensión
Los rate limits no son solo un límite de facturación: protegen el servicio para todos. Recibir un 429 de forma puntual es normal y esperado — basta con respetar el header Retry-After y reintentar con backoff.
Lo que no es normal es insistir contra el límite. Si detectamos patrones anómalos —volúmenes de 429 sostenidos, reintentos agresivos sin backoff, intentos de evadir la cuota (rotación de keys o cuentas, scraping distribuido) u otro uso abusivo— podemos aplicar medidas escalonadas:
Medidas que podemos tomar ante abuso: throttling adicional · límites por IP · bloqueo temporal · y, de persistir, suspensión de la API Key o de la cuenta, sin reembolso.
En resumen: un 429 ocasional no pasa nada; ignorarlo de forma sistemática sí puede terminar en suspensión. Esto está cubierto en los Términos (§7).
¿Necesitas más?
Si necesitas más cuota que la del plan más alto disponible, la escalamos a medida de tu volumen — contáctanos en support@cotizave.com.
- Cuotas a medida
- SLA y soporte a conversar