Referencia
Límites de la API (rate limits) y cuotas
Peticiones por minuto y por día por clave, cabeceras X-RateLimit y qué hacer ante un 429.
Límites por clave#
| Límite | Valor |
|---|---|
| Peticiones por clave y minuto | 60 |
| Peticiones por clave y día | 5000 |
Elementos por página (limite) | por defecto 50, máximo 200 |
Mediciones nuevas con POST /api/v1/airank/run | 3 al día |
Subidas de logs (POST /api/v1/crawl-logs) | 20 por hora; 5000 eventos por envío |
Prompts BGPi (POST /api/v1/bgpi/observe) | 20 por petición, 200 al día |
Cabeceras#
Cada respuesta lleva:
| Cabecera | Qué indica |
|---|---|
X-RateLimit-Limit | Tu límite por minuto |
X-RateLimit-Remaining | Las peticiones que te quedan en este minuto |
X-RateLimit-Reset | Segundos hasta que se renueva el minuto |
Si recibes un 429#
{ "error": "rate_limited", "mensaje": "…", "retryAfter": 30 }Espera los segundos de retryAfter (en el cuerpo de la respuesta) antes de reintentar, y reintenta con espera creciente.
Otras cuotas#
Las acciones con coste de IA tienen además topes diarios de la cuenta (por ejemplo, las mediciones forzadas). Un 429 con error: "quota" significa que has llegado a uno de ellos. Lee ¿Qué límites tiene cada plan y qué pasa al alcanzar uno?.
Actualizado el
¿Te ha resultado útil este artículo?
Gracias por tu respuesta.
Artículos relacionados
⌨️ APIErrores de la API y cómo resolverlosCada código de error, qué significa y qué hacer.💳 Planes y facturación¿Qué límites tiene cada plan y qué pasa al alcanzar uno?Topes diarios, límites de equipo y de la API, y los mensajes que verás al llegar a ellos.⌨️ APIRutas de escritura: lanzar una medición, enviar logs y aportar preguntasPOST airank/run, crawl-logs y bgpi/observe, con sus parámetros y límites.
¿No encontraste la respuesta?
Escríbenos y te respondemos. Si tienes cuenta, usa «Contáctanos» en el panel: nos llega con el contexto de tu cuenta.