Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

1,000

O maior número de caracteres de texto alternativo que uma imagem pode ter através da API.

24 Mar 2025

Quando a Meta introduziu o campo alt_text para publicações de imagem no endpoint de media.

Images only

alt_text funciona em imagens únicas e em imagens de carrossel; os Reels e as Stories não são suportados.

alt_text

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.

An image container with alt text
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.
Fazer isto com a EasyCoexistence

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