Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Reels de Facebook y métricas de video mediante la API

Las métricas de video y Reels de Facebook provienen de GET /{video-id}/video_insights: total_video_views cuenta reproducciones de al menos 3 segundos, total_video_avg_time_watched y total_video_view_total_time dan el tiempo de visualización en milisegundos, y los Reels añaden blue_reels_play_count, fb_reels_total_plays y fb_reels_replay_count. En junio de 2026, Meta retiró para todas las versiones de la API las métricas de impresiones de video y de espectadores únicos, como total_video_impressions.

easyCoexistence lee los insights de Page y de publicaciones de Facebook con get_social_insights desde Claude, ChatGPT o tu propio código, para que tu IA pueda decir cómo van la Page y sus publicaciones; los video_insights propios de un video o de un Reel se leen en Meta Business Suite.

3 seconds

La reproducción más corta que cuenta en total_video_views, o casi toda la duración en videos más cortos que eso.

June 2026

Cuando Meta retiró total_video_impressions, total_video_views_unique y post_video_views_unique para todas las versiones de la API.

2 years

Hasta dónde llegan hacia atrás los datos de insights de video.

40 intervals

Cómo total_video_retention_graph divide un video, informando las reproducciones en cada punto como porcentaje de todas las vistas.

1 ms

La reproducción que cuenta como Reel en blue_reels_play_count, que deja fuera las repeticiones.

Reels left out

Las interacciones en Reels no se incluyen en las métricas de Page, entre las limitaciones de la referencia de insights de Meta.

¿Qué métricas devuelve video_insights para un video?

Estas métricas de video están en la referencia de Meta y fuera de sus listas de métricas en desuso a noviembre de 2026; todas son totales históricos consultados con el ID del video. Las vistas no incluyen el tiempo dedicado a repetir dentro de una misma reproducción, y varias tienen versiones orgánicas y pagadas, como total_video_views_organic y total_video_views_paid:

total_video_viewsPlays of at least 3 seconds, or nearly the full length if shorter
total_video_complete_viewsPlays of 97% or more of the length
total_video_15s_viewsPlays of 15 seconds or more
total_video_60s_excludes_shorter_viewsPlays of 60 seconds or more
total_video_avg_time_watchedAverage viewing time, in milliseconds
total_video_view_total_timeTotal viewing time, in milliseconds
total_video_retention_graphPlays at each of 40 intervals, as a percentage of views
total_video_reactions_by_type_totalReactions to the video, by type

¿Qué métricas cubren los Reels?

La referencia de Meta tiene una sección de Reels, que se consulta con el ID de video del Reel, con valores históricos:

  • blue_reels_play_count: reproducciones de 1 milisegundo o más después de contar una impresión, sin repeticiones.
  • fb_reels_total_plays: las mismas reproducciones con las repeticiones incluidas; fb_reels_replay_count: solo las repeticiones dentro de la misma sesión.
  • post_video_avg_time_watched y post_video_view_time: promedio y total de milisegundos reproducidos, con repeticiones incluidas.
  • post_video_followers: seguidores obtenidos desde el Reel.
  • post_video_likes_by_reaction_type: me gusta del Reel.
  • post_video_social_actions: sus comentarios y compartidos.
  • post_video_retention_graph: reproducciones en puntos a lo largo del Reel, como porcentaje de las reproducciones totales.

¿Qué métricas de video retiró Meta en 2026?

El anuncio de Meta de la API Graph v25 retiró en junio de 2026 dos grupos, para todas las versiones de la API, y remite a sus métricas Media Views y Media Viewers: post_total_media_view_unique y page_total_media_view_unique para espectadores únicos, y post_media_view y page_media_view para las divisiones pagadas y orgánicas.

  • Impresiones de video: total_video_impressions con sus variantes únicas, pagadas, orgánicas, virales y de fans, y post_impressions_unique en un video.
  • Espectadores de 3 segundos: total_video_views_unique y sus versiones orgánicas y pagadas, post_video_views_unique y sus versiones orgánicas y pagadas, y page_video_views_unique.

¿Siguen siendo válidos post_video_views y page_video_views?

Sí. Ambas siguen en la referencia de insights de Meta sin marca de desuso: post_video_views cuenta las reproducciones de al menos 3 segundos de una publicación de video, por historial o por día, y page_video_views cuenta las de la Page, por día, semana o days_28. Sus versiones únicas, post_video_views_unique y page_video_views_unique, quedaron obsoletas en junio de 2026 para todas las versiones de la API, y las métricas de 10 segundos, como post_video_views_10s, por encima de la v18.

¿Cómo se solicitan los insights de video?

En tres objetos, cada uno con sus propias métricas. GET /{video-id}/video_insights con metric como lista separada por comas lee un video o un Reel, y sin metric devuelve los totales del video. Las métricas de video a nivel de publicación, como post_video_views, se leen con GET /{page-post-id}/insights, y las de nivel de Page, como page_video_views, con GET /{page-id}/insights y un parámetro period.

Reading a video's views and watch time
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graph

¿Qué permisos y tarea necesita?

Un token de Page de alguien que pueda realizar la tarea ANALYZE sobre la Page. La referencia de video_insights de Meta menciona read_insights y pages_manage_engagement, mientras que su guía de insights de video menciona pages_read_engagement. Los datos cubren los últimos 2 años, no hay insights para videos de usuarios o grupos, y un video publicado en varias Pages tiene un ID de video distinto en cada una.

¿Las métricas a nivel de Page incluyen los Reels?

No. La referencia de insights de Meta indica, entre sus limitaciones para leer métricas de Page, que las interacciones en Reels no se incluyen. Las reproducciones, seguidores, comentarios y compartidos de un Reel se leen en el propio Reel, mediante video_insights con su ID de video.

¿Cómo lee easyCoexistence estos datos?

get_social_insights lee el edge de insights de la Page o de una publicación: metrics, un period y object_id para una publicación, y pasa parámetros adicionales como since y until. video_insights es un edge propio, que ninguna herramienta lee, así que las métricas propias de un video o de un Reel se leen en Meta Business Suite. Una métrica retirada devuelve el error de Meta, para que tu IA pueda cambiar el nombre.

Errores comunes

  • Pedir total_video_impressions. Meta retiró las métricas de impresiones de video en junio de 2026; pide en su lugar sus métricas Media Views, como post_media_view.
  • Sumar los valores del gráfico de retención. Son porcentajes de las vistas en cada intervalo, no conteos de reproducciones.
  • Buscar Reels en los totales de Page. Los insights de Page dejan fuera las interacciones en Reels, así que lee el video_insights de cada Reel.
  • Leer el tiempo de visualización en segundos. total_video_avg_time_watched, total_video_view_total_time y post_video_view_time están en milisegundos.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que agregas conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Qué reemplazó a total_video_views_unique?

Meta remite a sus métricas Media Viewers: post_total_media_view_unique en la publicación, y page_total_media_view_unique para la Page.

¿Cómo obtengo las reproducciones de un Reel por la API?

Lee blue_reels_play_count, o fb_reels_total_plays para incluir las repeticiones, desde GET /{video-id}/video_insights con el ID de video que devolvió la llamada de inicio del Reel.

¿post_impressions_unique sigue funcionando en los Reels?

No. La tabla de Reels de Meta todavía lo lista, pero el anuncio de la v25 lo retiró de video_insights en junio de 2026; post_total_media_view_unique cuenta los espectadores únicos de la publicación.

¿Qué videos no tienen insights?

Los videos publicados en usuarios o grupos. Los insights de video de Meta cubren los videos de Pages, con datos de los últimos 2 años.

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