Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Publicaciones de carrusel de Instagram a través de la API

La API de Instagram publica un carrusel como una sola publicación de hasta 20 fotos y videos según la guía de publicación de Meta, aunque su referencia de errores todavía dice 10. Cada elemento tiene su propio contenedor con is_carousel_item en true; luego, un contenedor CAROUSEL los enumera como hijos y lleva el pie de foto. Al publicar ese contenedor, las piezas se publican juntas y cuentan como una de las 100 publicaciones hechas por API permitidas en 24 horas.

easyCoexistence publica carruseles de 2 a 10 fotos y videos con publish_instagram_post desde Claude, ChatGPT o tu propio código: una llamada con los elementos y el pie de foto publica la publicación, y se completa por sí sola mientras un video sigue procesándose.

Up to 20

Fotos y videos que puede contener un carrusel según la guía de publicación de Meta y el parámetro children.

2207028

Subcódigo, dentro del código 100, cuyo mensaje todavía indica que un carrusel necesita de 2 a 10 elementos.

1 post

Cuánto cuenta un carrusel frente al límite de 100 publicaciones por API en 24 horas.

1:1

Recorte predeterminado de las imágenes del carrusel, que siguen la relación de aspecto de la primera imagen.

0

Insights que Meta devuelve para las fotos y videos individuales dentro de un carrusel.

¿Cómo se publica un carrusel?

En tres etapas, todas mediante POST /<IG_ID>/media y una única llamada de publicación.

  • Elementos: crea un contenedor para cada foto (image_url) o video (media_type VIDEO y video_url), con is_carousel_item en true y sin pie de foto.
  • Carrusel: crea un contenedor con media_type CAROUSEL, children con los IDs de los contenedores de elementos separados por comas, y el pie de foto.
  • Publicación: POST /<IG_ID>/media_publish con creation_id igual al ID del contenedor del carrusel.

¿Cuántos elementos puede tener un carrusel?

Hasta 20. La guía de publicación de Meta y el parámetro children de POST /<IG_ID>/media fijan el límite en 20 imágenes, videos o una mezcla de ambos. La referencia de errores todavía dice otra cosa: el mensaje del código 100, subcódigo 2207028, indica que un carrusel necesita al menos 2 y no más de 10 elementos, así que de 2 a 10 es el número que aceptan todas las partes de la documentación de Meta. Los elementos pueden ser fotos o videos, pero no Reels: un elemento de carrusel siempre es un contenedor de imagen o de video.

¿Cómo se recortan las imágenes del carrusel?

Según la primera. Todas las imágenes de un carrusel se recortan a la relación de aspecto de la primera, y el predeterminado es un cuadrado 1:1. Cada imagen debe cumplir las reglas habituales: JPEG, hasta 8 MB, entre 4:5 y 1.91:1. Pon primero la imagen cuya forma quieres o haz que todas tengan la misma forma antes de publicar.

¿Qué pertenece al carrusel y qué a cada elemento?

La mayoría de los ajustes de publicación van en el contenedor del carrusel, no en los elementos.

  • Pie de foto: solo en el contenedor del carrusel; los elementos no admiten uno.
  • Ubicación: solo en el contenedor del carrusel.
  • Etiqueta de contenido generado por IA: is_ai_generated va en el contenedor del carrusel, y ponerlo en un elemento devuelve un error.
  • Texto alternativo: admitido en los elementos de imagen, hasta 1,000 caracteres cada uno.

¿Cómo se lee un carrusel después?

Como un único objeto multimedia con media_type CAROUSEL_ALBUM. GET /<IG_MEDIA_ID>/children enumera las fotos y videos que contiene, aunque algunos campos, como permalink, no funcionan en los hijos. Los contadores de comentarios y me gusta del carrusel excluyen a sus hijos, y Meta no devuelve insights para los elementos individuales, solo para la publicación del carrusel.

¿Cómo cuenta un carrusel frente a los límites?

Como una sola publicación. Una cuenta puede publicar 100 publicaciones por API en 24 horas móviles, y un carrusel usa una de ellas sin importar cuántos elementos tenga. Sin embargo, cada elemento sigue siendo un contenedor, y una cuenta puede crear 400 contenedores en 24 horas continuas, así que una serie de carruseles de diez elementos alcanza ese techo antes que el tope de publicaciones.

Errores comunes

  • Poner el pie de foto en un elemento. Los carruseles no admiten pie en sus elementos; configúralo una vez en el contenedor del carrusel.
  • Añadir un Reel como elemento. Los elementos del carrusel son contenedores de imagen o video, y un Reel no puede aparecer en un carrusel.
  • Mezclar fotos verticales y horizontales sin revisar la primera. Cada imagen toma la relación de aspecto de la primera.
  • Esperar insights por diapositiva. Meta no devuelve ninguno para los medios dentro de un carrusel, solo para la publicación.
Hacerlo con EasyCoexistence

Los carruseles también se pueden programar desde su propia cola. Desde US$ 9 hasta US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Se puede programar un carrusel de Instagram a través de la API?

Sí, mediante una cola, ya que Meta publica un carrusel cuando se publica su contenedor. El publish_instagram_post de easyCoexistence acepta scheduled_at, de 1 minuto a 90 días de antelación, para carruseles de 2 a 10 elementos.

¿Se puede etiquetar un carrusel como generado por IA?

Sí, con is_ai_generated en el contenedor del carrusel. Ponerlo en un elemento devuelve un error.

¿Puede un carrusel incluir un Reel?

No. Un Reel siempre se publica por separado, y los elementos del carrusel son simples contenedores de imagen o video.

¿Por qué mi carrusel falla con 2207028?

El mensaje de Meta para ese error indica que un carrusel necesita al menos 2 y no más de 10 elementos. Una cantidad de 2 a 10 cumple tanto ese mensaje como el límite de 20 de la guía de publicación, así que ajusta los elementos y vuelve a crear el contenedor del carrusel.

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