Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Texto alternativo en publicaciones de Instagram mediante la API

La API de Instagram añade texto alternativo a una publicación de imagen mediante el parámetro alt_text, que se define al crear el contenedor de medios. Admite hasta 1,000 caracteres y funciona en una sola foto o en cada imagen de un carrusel, mientras que Reels e Historias no lo admiten. Meta añadió el campo el 24 de marzo de 2025.

easyCoexistence publica fotos y carruseles con publish_instagram_post desde Claude, ChatGPT o tu propio código.

1,000

La mayor cantidad de caracteres de texto alternativo que una imagen puede tener a través de la API.

24 Mar 2025

Cuando Meta introdujo el campo alt_text para publicaciones de imagen en el endpoint de medios.

Images only

alt_text funciona con imágenes individuales y con imágenes de carrusel; Reels e Historias no son compatibles.

alt_text

Campo de los medios publicados que devuelve el texto descriptivo de una imagen, para accesibilidad.

¿Qué es el texto alternativo de una publicación de Instagram?

Una descripción escrita de una imagen, que la referencia de medios de Meta llama texto descriptivo para imágenes, con fines de accesibilidad. A través de la API se define por imagen con el parámetro alt_text al crear el contenedor, y se lee desde el campo alt_text una vez publicado el contenido.

¿Cómo se añade el texto alternativo?

Con alt_text en el contenedor de la imagen. POST /<IG_ID>/media con image_url, el caption y alt_text lo crea, y POST /<IG_ID>/media_publish lo publica como de costumbre. En un carrusel, define alt_text en el contenedor de cada elemento de imagen, los creados con is_carousel_item en true, antes de crear el contenedor del carrusel.

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

¿Qué publicaciones admiten texto alternativo?

Solo publicaciones de imagen, tal como describe Meta la referencia del parámetro:

  • Una publicación de una sola imagen: compatible, hasta 1,000 caracteres.
  • Imágenes de un carrusel: compatible, cada una con su propio texto.
  • Videos, incluidos los elementos de video de un carrusel: no compatible.
  • Reels e Historias: no compatible.
  • El contenedor del carrusel en sí: el texto va en sus elementos de imagen.

¿Cómo se lee el texto alternativo?

Solicita el campo alt_text de la imagen publicada, GET /<IG_MEDIA_ID>?fields=alt_text. Es un campo público del objeto de medios, así que también puede solicitarse para las imágenes de un carrusel a través de la arista children, que enumera las fotos y videos dentro de la publicación.

¿Se puede cambiar el texto alternativo después de publicar?

Meta no documenta ninguna forma de hacerlo. La única actualización que su referencia de medios enumera para una publicación ya publicada activa o desactiva los comentarios, así que el texto alternativo se escribe en el contenedor antes de publicarse, junto con el caption y la URL de la imagen.

Errores comunes

  • Enviar alt_text con un Reel o una Historia. Meta lo admite solo en publicaciones de imagen.
  • Ponerlo en el contenedor del carrusel. El texto alternativo pertenece a cada elemento de imagen dentro del carrusel.
  • Escribir más de 1,000 caracteres. Ese es el máximo que puede tener el texto alternativo de una imagen.
Hacerlo con EasyCoexistence

La herramienta no acepta alt_text, así que la descripción se añade en la app de Instagram, desde la opción Editar de la publicación. Desde US$ 9 hasta US$ 0.75 por conexión al mes, que baja a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Cuánto puede medir el texto alternativo en la API de Instagram?

Hasta 1,000 caracteres por imagen, definidos con alt_text en el contenedor de cada imagen, así que cada imagen de un carrusel tiene su propio texto.

¿Puede un Reel tener texto alternativo mediante la API?

No. Meta no admite alt_text en Reels ni en Historias.

¿Cómo añado texto alternativo a un carrusel?

Define alt_text en el contenedor de cada elemento de imagen, creado con is_carousel_item en true, antes de crear el contenedor del carrusel.

¿Cuándo añadió la API de Instagram el texto alternativo?

Meta introdujo el campo alt_text para publicaciones de imagen el 24 de marzo de 2025.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el