EntrarComeçar teste grátis
easyCoexistence APIs oficiais

API de publicação do Instagram: formatos, tamanhos e posts por dia

O limite de publicação da API do Instagram é de 100 posts por conta profissional em 24 horas móveis, contando cada carrossel como um. Cada post aceita uma imagem JPEG de até 8 MB, um carrossel de até 20 itens, um Reel de 3 segundos a 15 minutos ou um Story com até 60 segundos de vídeo, buscados pela Meta em uma URL pública, e as legendas chegam a 2,200 caracteres.

O easyCoexistence publica fotos, carrosséis de 2 a 10 itens, Reels e Stories com publish_instagram_post, a partir do Claude, do ChatGPT ou do seu próprio código, finaliza sozinho um vídeo que ainda está em processamento e agenda posts pela própria fila.

100

Posts publicados pela API por conta em 24 horas móveis; um carrossel conta como um único post.

8 MB

Maior imagem JPEG que a API aceita, com proporção entre 4:5 e 1.91:1.

400

Containers de mídia que uma conta pode criar em 24 horas móveis.

24 hours

Tempo que um container de mídia pode aguardar sem ser publicado antes de expirar.

2,200

Caracteres permitidos em uma legenda, com no máximo 20 tags @, segundo a referência de mídia da Meta.

5 hashtags

O maior número de hashtags que a Central de Ajuda do Instagram permite em um post.

Quais formatos podem ser publicados pela API?

Quatro formatos, e cada um passa pelas mesmas duas chamadas: criar um container de mídia a partir do arquivo e, depois, publicar esse container.

  • Foto: uma imagem JPEG, com legenda.
  • Carrossel: até 20 fotos e vídeos juntos em um post, com uma única legenda no carrossel.
  • Reel: um vídeo MOV ou MP4, com legenda.
  • Story: uma imagem ou um vídeo, visível por 24 horas.

Quantos posts uma conta pode publicar por dia?

100 pela API em 24 horas móveis, contando um carrossel uma vez. O Instagram aplica o limite quando o container é publicado, e não quando ele é criado; assim, um post acima do limite falha naquele momento, com código 9 e subcode 2207042.

GET /<IG_ID>/content_publishing_limit retorna quota_usage, o número de posts que a conta publicou nas últimas 24 horas. A referência desse endpoint ainda indica quota_total como 50, e a seção sobre carrosséis do guia de publicação também; por isso, use a cota que o endpoint retorna para a conta, em vez de confiar em qualquer um desses valores publicados.

Como funcionam os containers de mídia?

Um container é a mídia que o Instagram buscou e preparou, aguardando para ser publicada. Uma conta pode criar 400 deles em 24 horas móveis, mais do que consegue publicar, o que deixa espaço para recomeçar após uma falha. Um container que não for publicado em 24 horas expira, e a única solução é criar um novo.

Containers de vídeo precisam de processamento antes. O status_code fica como IN_PROGRESS até mudar para FINISHED, e a Meta sugere verificar uma vez por minuto, por no máximo 5 minutos.

Onde a mídia precisa estar?

Em um servidor público. A Meta busca o arquivo diretamente da URL da requisição, no momento da tentativa de publicação; por isso, o link precisa funcionar nesse momento, sem login à frente. A Meta também recomenda URLs compostas apenas por caracteres US-ASCII, pois a requisição pode falhar do contrário.

Um arquivo que a Meta não consegue buscar falha com código 9004, subcode 2207052, e um que demora demais para baixar falha com subcode 2207003. A Meta documenta seu upload retomável, que pode enviar um arquivo de vídeo a partir de um computador, somente para configurações construídas sobre Facebook Login for Business, incluindo o Unified Login; com Instagram Login, a mídia sempre vem de uma URL.

Quais são as regras para imagens?

Somente JPEG. Formatos JPEG estendidos, como MPO e JPS, são recusados, e o PNG também.

  • Tamanho do arquivo: até 8 MB.
  • Proporção: entre 4:5 e 1.91:1 para uma foto; a Meta recomenda 9:16 para um Story.
  • Largura: de 320 a 1440 pixels; imagens fora dessa faixa são redimensionadas para caber.
  • Espaço de cor: sRGB; imagens em outros espaços de cor são convertidas.

Quais são as regras para legendas?

Uma legenda pode ter até 2,200 caracteres e 20 tags @, com até 5 hashtags pela regra atual do Instagram (a referência da API da Meta ainda lista 30), e uma conta mencionada nela recebe notificação quando o post é publicado. As legendas pertencem às fotos, aos Reels e ao container do carrossel; os itens do carrossel não recebem nenhuma, e a referência da Meta não descreve legendas para Stories. Uma legenda acima do limite de tamanho falha com código 36004, subcode 2207010, e uma com tags @ demais falha com subcode 2207040.

O que a publicação pela API deixa de fora?

Alguns recursos do app do Instagram não têm equivalente de publicação na API.

  • Tags de compras e filtros.
  • Figurinhas de Story, como links, enquetes e localizações; mencionar uma conta sem figurinha funciona.
  • Reels como itens de carrossel.
  • Legendas em itens individuais do carrossel.

Erros comuns

  • Enviar imagens PNG ou HEIC. A API publica somente JPEG, e formatos JPEG estendidos, como MPO e JPS, também falham.
  • Publicar um container de vídeo logo em seguida. Aguarde o status_code mostrar FINISHED, ou a chamada falha com subcode 2207027.
  • Hospedar a mídia atrás de login ou em um link que expira. A Meta baixa o arquivo durante a tentativa de publicação e precisa de uma URL pública simples nesse momento.
  • Contar apenas os caracteres da legenda. A Meta também limita as tags @ a 20, e, a partir de novembro de 2026, a Central de Ajuda do Instagram permite 5 hashtags por post.
Fazendo isso com o EasyCoexistence

A partir de US$ 9 por número conectado por mês, caindo até US$ 0.75 conforme você adiciona números, com os primeiros 3 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

A API do Instagram pode publicar imagens PNG?

Não. Ela publica somente imagens JPEG; por isso, converta PNG ou qualquer outro formato para JPEG antes de publicar.

Um carrossel conta como um post?

Sim. No limite de 100 posts publicados pela API, um carrossel conta uma vez, não importa quantas fotos e vídeos ele tenha.

Como verificar quantos posts uma conta ainda pode publicar hoje?

Chame GET /<IG_ID>/content_publishing_limit. O campo quota_usage informa quantos posts a conta publicou pela API nas últimas 24 horas.

O limite da API do Instagram é de 50 ou 100 posts por dia?

100, segundo o guia de publicação da Meta, em 24 horas móveis. A referência de content_publishing_limit ainda indica um quota_total de 50, então use a cota que esse endpoint retorna para a conta, em vez de confiar em nenhum dos dois valores.

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