Texto alternativo em posts do Instagram pela API
A API do Instagram adiciona texto alternativo a um post de imagem pelo parâmetro alt_text, definido ao criar o container de mídia. Ele aceita até 1.000 caracteres e funciona em uma foto única ou em cada imagem de um carrossel, mas Reels e Stories não o suportam. A Meta incluiu o campo em 24 de março de 2025.
O easyCoexistence publica fotos e carrosséis com publish_instagram_post a partir do Claude, do ChatGPT ou do seu próprio código.
Maior quantidade de caracteres de texto alternativo que uma imagem pode ter pela API.
Quando a Meta introduziu o campo alt_text para posts de imagem no endpoint de mídia.
alt_text funciona em imagens únicas e em imagens de carrossel; Reels e Stories não são suportados.
Campo de mídia publicada que retorna o texto descritivo de uma imagem, para acessibilidade.
O que é texto alternativo em um post do Instagram?
Uma descrição escrita de uma imagem, que a referência de mídia da Meta chama de texto descritivo para imagens, voltado à acessibilidade. Pela API, ele é definido por imagem com o parâmetro alt_text ao criar o container, e lido de volta pelo campo alt_text depois que o post é publicado.
Como adicionar texto alternativo?
Com alt_text no container da imagem. POST /<IG_ID>/media com image_url, a legenda e alt_text cria o container, e POST /<IG_ID>/media_publish publica normalmente. Para um carrossel, defina alt_text no container de cada item de imagem, criado com is_carousel_item definido como true, antes de criar o container do carrossel.
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json
{
"image_url": "https://example.com/photo.jpg",
"caption": "<CAPTION>",
"alt_text": "<WHAT_THE_IMAGE_SHOWS>"
}Quais posts suportam texto alternativo?
Somente posts de imagem, conforme a referência da Meta descreve o parâmetro:
- Post de imagem única: suportado, até 1.000 caracteres.
- Imagens em um carrossel: suportado, cada uma com seu próprio texto.
- Vídeos, incluindo itens de vídeo em um carrossel: não suportado.
- Reels e Stories: não suportados.
- O container do carrossel em si: o texto vai nos seus itens de imagem.
Como ler o texto alternativo de volta?
Solicite o campo alt_text na imagem publicada, GET /<IG_MEDIA_ID>?fields=alt_text. É um campo público do objeto de mídia, então também pode ser solicitado para as imagens de um carrossel pela edge children, que lista as fotos e vídeos dentro do post.
Dá para alterar o texto alternativo depois de publicar?
A Meta não documenta nenhuma forma de fazer isso. A única atualização que a referência de mídia lista para um post publicado liga ou desliga os comentários, então o texto alternativo é escrito no container antes de o post ir ao ar, junto com a legenda e a URL da imagem.
Erros comuns
- Enviar alt_text com um Reel ou um Story. A Meta suporta o campo apenas em posts de imagem.
- Colocar no container do carrossel. O texto alternativo pertence a cada item de imagem dentro do carrossel.
- Escrever mais de 1.000 caracteres. Esse é o máximo que o texto alternativo de uma imagem pode ter.
A ferramenta não recebe alt_text, então a descrição é adicionada no app do Instagram, pela opção Editar do post. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, 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
Qual o tamanho máximo do texto alternativo pela API do Instagram?
Até 1.000 caracteres por imagem, definidos com alt_text no container de cada imagem, então cada imagem de um carrossel tem seu próprio texto.
Um Reel pode ter texto alternativo pela API?
Não. A Meta não suporta alt_text em Reels ou Stories.
Como adiciono texto alternativo a um carrossel?
Defina alt_text no container de cada item de imagem, criado com is_carousel_item definido como true, antes de criar o container do carrossel.
Quando a API do Instagram passou a aceitar texto alternativo?
A Meta introduziu o campo alt_text para posts de imagem em 24 de março de 2025.
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