Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Publicar Reels de Instagram con la API

La API de Instagram publica un Reel a partir de un archivo MOV o MP4 alojado en una URL pública: se crea un contenedor con media_type REELS, se espera mientras Meta procesa el video y luego se publica. Un Reel dura de 3 segundos a 15 minutos y pesa hasta 300 MB, y Meta recomienda un formato 9:16 para evitar recortes o espacios en blanco.

easyCoexistence publica Reels con publish_instagram_post desde Claude, ChatGPT o tu propio código: le das la URL del video y la descripción, y si el video todavía se está procesando, termina de publicar por sí sola.

15 min

El Reel más largo que publica la API; el más corto dura 3 segundos.

300 MB

Tamaño máximo de archivo de un Reel, en MOV o MP4 con video H.264 o HEVC y audio AAC.

1 min

Cada cuánto sugiere Meta consultar el estado de un contenedor en procesamiento, durante no más de 5 minutos.

24 hours

Cuánto tiempo puede esperar sin publicarse un contenedor de Reel antes de expirar.

¿Cómo se publica un Reel?

En tres pasos. Primero, una petición POST a /<IG_ID>/media con media_type en REELS, video_url apuntando al archivo y, si se quiere, una descripción (caption); Meta descarga el video y devuelve un ID de contenedor. Segundo, se espera mientras Instagram procesa el video, consultando el status_code del contenedor. Tercero, una petición POST a /<IG_ID>/media_publish con creation_id igual al ID del contenedor, y la respuesta incluye el ID del nuevo contenido.

Meta documenta su carga reanudable, que permite enviar un archivo desde una computadora, solo para las configuraciones basadas en Facebook Login for Business, incluido Unified Login. Con Instagram Login, el video siempre se obtiene de una URL pública.

¿Qué requisitos debe cumplir el video?

La especificación de Meta para Reels, que un archivo debe cumplir para que Instagram lo procese:

  • Contenedor: MOV o MP4 (MPEG-4 Parte 14), sin listas de edición y con el átomo moov al principio del archivo.
  • Video: H.264 o HEVC, escaneo progresivo, GOP cerrado, submuestreo de croma 4:2:0, de 23 a 60 fotogramas por segundo, hasta 1920 píxeles de ancho y 25 Mbps.
  • Audio: AAC, hasta 48 kHz, mono o estéreo, a 128 kbps.
  • Relación de aspecto: cualquiera entre 0.01:1 y 10:1, con 9:16 como recomendada.
  • Duración y tamaño: de 3 segundos a 15 minutos, hasta 300 MB.

¿Qué ocurre mientras se procesa el video?

El status_code del contenedor indica IN_PROGRESS hasta que Instagram termina de procesar el video, después FINISHED, y solo entonces se puede publicar. Si se publica antes, la llamada falla con el código 9007, subcódigo 2207027, lo que indica que hay que esperar, no corregir nada. Meta sugiere consultar el estado una vez por minuto durante no más de 5 minutos.

ERROR significa que el contenedor no pudo completar el procesamiento, y EXPIRED, que pasó 24 horas sin publicarse; en ambos casos hace falta un contenedor nuevo. PUBLISHED significa que el Reel ya está publicado.

¿Qué opciones de Reel ofrece la API?

Además del video y la descripción, el contenedor de Reel de Meta acepta estos parámetros:

  • share_to_feed: true permite que el Reel aparezca en el Feed además de en la pestaña Reels; false lo deja solo en la pestaña Reels. Ninguno de los dos valores garantiza un lugar en la pestaña Reels.
  • cover_url: un JPEG de hasta 8 MB que se usa como portada en la pestaña Reels, recortado a la franja central 9:16, y a un cuadrado cuando se comparte en el Feed.
  • thumb_offset: el fotograma, en milisegundos, que se usa como miniatura cuando no hay portada; 0 es el primer fotograma.
  • audio_name: un nombre para el audio del Reel, que solo se puede definir una vez.
  • trial_params: publica un Reel de prueba, que se muestra solo a personas que no siguen la cuenta hasta que pasa a ser un Reel normal.

¿Qué otras reglas se aplican a un Reel?

Algunas reglas acompañan a un Reel desde el momento en que se crea su contenedor.

  • Un Reel no puede formar parte de un carrusel; siempre se publica por separado.
  • La configuración de privacidad de la cuenta se aplica al publicar: si Permitir remezclas está activado, el nuevo Reel también permite remezclas.
  • El etiquetado de música solo está disponible para audio original.
  • Al consultarlo después, un Reel devuelve media_type VIDEO, como cualquier otro video.
  • Cuenta como una de las 100 publicaciones por API que la cuenta puede hacer en 24 horas.

¿Qué métricas reporta un Reel?

A través del endpoint de insights de medios, un Reel reporta reach, views, likes, comments, saved, shares, total_interactions y reposts, además de tres métricas propias: ig_reels_avg_watch_time, ig_reels_video_view_total_time y reels_skip_rate, la proporción de reproducciones que se saltaron en los primeros 3 segundos. Likes, comments y views cuentan solo la actividad orgánica, y los datos en los que se basan pueden tardar hasta 48 horas en actualizarse.

Errores comunes

  • Publicar en cuanto se crea el contenedor. Espera a que status_code indique FINISHED, o la llamada fallará con el subcódigo 2207027.
  • Enviar un archivo WebM o AVI. Los Reels deben ser MOV o MP4; si no, Meta los rechaza con el código 352, subcódigo 2207026.
  • Esperar que share_to_feed ponga el Reel en la pestaña Reels. Solo lo añade al Feed; Instagram decide qué se muestra en la pestaña Reels.
  • Dejar un contenedor sin publicar de un día para otro. Expira 24 horas después de crearse, y para publicar hará falta uno nuevo.
Hacerlo con EasyCoexistence

Los Reels también se pueden programar desde su propia cola. De US$ 9 a US$ 0.75 por conexión al mes, un precio que baja a medida que agregas conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Cuánto puede durar un Reel publicado con la API?

De 3 segundos a 15 minutos, en un archivo MOV o MP4 de hasta 300 MB.

¿Puedo subir un Reel desde mi computadora?

No con Instagram Login. La API obtiene el video de una URL pública, así que primero sube el archivo a un lugar que le dé un enlace público.

¿Un Reel publicado con la API también aparece en el Feed?

Puede aparecer. El parámetro share_to_feed decide si el Reel puede mostrarse en el Feed además de en la pestaña Reels.

¿Por qué falla con el error 9007 al publicar un Reel?

Instagram todavía está procesando el video. Consulta el status_code del contenedor y publica cuando indique FINISHED; no hay nada que corregir en la petición.

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