Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

API de Reels de Facebook: publicar Reels en una Página

La API de Reels de Facebook publica un Reel en una Página en tres pasos: POST /{page-id}/video_reels con upload_phase start devuelve un video_id, el video se envía a rupload.facebook.com y POST /{page-id}/video_reels con upload_phase finish y video_state PUBLISHED lo publica. La especificación de Meta es un video 9:16 de 3 a 90 segundos, y una Página puede publicar 30 Reels por la API en 24 horas.

easyCoexistence publica videos en una Página de Facebook como publicaciones de video normales con publish_facebook_post, desde Claude, ChatGPT o tu propio código, junto con texto, enlaces y fotos.

30 a day

Reels publicados por la API por Página en un periodo móvil de 24 horas, aplicado en POST /{page_id}/video_reels.

3 to 90 s

Duración de Reel que acepta Meta; un Reel publicado como historia en una Página no puede superar los 60 segundos.

540 x 960

Resolución mínima de Reel; Meta recomienda 1080 x 1920 píxeles con una relación de aspecto de 9 x 16.

29 days

Máxima anticipación que scheduled_publish_time puede fijar para un Reel, de al menos 10 minutos, con video_state SCHEDULED.

1363128

Código de error para un Reel cuya duración Facebook no admite; los Reels deben durar de 3 a 90 segundos.

¿Cómo publica la API de Reels un Reel?

En tres pasos y entre dos hosts. Las llamadas de inicio y cierre van al edge video_reels de la Página en graph.facebook.com, mientras que el video en sí va a rupload.facebook.com, a la upload_url que devuelve la llamada de inicio. Una consulta de estado sobre el ID del video, entre la subida y el cierre, muestra si Meta tiene el archivo completo y lo ha procesado.

1StartPOST /{page-id}/video_reels, upload_phase start: returns video_id and upload_url
2UploadPOST to rupload.facebook.com with the bytes or a file_url header
3CheckGET /{video-id}?fields=status until processing completes
4FinishPOST /{page-id}/video_reels, upload_phase finish, video_state PUBLISHED

¿Qué video necesita un Reel?

Meta publica sus especificaciones de Reels en la guía Reels Publishing, y una subida que no cumpla con la relación de aspecto, la resolución, la duración o la frecuencia de fotogramas se rechaza con un código de error propio. Un Reel destinado a la historia de una Página también debe mantenerse dentro de 60 segundos.

File.mp4 recommended
Aspect ratio9 x 16
Resolution1080 x 1920 recommended, 540 x 960 at least
Frame rate24 to 60 fps, fixed, progressive scan
Duration3 to 90 seconds
VideoH.264 or H.265 (VP9 and AV1 also supported), 4:2:0, closed GOP of 2 to 5 s
AudioAAC Low Complexity, 48 kHz, stereo, 128 kbps or more

¿Cómo se sube el video?

Con un POST a la upload_url en rupload.facebook.com, enviando el token de Página en un encabezado Authorization: OAuth. Un archivo en tu equipo va como cuerpo de la petición, con el encabezado offset en 0 y file_size con su tamaño en bytes. Un archivo ya en línea se envía en cambio con un encabezado file_url, y Meta lo descarga; una subida correcta devuelve success con valor true.

  • file_url acepta direcciones http o https; las URL que requieren autenticación no son compatibles.
  • El host debe permitir que el user agent facebookexternalhit/1.1 descargue el archivo, ya que Meta rechaza archivos de sitios que lo bloquean en robots.txt.
  • Los archivos de la propia CDN de Meta, como las URL de fbcdn, se rechazan; Meta sugiere hacer crossposting para reutilizar un video en otra Página.
Uploading a hosted video
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
  -H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
  -H "file_url: https://example.com/reel.mp4"

¿Cómo se consulta el estado de un Reel?

Con GET /{video-id}?fields=status en graph.facebook.com. La respuesta incluye video_status, que puede ser uploading, upload_complete, processing, ready, upload_failed, expired o error, y un objeto por fase: uploading_phase con bytes_transfered, processing_phase con cualquier mensaje de error y publishing_phase con publish_status (draft, scheduled, published o error) y publish_time. El estado de cada fase es not_started, in_progress, completed o error.

¿Cómo se reanuda una subida interrumpida?

Enviando de nuevo el POST de subida con el encabezado offset igual a uploading_phase.bytes_transfered de una consulta de estado, es decir, los bytes que Meta ya tiene. Un offset que Meta no acepta devuelve OffsetInvalidError, un cuerpo que no coincide con la longitud del archivo devuelve PartialRequestError, y cuando volver a subir no funciona, Meta recomienda empezar de nuevo desde el primer paso.

¿Qué recibe la llamada de cierre?

El video_id de la llamada de inicio, upload_phase con finish y video_state con PUBLISHED, DRAFT o SCHEDULED. description lleva el texto y admite hashtags. title, place (para una Página de ubicación) e is_ai_generated, que indica que el Reel se creó o editó con IA, son opcionales. Un Reel programado añade scheduled_publish_time, una marca de tiempo UNIX con más de 10 minutos y dentro de 29 días de anticipación. Meta responde con success en true.

¿Cuántos Reels puede publicar una Página por la API?

30 en un periodo móvil de 24 horas. Meta aplica el límite en POST /{page_id}/video_reels cuando se publica un Reel y recomienda que las apps también lo apliquen por su cuenta, sobre todo las que permiten programar publicaciones para más adelante. Las invitaciones de colaboradores tienen un límite propio, de 10 por Página cada 24 horas, y la referencia de video_reels indica el error 613, las llamadas a esta API han superado el límite de tasa.

¿Qué permisos y tarea de Página necesita?

Un token de acceso de Página de alguien que pueda realizar la tarea CREATE_CONTENT en la Página, con pages_show_list, pages_read_engagement y pages_manage_posts concedidos mediante Facebook Login. Meta también pide que las apps muestren a la persona una advertencia sobre cómo se usan sus Reels en Facebook, con opciones para controlarlo, y que ofrezcan solo la audiencia Pública, ya que publicar en una Página tiene un alcance público implícito.

¿Qué errores devuelve la API de Reels?

El código 100 significa que falta un parámetro obligatorio, como upload_phase, y el mensaje de Meta enumera los que faltan. Otros cuatro códigos rechazan un video que queda fuera de las especificaciones:

  • 1363040: la relación de aspecto no es compatible; los videos deben estar entre 16x9 y 9x16.
  • 1363127: la resolución no es compatible; el mínimo es 540 x 960 píxeles.
  • 1363128: la duración no es compatible; los Reels duran de 3 a 90 segundos.
  • 1363129: la frecuencia media de fotogramas no es compatible; los Reels necesitan de 24 a 60 fotogramas por segundo.

¿Cómo se listan los Reels de una Página?

Con GET /{page-id}/video_reels, que devuelve los Reels publicados de la Página con sus ID, fechas de actualización y descripciones. since y until acotan la lista a fechas indicadas como today, yesterday, una marca de tiempo UNIX o yyyy-mm-dd, siendo until posterior a since. La referencia del feed de Meta apunta a este edge para los Reels publicados en una Página.

¿Cómo se publica un Reel desde easyCoexistence?

Hoy no como Reel. publish_facebook_post envía los videos al edge de videos de la Página, como publicaciones de video normales, y easyCoexistence no tiene ninguna herramienta para las llamadas de video_reels; los tokens de Página no se entregan, así que los tres pasos tampoco pueden ejecutarse desde tu propio código en su conexión. Publica el Reel desde Facebook o Meta Business Suite, o publica el video como una publicación de video normal.

Errores comunes

  • Enviar la subida a graph.facebook.com. El video va a rupload.facebook.com con un encabezado Authorization: OAuth; solo las llamadas de inicio, cierre y estado usan graph.facebook.com.
  • Alojar el archivo donde Meta no puede descargarlo. Un file_url detrás de un inicio de sesión, en un sitio cuyo robots.txt bloquea facebookexternalhit/1.1 o en fbcdn se rechaza.
  • Empezar de nuevo tras una subida interrumpida. Consulta primero el estado: uploading_phase.bytes_transfered es el offset desde el que reanudar, y una sesión nueva es el último recurso.
  • Poner en cola más de 30 Reels para una Página en un día. Meta cuenta los Reels publicados por la API en un periodo móvil de 24 horas, así que reparte los programados.
Hacerlo con EasyCoexistence

No tiene ninguna herramienta para la API de Reels, así que un Reel se publica desde Facebook o Meta Business Suite. De US$ 9 a 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 publicar un Reel en un perfil o grupo de Facebook por la API?

No. La API de publicación de Reels de Meta publica Reels en Páginas de Facebook, y solo hace crossposting hacia otras Páginas.

¿publish_facebook_post publica Reels?

No. Publica texto, enlaces, fotos y videos en la Página. Un Reel usa las llamadas de video_reels, que las herramientas de easyCoexistence no hacen.

¿Cómo reviso un Reel en busca de coincidencias de derechos de autor?

Lee GET /{video-id}?fields=copyright_check_information con pages_read_engagement. Meta hace la comprobación al subir, puede tardar un par de minutos, y solo el propietario ve las coincidencias.

¿Otra Página puede publicar también mi Reel?

Sí, como colaborador. POST /{video-id}/collaborators con target_id igual al ID de su Página envía una invitación, y cuando la acepta, el Reel aparece también en su Página.

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