Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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

A API do Instagram atribui a cada aplicação um orçamento de chamadas para cada conta que serve: 4,800 chamadas multiplicadas pelas impressões da conta nas últimas 24 horas, numa janela deslizante. As mensagens têm taxas próprias por conta: 100 mensagens de texto por segundo através da Send API, 10 para áudio ou vídeo, e 750 respostas privadas por hora. Ao ultrapassar o orçamento, as chamadas falham com o erro 80002, e o cabeçalho X-Business-Use-Case-Usage mostra quanto está a ser usado.

A easyCoexistence pode encaminhar os comentários, as menções e as DMs de cada conta do Instagram para o seu endpoint assim que chegam, para que um agente reaja a eventos em vez de os ir buscar por consulta repetida.

4,800

Chamadas por impressão que uma aplicação pode fazer para uma conta numa janela deslizante de 24 horas, excluindo mensagens.

750/hour

Respostas privadas por conta a comentários em publicações e Reels; os comentários numa transmissão em direto permitem 100 por segundo.

100/sec

Chamadas à Send API por conta para texto, ligações, reações e autocolantes; áudio ou vídeo permite 10.

100 posts

Publicações via API por conta num período deslizante de 24 horas, aplicado quando um contentor é publicado.

80002

O código de erro que uma aplicação recebe ao atingir o limite de taxa Business Use Case do Instagram.

Como é que o Instagram contabiliza as chamadas à API?

Por par de aplicação e conta, numa janela deslizante de 24 horas. Os endpoints do Instagram estão sujeitos aos limites de taxa Business Use Case da Meta, e o número de chamadas de uma aplicação para uma conta profissional está limitado a 4,800 vezes as impressões dessa conta: o número de vezes que qualquer dos seus conteúdos apareceu no ecrã de alguém nas últimas 24 horas. As mensagens são contabilizadas à parte, e a Business Discovery e a Hashtag Search seguem, em vez disso, os limites de taxa da Plataforma da Meta.

O uso de uma conta afeta o de outra?

Não, segundo esta fórmula. A Meta mantém a contagem para cada par de aplicação e utilizador da aplicação, pelo que uma aplicação que serve muitas contas profissionais tem um orçamento separado para cada uma, dimensionado pelas impressões próprias dessa conta. Uma conta cujos conteúdos são vistos com mais frequência recebe mais chamadas, e uma conta nova ou pouco ativa recebe menos.

Quais são os limites das mensagens?

Separados da contagem de 24 horas, e definidos por conta profissional do Instagram e por API:

  • Send API: 100 chamadas por segundo para texto, ligações, reações e autocolantes, e 10 por segundo para áudio ou vídeo.
  • Respostas privadas: 750 chamadas por hora para comentários em publicações e Reels, e 100 por segundo para comentários numa transmissão em direto.
  • Conversations API: 2 chamadas por segundo.

Onde encaixa o limite de publicação?

Ao lado do orçamento de chamadas, como uma contagem separada de publicações. O guia de publicação da Meta permite 100 publicações via API por conta, num período deslizante de 24 horas, verificado quando se chama POST /<IG_ID>/media_publish; uma chamada além desse limite falha com o código 9, subcódigo 2207042. O que uma publicação pode conter, o número de contentores e o content_publishing_limit pertencem aos limites de publicação.

Como é que a Meta comunica a utilização?

Num cabeçalho de resposta. As chamadas sujeitas aos limites Business Use Case devolvem X-Business-Use-Case-Usage, uma string JSON indexada por um ID. Para o Instagram, o tipo é instagram; call_count, total_cputime e total_time são percentagens da quota utilizada, e as chamadas podem ser limitadas assim que o tempo de CPU ou o tempo total atinja 100. estimated_time_to_regain_access indica os minutos até que uma aplicação limitada possa voltar a chamar a API.

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é que a contagem volte a descer abaixo dele. Para o limite Business Use Case do Instagram, o código de erro é 80002, e a Meta avisa que as chamadas feitas enquanto há limitação continuam a somar à contagem, o que adia o momento em que as chamadas voltam a ter êxito. As mensagens são contabilizadas à parte deste orçamento, com as suas próprias taxas por segundo e por hora.

Como manter-se abaixo dos limites?

Os conselhos da própria Meta, aplicados ao Instagram:

  • Receber comentários, menções e mensagens através de webhooks em vez de os consultar repetidamente; a Meta recomenda-os para reduzir as chamadas de que uma aplicação precisa.
  • Distribuir as chamadas uniformemente, em vez de as enviar em rajadas.
  • Pedir apenas os campos de que precisa, e evitar pedidos de dados que se sobrepõem.
  • Contar as chamadas de um lote uma a uma: a Meta conta cada pedido dentro dele como uma chamada própria.
  • Parar quando houver limitação, e retomar após estimated_time_to_regain_access.

Erros comuns

  • Repetir uma chamada limitada em ciclo. A Meta conta as chamadas feitas durante a limitação, o que atrasa o momento em que as chamadas voltam a ter êxito.
  • Consultar repetidamente novos comentários ou DMs. Os webhooks entregam-nos à medida que acontecem e mantêm baixa a contagem de chamadas.
  • Ler estimated_time_to_regain_access em segundos. A Meta indica-o em minutos, por isso um cliente que espere esse número de segundos volta a chamar a API ainda limitado.
  • Observar apenas call_count. total_cputime e total_time também contam para a limitação, pelo que é preciso acompanhar as três percentagens no cabeçalho.
Fazer isto com a 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. Também verifica cada conta ligada de 6 em 6 horas. De US$ 9 a US$ 0.75 por ligação por mês, com preço decrescente à medida que acrescenta ligações, e os primeiros 3 dias gratuitos.

Perguntas frequentes

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

4,800 por impressão que os seus conteúdos tiveram nas últimas 24 horas, contadas por aplicação e conta, pelo que 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: a aplicação esgotou o orçamento de chamadas para essa conta. Pare de chamar a API e aguarde o tempo indicado pelo cabeçalho de utilização.

As DMs contam para a fórmula dos 4,800?

Não. As mensagens ficam excluídas da fórmula e têm taxas próprias por conta, como 100 mensagens de texto por segundo através da Send API.

As respostas privadas partilham a taxa das DMs?

Não. A Meta atribui-lhes taxas próprias: 750 por hora por conta para comentários em publicações e Reels, e 100 por segundo para comentários numa transmissão em direto, separadas das taxas da Send API para DMs.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

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

Verificado em