Límites de uso

La API aplica rate limiting por API key para garantizar la estabilidad del servicio.

Límites por defecto

Cada API key tiene un límite de 60 requests por minuto. Este valor es configurable por key desde el dashboard.

Headers de respuesta

Cada respuesta incluye headers con información del rate limit:

HeaderDescripción
X-RateLimit-LimitLímite máximo de requests por minuto
X-RateLimit-RemainingRequests restantes en la ventana actual
X-RateLimit-ResetTimestamp (Unix) cuando se resetea el contador

Respuesta 429

Cuando excedés el límite, recibís un HTTP 429:

Respuesta 429
{
"success": false,
"error_code": "RATE_LIMITED",
"error_message": "Demasiados requests. Intentá de nuevo en unos segundos."
}

Qué hacer

  • Esperá: revisá el header X-RateLimit-Reset para saber cuándo podés reintentar.
  • Optimizá: evitá consultas duplicadas. Guardá los resultados que ya obtuviste.
  • Escalá: si necesitás un límite mayor, contactanos.
Si necesitás un límite mayor para tu caso de uso, contactanos y lo ajustamos para tu API key.