Limites de publicação da API do Instagram: formatos, tamanhos e publicações por dia
O limite de publicação da API do Instagram é de 100 publicações por conta profissional numa janela móvel de 24 horas, contando um carrossel como uma só. Cada publicação aceita uma imagem JPEG 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, que a Meta obtém a partir de um URL público, e as legendas podem ter até 2,200 caracteres.
A easyCoexistence publica fotografias, 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, conclui sozinha um vídeo que ainda está a ser processado e agenda publicações a partir da sua própria fila.
Publicações feitas pela API por conta numa janela móvel de 24 horas; um carrossel conta como uma única publicação.
Maior imagem JPEG que a API aceita, com proporção entre 4:5 e 1.91:1.
Contentores de multimédia que uma conta pode criar numa janela móvel de 24 horas.
Tempo que um contentor de multimédia pode esperar sem ser publicado antes de expirar.
Caracteres permitidos numa legenda, com no máximo 20 menções @, segundo a referência de multimédia da Meta.
O número máximo de hashtags que o Centro de Ajuda do Instagram permite numa publicação.
Que conteúdos se podem publicar pela API?
Quatro formatos, e cada um segue as mesmas duas chamadas: criar um contentor de multimédia a partir do ficheiro e depois publicar esse contentor.
- Fotografia: uma imagem JPEG, com legenda.
- Carrossel: até 20 fotografias e vídeos em conjunto numa só publicação, com uma única legenda para o carrossel.
- Reel: um vídeo MOV ou MP4, com legenda.
- Story: uma imagem ou um vídeo, visível durante 24 horas.
Quantas publicações pode uma conta fazer num dia?
100 pela API numa janela móvel de 24 horas, contando um carrossel uma só vez. O Instagram aplica o limite quando um contentor é publicado e não quando é criado, pelo que uma publicação acima do limite falha nesse momento, com o código 9 e o subcódigo 2207042.
GET /<IG_ID>/content_publishing_limit devolve quota_usage, o número de publicações que a conta fez nas últimas 24 horas. A referência desse endpoint ainda indica quota_total como 50, e a secção sobre carrosséis do guia de publicação também, pelo que deve ler a quota que o endpoint devolve para a conta, em vez de confiar em nenhum dos dois valores publicados.
Como funcionam os contentores de multimédia?
Um contentor é o conteúdo multimédia que o Instagram obteve e preparou, à espera de ser publicado. Uma conta pode criar 400 deles numa janela móvel de 24 horas, mais do que consegue publicar, o que deixa margem para recomeçar após uma falha. Um contentor que não seja publicado em 24 horas expira, e a única solução é criar um novo.
Os contentores de vídeo precisam de processamento primeiro. O status_code indica IN_PROGRESS até mudar para FINISHED, e a Meta sugere verificar uma vez por minuto, durante no máximo 5 minutos.
Onde têm de estar os conteúdos multimédia?
Num servidor público. A Meta obtém o ficheiro diretamente a partir do URL no pedido, no momento da tentativa de publicação, pelo que a ligação tem de funcionar nesse momento, sem nenhum início de sessão à frente. A Meta recomenda também URL formados apenas por caracteres US-ASCII, caso contrário o pedido pode falhar.
Um ficheiro que a Meta não consiga obter falha com o código 9004, subcódigo 2207052, e um que demore demasiado a transferir falha com o subcódigo 2207003. A Meta documenta o seu carregamento retomável, que pode enviar um ficheiro de vídeo a partir de um computador, apenas para configurações criadas com o Facebook Login for Business, incluindo o Unified Login; com o Instagram Login, os conteúdos multimédia vêm sempre de um URL.
Quais são as regras das imagens?
Apenas JPEG. Formatos JPEG estendidos, como MPO e JPS, são recusados, e o PNG também.
- Tamanho do ficheiro: até 8 MB.
- Proporção: entre 4:5 e 1.91:1 para uma fotografia; a Meta recomenda 9:16 para um Story.
- Largura: de 320 a 1440 pixels; as imagens fora deste intervalo são redimensionadas para caberem.
- Espaço de cor: sRGB; as imagens noutros espaços de cor são convertidas.
Quais são as regras das legendas?
Uma legenda pode ter até 2,200 caracteres e 20 menções @, com até 5 hashtags segundo a regra atual do Instagram (a referência da API da Meta ainda indica 30). Uma conta mencionada na legenda é notificada quando a publicação é feita. As legendas pertencem às fotografias, aos Reels e ao contentor do carrossel; os itens do carrossel não têm nenhuma, e a referência da Meta não descreve legendas para os Stories. Uma legenda acima do limite de comprimento falha com o código 36004, subcódigo 2207010, e uma com demasiadas menções @ falha com o subcódigo 2207040.
O que a publicação pela API não inclui?
Algumas funcionalidades da aplicação do Instagram não têm equivalente na API de publicação.
- Etiquetas de produtos e filtros.
- Autocolantes de Story, como ligações, sondagens e localizações; mencionar uma conta sem autocolante funciona.
- Reels como itens de carrossel.
- Legendas em itens individuais do carrossel.
Erros comuns
- Carregar imagens PNG ou HEIC. A API só publica JPEG, e os formatos JPEG estendidos, como MPO e JPS, também falham.
- Publicar um contentor de vídeo de imediato. Aguarde que o status_code indique FINISHED, ou a chamada falha com o subcódigo 2207027.
- Alojar conteúdos multimédia atrás de um início de sessão ou numa ligação que expira. A Meta transfere o ficheiro durante a tentativa de publicação e precisa então de um URL público simples.
- Contar apenas os caracteres de uma legenda. A Meta também limita as menções @ a 20, e, a partir de novembro de 2026, o Centro de Ajuda do Instagram permite 5 hashtags numa publicação.
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Pode a API do Instagram publicar imagens PNG?
Não. Publica apenas imagens JPEG, por isso converta PNG ou qualquer outro formato para JPEG antes de publicar.
Um carrossel conta como uma publicação?
Sim. Para o limite de 100 publicações feitas pela API, um carrossel conta uma vez, independentemente do número de fotografias e vídeos que tiver.
Como vejo quantas publicações ainda restam hoje numa conta?
Chame GET /<IG_ID>/content_publishing_limit. O campo quota_usage indica quantas publicações a conta fez pela API nas últimas 24 horas.
O limite da API do Instagram é de 50 ou 100 publicações por dia?
100, segundo o guia de publicação da Meta, numa janela móvel de 24 horas. A referência de content_publishing_limit ainda indica um quota_total de 50, por isso leia a quota que esse endpoint devolve para a conta, em vez de confiar em nenhum dos dois valores.
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