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 RequestsRetry-After: 12Content-Type: application/json
{ "data": null, "status": 429, "error": { "code": "RATE_LIMITED", "message": "Límite de peticiones excedido para la API key" } }Cómo reaccionar
Sección titulada «Cómo reaccionar»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))}Ahorrar solicitudes
Sección titulada «Ahorrar solicitudes»- Páginas grandes: hasta 1.000 filas en las tablas de analítica.
GET /analytics/freshnessantes de refrescar: si nada cambió, no leas más.If-None-Matchcon elETaganterior: si nada cambió,304sin cuerpo.