Cómo funciona el texto alternativo de Pinterest en los Pines y en la API

¿Qué es el texto alternativo de Pinterest?

Escribir el texto alternativo de Pinterest consiste en rellenar el campo alt_text de un Pin, una descripción en texto plano de la imagen que los lectores de pantalla leen en voz alta para quien no puede verla. El campo pertenece al Pin, junto a su título, su descripción y su enlace, y la API de Pinterest lo devuelve en cada Pin que lee.

El texto alternativo y la descripción del Pin cumplen funciones distintas. La descripción es texto para quien navega y para el ranking de Pinterest: la página de especificaciones de producto de Pinterest dice "Descriptions are used by our algorithm to determine relevance for delivery." El texto alternativo describe lo que muestra la imagen para quien usa tecnología de asistencia. Una descripción escrita para buscadores, como "pasta fácil entre semana, 20 minutos", no le dice nada sobre la imagen a quien usa un lector de pantalla. El texto alternativo del mismo Pin dice "un plato de espaguetis con salsa de tomate y albahaca sobre una mesa de madera".

Además, los dos tienen límites separados, así que escribir uno no gasta espacio del otro.

¿Cuál es el límite de caracteres del texto alternativo de Pinterest?

El límite de caracteres del texto alternativo de Pinterest es de 500 caracteres, fijado en el campo alt_text de la referencia de la API de Pinterest para crear y actualizar un Pin. Así se compara con los demás campos de texto de un Pin:

La documentación para desarrolladores marca alt_text como "Nullable", así que un Pin sin texto alternativo es válido y vuelve con "alt_text": null. La cifra de 500 caracteres sale de la referencia de la API. El centro de ayuda de Pinterest no publica una cifra propia para el texto alternativo, así que toma 500 como el techo para cualquier herramienta que escriba en la API.

¿Cómo se añade texto alternativo a un Pin?

Añades texto alternativo a un Pin con el campo alt_text al crear o actualizar el Pin, que es el método que Pinterest documenta para desarrolladores y para las herramientas construidas sobre su API. En la web y la app de Pinterest, el artículo del centro de ayuda "Create a Pin from an image or video" enumera los campos que rellenas: título, descripción, enlace, tablero, temas relacionados, publicar más tarde, los interruptores de contenido modificado con IA y "More options" para comentarios y recomendaciones de compra. El texto alternativo no está en esa lista. El artículo "Edit or delete a Pin" enumera título, descripción, enlace, tablero y ajustes de comentarios, y tampoco incluye el texto alternativo.

Eso deja dos vías que Pinterest documenta por completo:

1. Crear el Pin con texto alternativo. Envía POST /v5/pins con alt_text en el cuerpo de la petición, junto a board_id, title, description y media_source.
2. Añadirlo o cambiarlo después. Envía PATCH /v5/pins/{pin_id} con un alt_text nuevo. El esquema de actualización tiene el mismo límite de 500 caracteres.

Si tu propio creador de Pines muestra un campo de texto alternativo, úsalo igual y no pases de 500 caracteres para que el texto encaje con lo que acepta la API. El resto del proceso de creación de un Pin, de los tableros a los formatos de imagen, se explica en cómo publicar fotos en Pinterest.

¿Dónde va alt_text en una petición a la API de Pinterest?

alt_text va en el nivel superior del cuerpo del Pin en la API de Pinterest, no dentro de media_source, que solo describe de dónde viene la imagen o el vídeo. Una petición de Pin con una sola imagen tiene este aspecto:

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

Un Pin de varias imágenes usa source_type: "multiple_image_urls" con 2 a 5 elementos. Cada elemento acepta url, title, description y link, y ninguno acepta texto alternativo. El Pin en conjunto lleva un solo alt_text, así que en un Pin de varias imágenes describe el conjunto o la primera imagen. Los Pines de vídeo usan source_type: "video_id" y el mismo campo de nivel superior.

La API de Pinterest tiene sus propias cuotas de llamadas, explicadas en el límite de tasa de la API de Pinterest. Cuando un Pin programado no aparece, por qué no se publican los Pines de Pinterest recoge las causas habituales.

¿Cómo se escribe un buen texto alternativo de Pinterest?

Un buen texto alternativo de Pinterest nombra lo que muestra la imagen en una o dos frases sencillas, incluidas las palabras impresas en ella, y deja las palabras clave para el título y la descripción. Cuando un Pin lleva texto superpuesto, un lector de pantalla no puede leer las palabras incrustadas en la imagen salvo que el texto alternativo las repita.

Una lista breve:

• Empieza por el tema. "Un bodegón cenital de un mantel de lino con candelabros de latón" es mejor que "Imagen de decoración de mesa."
• Copia el texto superpuesto. Si el Pin dice "5 ideas para tu mesa de otoño" en letras grandes, pon esas palabras en el texto alternativo.
• Omite "imagen de" y "Pin de". Los lectores de pantalla ya anuncian que es una imagen.
• Deja fuera hashtags y enlaces. El campo es texto plano, y la descripción ya contiene los términos de búsqueda.
• No pases de 500 caracteres. La mayoría de las imágenes necesitan de una a tres frases.

Los mismos hábitos sirven en otras redes, con otros límites. La guía de accesibilidad en redes sociales los compara uno junto a otro.

¿Qué texto alternativo envía AdaptlyPost a Pinterest?

AdaptlyPost envía a Pinterest el texto alternativo de la primera imagen como alt_text del Pin, recortado a 500 caracteres, porque Pinterest acepta un solo texto alternativo por Pin. La nota del compositor junto al campo de texto alternativo lo dice sin rodeos: "Pinterest uses the first image's alt text."

En el compositor, cada imagen tiene un botón "Add alt text" que abre un diálogo donde se te pide "Describe the image for people who use screen readers." Escribes una descripción por imagen, de hasta 1,000 caracteres cada una. La misma descripción va a cada red del post que acepta texto alternativo, y para Pinterest AdaptlyPost toma la descripción de la imagen 1 y la recorta a los 500 de Pinterest. En un Pin de varias imágenes, AdaptlyPost envía esa única descripción para todo el Pin. Los Pines de vídeo salen sin texto alternativo. La API de AdaptlyPost funciona igual: mediaAltTexts contiene un string por imagen, en el orden de mediaUrls, y su documentación indica que Pinterest recibe "first image only, max 500 characters."

Para que Pinterest reciba una descripción completa, escribe el texto alternativo de la primera imagen en 500 caracteres o menos, y describe el Pin en conjunto si contiene más de una imagen. El programador de posts para Pinterest gestiona el tablero, el título, el enlace y la hora de publicación, y cómo programar posts en Pinterest recorre la configuración completa.

Preguntas frecuentes

¿Pinterest tiene texto alternativo?

Sí. Cada Pin tiene un campo alt_text en la API de Pinterest, una descripción en texto plano de la imagen para lectores de pantalla. Admite valores nulos, así que los Pines sin texto alternativo son válidos.

¿Cuál es el límite de caracteres del texto alternativo de Pinterest?

El límite es de 500 caracteres, fijado en alt_text en la referencia de la API de Pinterest para crear y actualizar un Pin. El título admite 100 caracteres y la descripción 800, y cada campo tiene su propio límite.

¿Cómo añado texto alternativo a un Pin que ya existe?

Envía PATCH /v5/pins/{pin_id} con un valor nuevo de alt_text a través de la API de Pinterest o de una herramienta construida sobre ella. El artículo de ayuda "Edit or delete a Pin" de Pinterest enumera título, descripción, enlace, tablero y ajustes de comentarios como los campos que editas, y no incluye el texto alternativo.

¿Puede cada imagen de un Pin de varias imágenes tener su propio texto alternativo?

No. alt_text está en el Pin, no en los elementos dentro de media_source, así que un Pin de varias imágenes lleva un solo texto alternativo. Describe el conjunto de imágenes, o la primera, en ese único campo.

¿El texto alternativo de Pinterest es lo mismo que la descripción del Pin?

No. La descripción ayuda al algoritmo de Pinterest a "determine relevance for delivery" y se escribe para quien busca, mientras que el texto alternativo describe la imagen para quien usa un lector de pantalla. Son campos separados con límites separados de 800 y 500 caracteres.

¿Qué texto alternativo envía AdaptlyPost a Pinterest?

AdaptlyPost envía el texto alternativo de la primera imagen como alt_text del Pin, recortado a 500 caracteres. Las descripciones de las demás imágenes van a las redes que aceptan una por imagen, no a Pinterest. Los Pines de vídeo salen sin texto alternativo.

¿Qué debo escribir en el texto alternativo de Pinterest?

Di qué muestra la imagen en una o dos frases sencillas, incluidas las palabras impresas en ella. Evita "imagen de", porque los lectores de pantalla ya anuncian una imagen. Deja fuera hashtags y enlaces, ya que la descripción contiene los términos de búsqueda.

¿El texto alternativo de Pinterest es obligatorio?

Pinterest no lo exige. La documentación para desarrolladores marca alt_text como "Nullable", así que un Pin sin texto alternativo es válido y se devuelve con "alt_text": null.

¿Qué llamada a la API define el texto alternativo de un Pin nuevo?

Envía POST /v5/pins con alt_text en el cuerpo de la petición, junto a board_id, title, description y media_source. El campo va en el nivel superior del Pin, no dentro de media_source.

¿Cuántos caracteres puedo escribir de texto alternativo en AdaptlyPost?

El compositor admite hasta 1,000 caracteres por imagen. Pinterest recibe solo el texto alternativo de la primera imagen, recortado a 500 caracteres, así que escribe esa primera descripción con 500 o menos.