Referencia
Rate limiting
Cada API Key puede hacer hasta 100 llamadas por minuto. Todas las respuestas traen headers para que su cliente sepa cuántas le quedan. Aplica igual en v1 y v2.
X-RateLimit-LimitTope por minuto.X-RateLimit-RemainingCuántas llamadas le quedan en este minuto.X-RateLimit-ResetUnix timestamp del próximo minuto, cuando el contador vuelve a 0.Retry-AfterSegundos a esperar (solo en 429).12:04:00
Empieza el minuto
El contador arranca en 0.
12:04:41
Llamada 100
Remaining llega a 0. Esta todavía responde normal.
12:04:42
Llamada 101 → 429
E_RATE_LIMITED con Retry-After: 18 (segundos que faltan para el reinicio).
12:05:00
Se reinicia
Minuto nuevo: vuelve a tener 100 llamadas.
El minuto es el del reloj: el contador vuelve a 0 en el segundo 0 de cada minuto, no 60 segundos después de su primera llamada. Las llamadas rechazadas con 429 también cuentan, así que reintentar sin esperar no sirve de nada.
Ante un 429, espere exactamente lo que diga Retry-After. Ante un error 5xx, reintente con backoff exponencial:
5xx→espera 1 s · intento 2→espera 2 s · intento 3→espera 4 s · intento 4→espera 8 s · intento 5