EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Limites de taxa da API do Instagram: chamadas por 24 horas e throughput de DMs

A API do Instagram dá a cada app um orçamento de chamadas para cada conta que ele atende: 4.800 chamadas vezes as impressões da conta nas últimas 24 horas, em janela móvel. As mensagens têm taxas próprias por conta: 100 mensagens de texto por segundo pela Send API, 10 para áudio ou vídeo e 750 respostas privadas por hora. Quando o orçamento estoura, as chamadas falham com o erro 80002, e o cabeçalho X-Business-Use-Case-Usage mostra quanto já foi usado.

O easyCoexistence pode encaminhar ao seu endpoint os comentários, menções e DMs de cada conta do Instagram assim que chegam, para que um agente reaja a eventos em vez de fazer polling.

4,800

Chamadas por impressão que um app pode fazer para uma conta em 24 horas móveis, sem contar mensagens.

750/hour

Respostas privadas por conta a comentários em posts e Reels; comentários em uma Live permitem 100 por segundo.

100/sec

Chamadas da Send API por conta para texto, links, reações e figurinhas; áudio ou vídeo permite 10.

100 posts

Posts publicados via API por conta em um período móvel de 24 horas, verificados quando um container é publicado.

80002

O código de erro que um app recebe ao atingir o limite de taxa Business Use Case do Instagram.

Como o Instagram conta as chamadas de API?

Por par de app e conta, em uma janela móvel de 24 horas. Os endpoints do Instagram seguem os limites de taxa Business Use Case da Meta, e a contagem de chamadas de um app para uma conta profissional é limitada a 4.800 vezes as impressões dessa conta: o número de vezes que algum conteúdo dela apareceu na tela de alguém nas últimas 24 horas. As mensagens são contadas à parte, e Business Discovery e Hashtag Search seguem os limites de taxa de plataforma da Meta.

O uso de uma conta afeta o de outra?

Não, por essa fórmula. A Meta mantém a contagem para cada par de app e usuário do app, então um app que atende muitas contas profissionais tem um orçamento separado para cada uma, dimensionado pelas impressões da própria conta. Uma conta cujo conteúdo é visto com mais frequência recebe mais chamadas, e uma conta nova ou pouco ativa recebe menos.

Quais são os limites de mensagens?

São separados da contagem de 24 horas e definidos por conta profissional do Instagram e por API:

  • Send API: 100 chamadas por segundo para texto, links, reações e figurinhas, e 10 por segundo para áudio ou vídeo.
  • Respostas privadas: 750 chamadas por hora para comentários em posts e Reels, e 100 por segundo para comentários em uma Live.
  • Conversations API: 2 chamadas por segundo.

Onde entra o limite de publicação?

Ao lado do orçamento de chamadas, como uma contagem separada de posts. O guia de publicação da Meta permite 100 posts publicados via API por conta em um período móvel de 24 horas, verificado quando POST /<IG_ID>/media_publish é chamado, e uma chamada acima disso falha com código 9, subcódigo 2207042. O que cada post pode conter, a contagem de containers e o content_publishing_limit fazem parte dos limites de publicação.

Como a Meta informa o uso?

Em um cabeçalho de resposta. As chamadas sujeitas aos limites Business Use Case retornam X-Business-Use-Case-Usage, uma string JSON cuja chave é um ID. No Instagram, o tipo aparece como instagram; call_count, total_cputime e total_time são percentuais da cota já usada, e as chamadas podem ser limitadas quando o tempo de CPU ou o tempo total chega a 100. estimated_time_to_regain_access indica quantos minutos faltam para que um app limitado possa chamar de novo.

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
    }
  ]
}

O que acontece ao atingir o limite?

As chamadas falham até a contagem voltar a ficar abaixo dele. No limite Business Use Case do Instagram, o código de erro é 80002, e a Meta avisa que as chamadas feitas durante a limitação continuam somando à contagem, o que adia o momento em que elas voltam a funcionar. As mensagens são contadas fora desse orçamento, com suas próprias taxas por segundo e por hora.

Como ficar abaixo dos limites?

As recomendações da própria Meta, aplicadas ao Instagram:

  • Receba comentários, menções e mensagens por webhooks, em vez de fazer polling; a Meta os recomenda para reduzir as chamadas de que um app precisa.
  • Distribua as chamadas de forma uniforme, em vez de enviá-las em rajadas.
  • Peça apenas os campos de que você precisa e evite requisições de dados sobrepostos.
  • Conte uma a uma as chamadas de um lote: a Meta conta cada requisição dentro dele como uma chamada própria.
  • Pare ao ser limitado e retome depois de estimated_time_to_regain_access.

Erros comuns

  • Repetir em loop uma chamada limitada. A Meta conta as chamadas feitas durante a limitação, o que atrasa o momento em que elas voltam a funcionar.
  • Fazer polling de novos comentários ou DMs. Os webhooks entregam tudo conforme acontece e mantêm baixa a contagem de chamadas.
  • Ler estimated_time_to_regain_access como segundos. A Meta informa o valor em minutos, então um cliente que espera essa quantidade de segundos chama de novo ainda limitado.
  • Acompanhar só o call_count. total_cputime e total_time também contam para a limitação, então monitore os três percentuais do cabeçalho.
Fazendo isso com o EasyCoexistence

Quando a Meta limita uma chamada, o Claude, o ChatGPT ou o seu próprio código recebe de volta o código de erro e a mensagem da Meta. Ele também verifica cada conta conectada a cada 6 horas. De R$ 29,90 a R$ 3,90 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Quantas chamadas de API uma conta do Instagram pode fazer por dia?

4.800 por impressão que o conteúdo dela teve nas últimas 24 horas, contadas por app e conta, então uma conta vista com mais frequência recebe mais chamadas.

O que é o erro 80002 da API do Instagram?

É o limite de taxa Business Use Case do Instagram: o app esgotou o orçamento de chamadas para aquela conta. Pare de chamar e espere o tempo indicado no cabeçalho de uso.

As DMs contam na fórmula de 4.800?

Não. As mensagens ficam fora dela e têm taxas próprias por conta, como 100 mensagens de texto por segundo pela Send API.

As respostas privadas dividem a taxa das DMs?

Não. A Meta define taxas próprias para elas: 750 por hora por conta para comentários em posts e Reels, e 100 por segundo para comentários em uma Live, separadas das taxas da Send API para DMs.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em