Como o texto alternativo do Pinterest funciona nos Pins e na API

O que é o texto alternativo do Pinterest?

Escrever o texto alternativo do Pinterest significa preencher o campo alt_text de um Pin, uma descrição da imagem em texto simples que os leitores de tela falam em voz alta para quem não consegue vê-la. O campo pertence ao Pin, junto com o título, a descrição e o link, e a API do Pinterest o devolve em todo Pin que lê.

O texto alternativo e a descrição do Pin têm funções diferentes. A descrição é texto para quem navega e para o ranking do Pinterest: a página de especificações de produto do Pinterest diz "Descriptions are used by our algorithm to determine relevance for delivery." O texto alternativo descreve o que a imagem mostra, para quem usa tecnologia assistiva. Uma descrição escrita para buscas, como "macarrão fácil para o dia a dia, 20 minutos", não diz nada sobre a foto a quem usa um leitor de tela. O texto alternativo do mesmo Pin diria "uma tigela de espaguete com molho de tomate e manjericão sobre uma mesa de madeira".

Os dois também têm limites separados, então escrever um não ocupa espaço do outro.

Qual é o limite de caracteres do texto alternativo do Pinterest?

O limite de caracteres do texto alternativo do Pinterest é de 500 caracteres, definido no campo alt_text na referência da API do Pinterest para criar e atualizar um Pin. Veja como ele se compara aos outros campos de texto de um Pin:

A documentação para desenvolvedores marca alt_text como "Nullable", então um Pin sem texto alternativo é válido e volta com "alt_text": null. O número de 500 caracteres vem da referência da API. A central de ajuda do Pinterest não publica um número separado para o texto alternativo, então trate 500 como o teto para qualquer ferramenta que grave na API.

Como adicionar texto alternativo a um Pin?

Você adiciona texto alternativo a um Pin pelo campo alt_text quando o Pin é criado ou atualizado, que é o método que o Pinterest documenta para desenvolvedores e para ferramentas feitas sobre a sua API. No site e no app do Pinterest, o artigo da central de ajuda "Create a Pin from an image or video" lista como campos a preencher o título, a descrição, o link, a pasta, os tópicos relacionados, a publicação posterior, as opções de conteúdo modificado por IA e "More options" para comentários e recomendações de compras. O texto alternativo não está nessa lista. O artigo "Edit or delete a Pin" lista título, descrição, link, pasta e configurações de comentários, também sem texto alternativo.

Isso deixa duas rotas que o Pinterest documenta por completo:

1. Criar o Pin com texto alternativo. Envie POST /v5/pins com alt_text no corpo da requisição, ao lado de board_id, title, description e media_source.
2. Adicionar ou alterar depois. Envie PATCH /v5/pins/{pin_id} com um novo alt_text. O schema de atualização tem o mesmo limite de 500 caracteres.

Se o seu criador de Pins mostra um campo de texto alternativo, use-o do mesmo jeito e fique dentro de 500 caracteres para que o texto corresponda ao que a API aceita. O restante do fluxo de criação de Pins, das pastas aos formatos de imagem, está em como postar fotos no Pinterest.

Onde o alt_text entra em uma requisição à API do Pinterest?

O alt_text entra no nível superior do corpo do Pin na API do Pinterest, e não dentro de media_source, que só descreve de onde vem a imagem ou o vídeo. Uma requisição de Pin com uma única imagem fica assim:

{
  "board_id": "123456789012345678",
  "title": "Weeknight tomato pasta",
  "description": "A 20-minute pasta with five ingredients.",
  "alt_text": "A bowl of spaghetti with tomato sauce and fresh basil on a wooden table",
  "media_source": {
    "source_type": "image_url",
    "url": "https://example.com/pasta.jpg"
  }
}

Um Pin com várias imagens usa source_type: "multiple_image_urls" com 2 a 5 itens. Cada item recebe url, title, description e link, e nenhum deles recebe texto alternativo. O Pin como um todo carrega um único alt_text, então em um Pin com várias imagens descreva o conjunto ou a primeira imagem. Pins de vídeo usam source_type: "video_id" e o mesmo campo no nível superior.

A API do Pinterest tem as suas próprias cotas de chamadas, explicadas em o limite de requisições da API do Pinterest. Quando um Pin agendado não aparece, por que os Pins do Pinterest não estão sendo publicados lista as causas mais comuns.

Como escrever um bom texto alternativo no Pinterest?

Um bom texto alternativo no Pinterest diz o que a imagem mostra em uma ou duas frases simples, incluindo qualquer palavra impressa nela, e deixa as palavras-chave para o título e a descrição. Quando um Pin tem texto sobreposto, o leitor de tela não consegue ler as palavras gravadas na imagem, a menos que o texto alternativo as repita.

Uma lista rápida:

• Comece pelo assunto. "Uma toalha de mesa de linho vista de cima, com castiçais de latão" é melhor que "Imagem de decoração de mesa."
• Copie o texto sobreposto. Se o Pin diz "5 ideias de mesa para o outono" em letras grandes, coloque essas palavras no texto alternativo.
• Dispense "imagem de" e "Pin de". Os leitores de tela já anunciam que é uma imagem.
• Deixe de fora hashtags e links. O campo é texto simples, e a descrição já guarda os termos de busca.
• Fique abaixo de 500 caracteres. A maioria das imagens precisa de uma a três frases.

Os mesmos hábitos valem em outras redes, com limites diferentes. O guia de acessibilidade em redes sociais compara todos lado a lado.

Que texto alternativo o AdaptlyPost envia para o Pinterest?

O AdaptlyPost envia ao Pinterest o texto alternativo da primeira imagem como o alt_text do Pin, cortado em 500 caracteres, porque o Pinterest aceita um texto alternativo por Pin. A nota do compositor no campo de texto alternativo diz isso diretamente: "Pinterest uses the first image's alt text."

No compositor, cada imagem tem um botão "Add alt text" que abre uma caixa de diálogo pedindo "Describe the image for people who use screen readers." Você escreve uma descrição por imagem, com até 1,000 caracteres cada. A mesma descrição vai para todas as redes da publicação que aceitam texto alternativo, e para o Pinterest o AdaptlyPost pega a descrição da imagem 1 e a corta nos 500 do Pinterest. Em um Pin com várias imagens, o AdaptlyPost envia essa única descrição para o Pin inteiro. Pins de vídeo saem sem texto alternativo. A API do AdaptlyPost funciona do mesmo jeito: mediaAltTexts guarda uma string por imagem, na ordem de mediaUrls, e a documentação dela informa que o Pinterest recebe "first image only, max 500 characters."

Para garantir que o Pinterest receba uma descrição completa, escreva o texto alternativo da primeira imagem em 500 caracteres ou menos e descreva o Pin como um todo se ele tiver mais de uma imagem. O agendador de publicações para Pinterest cuida da pasta, do título, do link e do horário de publicação, e como agendar publicações no Pinterest mostra a configuração completa.

Perguntas frequentes

O Pinterest tem texto alternativo?

Tem. Todo Pin tem um campo alt_text na API do Pinterest, uma descrição da imagem em texto simples para leitores de tela. O campo aceita valor nulo, então Pins sem texto alternativo são válidos.

Qual é o limite de caracteres do texto alternativo do Pinterest?

O limite é de 500 caracteres, definido em alt_text na referência da API do Pinterest para criar e atualizar um Pin. O título aceita 100 caracteres e a descrição 800, e cada campo tem o seu próprio limite.

Como adiciono texto alternativo a um Pin existente?

Envie PATCH /v5/pins/{pin_id} com um novo valor de alt_text pela API do Pinterest ou por uma ferramenta feita sobre ela. O artigo de ajuda "Edit or delete a Pin" do Pinterest lista título, descrição, link, pasta e configurações de comentários como os campos editáveis, e não lista texto alternativo.

Cada imagem de um Pin com várias imagens pode ter o seu próprio texto alternativo?

Não. O alt_text fica no Pin, e não nos itens dentro de media_source, então um Pin com várias imagens tem um único texto alternativo. Descreva o conjunto de imagens, ou a primeira, nesse único campo.

O texto alternativo do Pinterest é o mesmo que a descrição do Pin?

Não. A descrição ajuda o algoritmo do Pinterest a "determine relevance for delivery" e é escrita para quem busca, enquanto o texto alternativo descreve a imagem para quem usa leitor de tela. São campos separados, com limites separados de 800 e 500 caracteres.

Que texto alternativo o AdaptlyPost envia para o Pinterest?

O AdaptlyPost envia o texto alternativo da primeira imagem como o alt_text do Pin, cortado em 500 caracteres. As descrições das outras imagens vão para as redes que aceitam uma por imagem, e não para o Pinterest. Pins de vídeo saem sem texto alternativo.

O que devo escrever no texto alternativo do Pinterest?

Diga o que a imagem mostra em uma ou duas frases simples, incluindo as palavras impressas nela. Evite "imagem de", porque os leitores de tela já anunciam uma imagem. Deixe hashtags e links de fora, pois a descrição já tem os termos de busca.

O texto alternativo do Pinterest é obrigatório?

O Pinterest não exige. A documentação para desenvolvedores marca alt_text como "Nullable", então um Pin sem texto alternativo é válido e volta com "alt_text": null.

Qual chamada de API define o texto alternativo de um Pin novo?

Envie POST /v5/pins com alt_text no corpo da requisição, ao lado de board_id, title, description e media_source. O campo fica no nível superior do Pin, não dentro de media_source.

Quantos caracteres posso escrever de texto alternativo no AdaptlyPost?

O compositor aceita até 1,000 caracteres por imagem. O Pinterest recebe só o texto alternativo da primeira imagem, cortado em 500 caracteres, então escreva essa primeira descrição com 500 ou menos.