Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Reels e insights de vídeo do Facebook através da API

As métricas de vídeo e de Reels do Facebook vêm de GET /{video-id}/video_insights: total_video_views conta reproduções de pelo menos 3 segundos, total_video_avg_time_watched e total_video_view_total_time dão o tempo visto em milissegundos, e os Reels acrescentam blue_reels_play_count, fb_reels_total_plays e fb_reels_replay_count. A Meta descontinuou, em junho de 2026 para todas as versões da API, as métricas de impressões de vídeo e de espectadores únicos, como total_video_impressions.

O easyCoexistence lê os insights de Páginas e publicações do Facebook com get_social_insights a partir do Claude, do ChatGPT ou do seu próprio código, para que a sua IA possa dizer como estão a correr a Página e as suas publicações; os video_insights de um vídeo ou de um Reel leem-se no Meta Business Suite.

3 seconds

A reprodução mais curta que total_video_views conta, ou quase a duração toda nos vídeos mais curtos do que essa.

June 2026

Quando a Meta descontinuou total_video_impressions, total_video_views_unique e post_video_views_unique para todas as versões da API.

2 years

Até quando estão disponíveis os dados de insights de vídeo.

40 intervals

Como total_video_retention_graph divide um vídeo, indicando as reproduções em cada ponto como percentagem do total de visualizações.

1 ms

A reprodução que conta como reprodução de Reel em blue_reels_play_count, sem incluir as repetições.

Reels left out

As interações nos Reels não estão incluídas nas métricas da Página, entre as limitações da referência de insights da Meta.

Que métricas devolve video_insights para um vídeo?

Estas métricas de vídeo estão na referência da Meta e fora das listas de descontinuação a novembro de 2026, todas como totais acumulados lidos pelo ID do vídeo. As visualizações não incluem o tempo passado a repetir dentro de uma mesma reprodução, e várias têm versões orgânicas e pagas, como total_video_views_organic e 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

Que métricas cobrem os Reels?

A referência da Meta tem uma secção para os Reels, lida pelo ID de vídeo do Reel, com valores acumulados:

  • blue_reels_play_count: reproduções de 1 milissegundo ou mais depois de contada uma impressão, sem as repetições.
  • fb_reels_total_plays: as mesmas reproduções com as repetições incluídas; fb_reels_replay_count: apenas as repetições na mesma sessão.
  • post_video_avg_time_watched e post_video_view_time: média e total de milissegundos reproduzidos, com as repetições incluídas.
  • post_video_followers: seguidores obtidos a partir do Reel.
  • post_video_likes_by_reaction_type: gostos no Reel.
  • post_video_social_actions: os comentários e partilhas.
  • post_video_retention_graph: reproduções em pontos ao longo do Reel, como percentagem do total de reproduções.

Que métricas de vídeo a Meta descontinuou em 2026?

O anúncio da versão 25 da Graph API da Meta descontinuou dois grupos em junho de 2026 para todas as versões da API e aponta para as suas métricas Media Views e Media Viewers em vez disso: post_total_media_view_unique e page_total_media_view_unique para espectadores únicos, e post_media_view e page_media_view para as divisões pagas e orgânicas.

  • Impressões de vídeo: total_video_impressions com as suas variantes únicas, pagas, orgânicas, virais e de fãs, e post_impressions_unique num vídeo.
  • Espectadores de 3 segundos: total_video_views_unique e as suas versões orgânicas e pagas, post_video_views_unique e as suas versões orgânicas e pagas, e page_video_views_unique.

post_video_views e page_video_views continuam válidas?

Sim. Ambas permanecem na referência de insights da Meta sem marca de descontinuação: post_video_views conta as reproduções de pelo menos 3 segundos de uma publicação de vídeo, por total acumulado ou por dia, e page_video_views conta as da Página, por dia, semana ou days_28. As suas versões únicas, post_video_views_unique e page_video_views_unique, foram descontinuadas em junho de 2026 para todas as versões da API, e as métricas de 10 segundos, como post_video_views_10s, acima da v18.

Como se pedem os insights de vídeo?

Em três objetos, cada um com as suas métricas. GET /{video-id}/video_insights com metric definido como uma lista separada por vírgulas lê um vídeo ou um Reel, e sem metric devolve os totais do vídeo. As métricas de vídeo ao nível da publicação, como post_video_views, lêem-se com GET /{page-post-id}/insights, e as ao nível da Página, como page_video_views, com GET /{page-id}/insights e um 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

Que permissões e tarefa são necessárias?

Um token de Página de alguém que possa executar a tarefa ANALYZE na Página. A referência de video_insights da Meta indica read_insights e pages_manage_engagement, enquanto o guia de insights de vídeo indica pages_read_engagement. Os dados cobrem os últimos 2 anos, os insights de vídeos em utilizadores ou grupos não estão disponíveis, e um vídeo publicado em várias Páginas tem um ID de vídeo diferente em cada uma delas.

As métricas da Página incluem os Reels?

Não. A referência de insights da Meta indica, entre as limitações para ler as métricas da Página, que as interações nos Reels não estão incluídas. As reproduções, seguidores, comentários e partilhas de um Reel lêem-se no próprio Reel, através de video_insights com o seu ID de vídeo.

Como é que o easyCoexistence as lê?

get_social_insights lê o edge insights da Página ou de uma publicação: métricas, um período e object_id para uma publicação, com parâmetros extra como since e until transmitidos. video_insights é um edge próprio, que nenhuma tool lê, por isso as métricas próprias de um vídeo ou de um Reel leem-se no Meta Business Suite. Uma métrica retirada devolve o erro da Meta, para que a sua IA possa trocar o nome.

Erros comuns

  • Pedir total_video_impressions. A Meta descontinuou as métricas de impressões de vídeo em junho de 2026; peça antes as suas métricas Media Views, como post_media_view.
  • Somar os valores do gráfico de retenção. São percentagens das visualizações em cada intervalo, não contagens de reproduções.
  • Procurar Reels nos totais da Página. Os insights da Página da Meta deixam de fora as interações nos Reels, por isso leia o video_insights de cada Reel.
  • Ler o tempo visto em segundos. total_video_avg_time_watched, total_video_view_total_time e post_video_view_time estão em milissegundos.
Fazer isto com a EasyCoexistence

Entre US$ 9 e US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Que substituiu total_video_views_unique?

A Meta aponta para as suas métricas Media Viewers: post_total_media_view_unique na publicação, e page_total_media_view_unique para a Página.

Como obtenho as reproduções de um Reel através da API?

Leia blue_reels_play_count, ou fb_reels_total_plays para incluir as repetições, a partir de GET /{video-id}/video_insights com o ID de vídeo devolvido pela chamada de início do Reel.

post_impressions_unique ainda funciona nos Reels?

Não. A tabela de Reels da Meta ainda a indica, mas o anúncio da v25 a descontinuou em video_insights em junho de 2026; post_total_media_view_unique conta os espectadores únicos da publicação.

Que vídeos não têm insights?

Os vídeos publicados em utilizadores ou grupos. Os insights de vídeo da Meta cobrem vídeos em Páginas, com dados dos últimos 2 anos.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em