Limites de legenda do Instagram: caracteres, hashtags e menções @ na API
A API do Instagram aceita uma legenda com até 2,200 caracteres numa fotografia, Reel ou carrossel, com no máximo 20 menções @. Em novembro de 2026, o Centro de Ajuda do Instagram permite 5 hashtags por publicação, mas a referência da API da Meta ainda indica 30, pelo que convém ficar nas 5. As contas mencionadas com @ são notificadas quando a publicação é feita, e uma legenda demasiado longa falha com o código 36004, subcódigo 2207010.
A easyCoexistence publica uma fotografia, um carrossel ou um Reel com a respetiva legenda através de publish_instagram_post, a partir do Claude, do ChatGPT ou do seu próprio código, definindo a legenda uma só vez num carrossel, e list_social_posts devolve a legenda de cada publicação.
Número máximo de caracteres que uma legenda pode ter através da API do Instagram.
Número máximo de hashtags que o Centro de Ajuda do Instagram permite agora numa publicação, na legenda ou nos comentários.
Número máximo de hashtags por legenda na referência da API da Meta, que ainda indica o valor antigo.
Número máximo de menções @ numa legenda; ultrapassar devolve o código 100, subcódigo 2207040.
Subcódigo de erro, sob o código 36004, para uma legenda mais longa do que o Instagram permite.
media_publish pode ter êxito com config_issue CAPTION_NOT_ATTACHED: a publicação fica online sem a legenda.
Quais são os limites da legenda?
São três, todos no parâmetro caption do container de media. Uma legenda pode incluir hashtags, escritas como #tag, e nomes de utilizador de contas do Instagram, escritos como @username, dentro destes limites:
- Comprimento: até 2,200 caracteres.
- Hashtags: até 5 por publicação, segundo o Centro de Ajuda do Instagram, contando as dos comentários; a referência da API da Meta ainda indica 30.
- Menções @: até 20, e cada conta mencionada é notificada quando a publicação é feita.
Que publicações levam legenda?
Fotografias, Reels e carrosséis. Num carrossel, a legenda vai no container do carrossel, uma vez que as imagens e os vídeos dentro dele não a suportam, e a referência da Meta não descreve legenda para Stories; por isso, o texto destinado a uma Story deve ir na própria imagem ou vídeo.
O que acontece quando uma legenda ultrapassa um limite?
O pedido falha com um erro que indica o problema. Uma legenda demasiado longa devolve o código 36004, subcódigo 2207010, e a correção sugerida pela Meta repete os limites: no máximo 2,200 caracteres, 30 hashtags e 20 menções @. Mais de 20 menções @ podem também devolver o código 100, subcódigo 2207040. Encurte a legenda e envie o pedido novamente.
Quando são notificadas as contas mencionadas?
Quando o container é publicado, e não quando é criado. As contas mencionadas com @ numa legenda recebem a notificação nesse momento, por isso um container preparado com antecedência não alerta ninguém até entrar em linha. O limite da Meta de 20 menções @ por legenda aplica-se a estas menções.
Pode uma publicação ficar online sem legenda?
Sim. media_publish pode ter êxito com o campo config_issue definido como CAPTION_NOT_ATTACHED, o que significa que o conteúdo multimédia foi publicado sem a legenda. A Meta chama a isto um êxito parcial: o ID do conteúdo é válido, por isso concilie a publicação em vez de a publicar de novo.
Pode uma legenda ser alterada depois de publicada?
A referência de media da Meta documenta uma única atualização para conteúdo já publicado: ativar ou desativar os comentários com POST /<IG_MEDIA_ID> e comment_enabled. Não indica nenhuma forma de editar a legenda; por isso, verifique o texto, as hashtags e as menções @ antes de criar o container.
Erros comuns
- Verificar apenas o comprimento. Uma legenda com menos de 2,200 caracteres continua a violar os limites se tiver mais de 5 hashtags, a regra atual do Instagram, ou mais de 20 menções @.
- Legendar os itens do carrossel. Só o container do carrossel recebe legenda.
- Escrever legenda para uma Story. O container de Stories não aceita legenda; coloque o texto na imagem ou no vídeo.
- Publicar de novo depois de CAPTION_NOT_ATTACHED. A primeira publicação já está online, e uma segunda publicação cria um duplicado.
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
O que significa o erro 2207040 no Instagram?
A legenda tem mais de 20 menções @, devolvidas sob o código 100. Remova menções até restarem 20 ou menos e envie o pedido novamente.
O limite de 5 hashtags do Instagram inclui as hashtags nos comentários?
Sim. O Centro de Ajuda do Instagram permite até 5 hashtags por publicação, contando as que estão na legenda e nas dos comentários.
Posso desativar os comentários de uma publicação já feita através da API?
Sim. POST /<IG_MEDIA_ID> com comment_enabled definido como false desativa os comentários, e true volta a ativá-los; é a única atualização que a referência de media da Meta documenta para conteúdo já publicado.
O que significa o erro 2207010?
A legenda é mais longa do que o Instagram permite. Encurte-a para 2,200 caracteres ou menos e envie o pedido novamente.
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