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.
A reprodução mais curta que total_video_views conta, ou quase a duração toda nos vídeos mais curtos do que essa.
Quando a Meta descontinuou total_video_impressions, total_video_views_unique e post_video_views_unique para todas as versões da API.
Até quando estão disponíveis os dados de insights de vídeo.
Como total_video_retention_graph divide um vídeo, indicando as reproduções em cada ponto como percentagem do total de visualizações.
A reprodução que conta como reprodução de Reel em blue_reels_play_count, sem incluir as repetições.
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:
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_watchedepost_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_impressionscom as suas variantes únicas, pagas, orgânicas, virais e de fãs, epost_impressions_uniquenum vídeo. - Espectadores de 3 segundos:
total_video_views_uniquee as suas versões orgânicas e pagas,post_video_views_uniquee as suas versões orgânicas e pagas, epage_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.
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graphQue 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.
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