EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

1,000

Maior quantidade de caracteres de texto alternativo que uma imagem pode ter pela API.

24 Mar 2025

Quando a Meta introduziu o campo alt_text para posts de imagem no endpoint de mídia.

Images only

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

alt_text

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.

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>"
}

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.
Fazendo isso com o EasyCoexistence

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