Skip to main content
Cada clave tiene su propio límite: 100 pedidos de lectura por minuto. Una lectura es todo pedido GET, con o sin expand[]. Las claves de prueba tienen el mismo límite que las de producción. El uso de la API no se cobra por pedido.

Los headers

Cada respuesta a un pedido aceptado dice cómo vas. Las respuestas de error de autenticación, permisos o ruta no traen estos headers:
  • RateLimit-Policy: el límite (q, pedidos) por ventana (w, segundos).
  • RateLimit: cuántos pedidos te quedan en esta ventana (r) y en cuántos segundos se renueva (t).

Cuando te pasas

La respuesta es 429 con el código rate_limited y el header Retry-After, con los segundos que tienes que esperar:
Espera esos segundos antes de reintentar. Si te pasa seguido:
  • Pide páginas grandes (limit=100) en vez de muchas chicas.
  • Usa expand[] para traer objetos relacionados en el mismo pedido, en vez de pedirlos uno por uno.
  • Reparte las sincronizaciones grandes en el tiempo, y no las corras todas a la misma hora.