Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Límites de tasa de la API de Instagram: llamadas por 24 horas y throughput de DM

La API de Instagram asigna a cada app un presupuesto de llamadas por cada cuenta que atiende: 4,800 llamadas multiplicadas por las impresiones de la cuenta en las últimas 24 horas móviles. La mensajería tiene límites de tasa propios por cuenta: 100 mensajes de texto por segundo a través de la Send API, 10 para audio o video, y 750 respuestas privadas por hora. Al superar el presupuesto, las llamadas fallan con el error 80002, y el encabezado X-Business-Use-Case-Usage muestra cuánto se ha usado.

easyCoexistence puede reenviar a tu endpoint los comentarios, menciones y DM de cada cuenta de Instagram en cuanto llegan, para que un agente reaccione a los eventos en lugar de consultarlos periódicamente, y cuando Meta limita una llamada, Claude, ChatGPT o tu propio código recibe de vuelta el código de error y el mensaje de Meta.

4,800

Llamadas por impresión que una app puede hacer para una cuenta en 24 horas móviles, sin contar la mensajería.

750/hour

Respuestas privadas por cuenta a comentarios en publicaciones y Reels; los comentarios en un Live permiten 100 por segundo.

100/sec

Llamadas a la Send API por cuenta para texto, enlaces, reacciones y stickers; audio o video permite 10.

100 posts

Publicaciones hechas por API por cuenta en un periodo móvil de 24 horas, límite que se aplica al publicar un contenedor.

80002

El código de error que recibe una app al alcanzar el límite de tasa Business Use Case de Instagram.

¿Cómo cuenta Instagram las llamadas a la API?

Por par de app y cuenta, en un periodo móvil de 24 horas. Los endpoints de Instagram están sujetos a los límites de tasa Business Use Case de Meta, y el número de llamadas de una app para una cuenta profesional tiene como tope 4,800 veces las impresiones de esa cuenta: el número de veces que alguno de sus contenidos apareció en la pantalla de alguien en las últimas 24 horas. La mensajería se cuenta por separado, y Business Discovery y Hashtag Search siguen en cambio los límites de tasa de la Plataforma de Meta.

¿El uso de una cuenta afecta a otra?

No con esta fórmula. Meta lleva el conteo para cada par de app y usuario de app, así que una app que atiende muchas cuentas profesionales tiene un presupuesto separado para cada una, calculado según las impresiones de esa cuenta. Una cuenta cuyo contenido se ve con más frecuencia recibe más llamadas, y una cuenta nueva o poco activa recibe menos.

¿Cuáles son los límites de mensajería?

Separados del conteo de 24 horas, y definidos por cuenta profesional de Instagram y por API:

  • Send API: 100 llamadas por segundo para texto, enlaces, reacciones y stickers, y 10 por segundo para audio o video.
  • Respuestas privadas: 750 llamadas por hora para comentarios en publicaciones y Reels, y 100 por segundo para comentarios en un Live.
  • Conversations API: 2 llamadas por segundo.

¿Dónde encaja el límite de publicación?

Junto al presupuesto de llamadas, como un conteo aparte de publicaciones. La guía de publicación de Meta permite 100 publicaciones por API por cuenta en un periodo móvil de 24 horas, verificadas al llamar a POST /<IG_ID>/media_publish, y una llamada que lo supere falla con el código 9, subcódigo 2207042. Lo que puede contener una publicación, el conteo de contenedores y content_publishing_limit pertenecen a los límites de publicación.

¿Cómo informa Meta el uso?

En un encabezado de respuesta. Las llamadas sujetas a los límites Business Use Case devuelven X-Business-Use-Case-Usage, una cadena JSON indexada por un ID. Para Instagram, su type es instagram; call_count, total_cputime y total_time son porcentajes de la cuota usada, y las llamadas pueden limitarse cuando el tiempo de CPU o el tiempo total llega a 100. estimated_time_to_regain_access indica los minutos que faltan para que una app limitada pueda volver a llamar.

The usage header on an Instagram call
x-business-use-case-usage: {
  "<ID>": [
    {
      "type": "instagram",
      "call_count": 28,
      "total_cputime": 12,
      "total_time": 15,
      "estimated_time_to_regain_access": 0
    }
  ]
}

¿Qué pasa al llegar al límite?

Las llamadas fallan hasta que el conteo vuelva a bajar del límite. Para el límite Business Use Case de Instagram el código de error es 80002, y Meta advierte que las llamadas hechas mientras se está limitado siguen sumando al conteo, lo que retrasa el momento en que las llamadas vuelven a funcionar. La mensajería se cuenta aparte de este presupuesto, con sus propios límites por segundo y por hora.

¿Cómo se mantiene uno por debajo de los límites?

Los consejos propios de Meta, aplicados a Instagram:

  • Recibir comentarios, menciones y mensajes mediante webhooks en lugar de consultarlos periódicamente; Meta los recomienda para reducir las llamadas que necesita una app.
  • Repartir las llamadas de manera uniforme en lugar de enviarlas en ráfagas.
  • Pedir solo los campos que necesitas, y evitar peticiones de datos que se solapen.
  • Contar las llamadas de un lote una por una: Meta cuenta cada petición dentro de él como una llamada propia.
  • Detenerse al ser limitado, y reanudar después de estimated_time_to_regain_access.

Errores comunes

  • Reintentar en bucle una llamada limitada. Meta cuenta las llamadas hechas mientras se está limitado, lo que retrasa el momento en que las llamadas vuelven a funcionar.
  • Consultar periódicamente si hay comentarios o DM nuevos. Los webhooks los entregan en cuanto ocurren y mantienen bajo el conteo de llamadas.
  • Leer estimated_time_to_regain_access como segundos. Meta lo da en minutos, así que un cliente que espera esa cantidad de segundos vuelve a llamar aún limitado.
  • Mirar solo call_count. total_cputime y total_time también cuentan para el límite, así que sigue los tres porcentajes del encabezado.
Hacerlo con EasyCoexistence

También revisa cada cuenta conectada cada 6 horas. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que sumas conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Cuántas llamadas a la API puede hacer una cuenta de Instagram al día?

4,800 por impresión que sus contenidos tuvieron en las últimas 24 horas, contadas por app y cuenta, así que una cuenta que se ve con más frecuencia recibe más llamadas.

¿Qué es el error 80002 de la API de Instagram?

El límite de tasa Business Use Case de Instagram: la app agotó su presupuesto de llamadas para esa cuenta. Deja de llamar y espera el tiempo que indica el encabezado de uso.

¿Los DM cuentan para la fórmula de 4,800?

No. La mensajería queda excluida y tiene sus propios límites por cuenta, como 100 mensajes de texto por segundo a través de la Send API.

¿Las respuestas privadas comparten el límite de DM?

No. Meta les asigna límites propios: 750 por hora por cuenta para comentarios en publicaciones y Reels, y 100 por segundo para comentarios en un Live, aparte de los límites de la Send API para DM.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el