Un límite de peticiones (en inglés, rate limit) acota cuántas llamadas puede enviar un cliente a una API en una ventana de tiempo, por ejemplo 200 llamadas por hora. Si envías más, la API rechaza las peticiones extra, normalmente con el estado HTTP 429, "demasiadas peticiones", hasta que la ventana se reinicia.
// 01
Por qué las APIs imponen límites
Los límites protegen el servicio de sobrecargas y evitan que un usuario intensivo degrade el servicio de los demás. Las redes sociales son especialmente estrictas: los endpoints de publicación suelen tener cuotas por cuenta además de los límites generales, porque la publicación masiva automatizada es exactamente lo que parece spam.
// 02
Cómo gestionar un límite alcanzado
Un 429 no es un error grave; es una instrucción de ir más despacio. Un buen cliente espera y reintenta con pausas crecientes (backoff) y lee las cabeceras de la respuesta que indican cuándo se reinicia la ventana. Si construyes sobre una API de publicación, consulta tu cuota antes de necesitarla: InvisibleAPI expone los límites de uso en vivo a través de la API, con una cuota de 100 posts publicados por cuenta conectada por periodo de facturación.
// 03
¿Qué significa estar "rate limited"?
Significa que la API ha dejado de aceptar tus peticiones por ahora, porque enviaste demasiadas dentro de su ventana de tiempo. No hay nada roto ni ningún bloqueo permanente: las peticiones vuelven a funcionar cuando la ventana se reinicia. El mismo mensaje aparece en apps y webs cuando repites una acción demasiado rápido.
// 04
Cómo resolver "rate limit exceeded"
Deja de enviar, espera y reintenta con una espera creciente. Lee las cabeceras que devuelve la API sobre el uso o el reinicio en lugar de adivinar, y reparte los trabajos por lotes en lugar de enviarlos todos a la vez. Si llegas al límite cada día, la solución es hacer menos llamadas: guarda en caché lo que lees y consulta tu cuota restante antes de un lote grande.
// 05
Instagram como ejemplo
Instagram aplica dos tipos de límite a la vez. El límite de Meta para Instagram Platform es de 4.800 llamadas por impresión en una ventana de 24 horas, y la publicación tiene su propio tope de 100 publicaciones hechas por API por cuenta en 24 horas. Cada límite devuelve un código de error distinto, y la guía de códigos de error de la API de Instagram los traduce en una decisión de reintento. La API de publicación en Instagram añade un tercer recuento, independiente: su endpoint de límites indica el margen restante de InvisibleAPI de cada cuenta en el periodo de facturación. No sigue el tope móvil de 24 horas de Meta, así que un lote tiene que respetar ambos.
Pasa de la definición a la documentación que muestra cómo aplicarlo.
Solución principal Reglas y límites de las cuentas