Ir al contenido

Límites de uso

Límite de solicitudes por clave y cómo reaccionar ante un 429.

Cada clave admite 60 solicitudes por minuto. Al superarlo, la API responde 429 con Retry-After: los segundos que debes esperar.

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json
{ "data": null, "status": 429, "error": { "code": "RATE_LIMITED", "message": "Límite de peticiones excedido para la API key" } }

Espera Retry-After segundos y repite la solicitud. Si se repite, reparte las llamadas o usa una clave por integración.

const res = await fetch(url, { headers: { 'X-API-Key': key } })
if (res.status === 429) {
const wait = Number(res.headers.get('Retry-After') ?? 1)
await new Promise((resolve) => setTimeout(resolve, wait * 1000))
}
  • Páginas grandes: hasta 1.000 filas en las tablas de analítica.
  • GET /analytics/freshness antes de refrescar: si nada cambió, no leas más.
  • If-None-Match con el ETag anterior: si nada cambió, 304 sin cuerpo.