Texto alternativo nas publicações do Instagram através da API
A API do Instagram adiciona texto alternativo a uma publicação de imagem através do parâmetro alt_text, definido quando o contentor de média é criado. Aceita até 1.000 caracteres e funciona numa foto única ou em cada imagem de um carrossel, mas os Reels e as Stories não o suportam. A Meta introduziu o campo a 24 de março de 2025.
easyCoexistence publica fotos e carrosséis com publish_instagram_post a partir do Claude, do ChatGPT ou do seu próprio código.
O maior número de caracteres de texto alternativo que uma imagem pode ter através da API.
Quando a Meta introduziu o campo alt_text para publicações de imagem no endpoint de media.
alt_text funciona em imagens únicas e em imagens de carrossel; os Reels e as Stories não são suportados.
Campo de um media publicado que devolve o texto descritivo de uma imagem, para acessibilidade.
O que é o texto alternativo numa publicação do Instagram?
Uma descrição escrita de uma imagem, que a referência de media da Meta designa por texto descritivo para imagens, para acessibilidade. Através da API define-se por imagem com o parâmetro alt_text quando o contentor é criado, e lê-se a partir do campo alt_text depois de publicada.
Como se adiciona o texto alternativo?
Com alt_text no contentor da imagem. POST /<IG_ID>/media com image_url, a legenda e alt_text cria-o, e POST /<IG_ID>/media_publish publica-o como habitualmente. Num carrossel, define-se alt_text no contentor de cada item de imagem, os criados com is_carousel_item definido como true, antes de criar o contentor 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>"
}Que publicações suportam texto alternativo?
Apenas publicações de imagem, tal como a referência da Meta descreve o parâmetro:
- Uma publicação de imagem única: suportado, até 1.000 caracteres.
- Imagens num carrossel: suportado, cada uma com o seu próprio texto.
- Vídeos, incluindo itens de vídeo num carrossel: não suportado.
- Reels e Stories: não suportados.
- O próprio contentor do carrossel: o texto coloca-se nos seus itens de imagem em vez disso.
Como se lê o texto alternativo?
Pede-se o campo alt_text na imagem publicada, GET /<IG_MEDIA_ID>?fields=alt_text. É um campo público do objeto de media, pelo que também pode ser pedido para as imagens de um carrossel através do edge children, que lista as fotos e os vídeos dentro da publicação.
O texto alternativo pode ser alterado depois de publicar?
A Meta não documenta forma de o fazer. A única atualização que a sua referência de media indica para uma publicação já feita liga ou desliga os comentários, por isso o texto alternativo escreve-se no contentor antes de a publicação entrar no ar, juntamente com a legenda e o URL da imagem.
Erros comuns
- Enviar alt_text com um Reel ou uma Story. A Meta só o suporta em publicações de imagem.
- Colocá-lo no contentor do carrossel. O texto alternativo pertence a cada item de imagem dentro do carrossel.
- Escrever para além de 1.000 caracteres. É o máximo que o texto alternativo de uma imagem pode ter.
A ferramenta não aceita alt_text, pelo que a descrição é acrescentada na app do Instagram, a partir da opção Editar da publicação. De US$ 9 até US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Quanto pode ter o texto alternativo através da API do Instagram?
Até 1.000 caracteres por imagem, definidos com alt_text no contentor de cada imagem, pelo que cada imagem de um carrossel tem o seu próprio texto.
Um Reel pode ter texto alternativo através da API?
Não. A Meta não suporta alt_text em Reels nem em Stories.
Como adiciono texto alternativo a um carrossel?
Defina alt_text no contentor de cada item de imagem, criado com is_carousel_item definido como true, antes de criar o contentor do carrossel.
Quando é que a API do Instagram passou a ter texto alternativo?
A Meta introduziu o campo alt_text para publicações de imagem a 24 de março de 2025.
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