EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Reels e insights de vídeo do Facebook pela API

Os insights de vídeo e 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 informam o tempo assistido 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ão 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, usando o Claude, o ChatGPT ou seu próprio código, para que sua IA possa dizer como a Página e suas publicações estão indo; os video_insights próprios de um vídeo ou de um Reel são lidos no Meta Business Suite.

3 seconds

A reprodução mais curta que total_video_views conta, ou quase a duração total para vídeos menores que isso.

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é que ponto os dados de insights de vídeo estão disponíveis.

40 intervals

Como total_video_retention_graph divide um vídeo, informando as reproduções em cada ponto como porcentagem de todas as visualizações.

1 ms

A reprodução que conta como Reel em blue_reels_play_count, sem incluir os replays.

Reels left out

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

Quais métricas o video_insights retorna para um vídeo?

Essas métricas de vídeo constam na referência da Meta e fora das listas de descontinuação a partir de novembro de 2026, todas como totais acumulados lidos pelo ID do vídeo. As visualizações não contam o tempo de replay 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

Quais métricas cobrem os Reels?

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

  • blue_reels_play_count: reproduções de 1 milissegundo ou mais depois que uma impressão é contada, sem os replays.
  • fb_reels_total_plays: as mesmas reproduções com os replays incluídos; fb_reels_replay_count: somente os replays na mesma sessão.
  • post_video_avg_time_watched e post_video_view_time: média e total de milissegundos reproduzidos, com replays incluídos.
  • post_video_followers: seguidores obtidos pelo Reel.
  • post_video_likes_by_reaction_type: curtidas no Reel.
  • post_video_social_actions: seus comentários e compartilhamentos.
  • post_video_retention_graph: reproduções em pontos ao longo do Reel, como porcentagem do total de reproduções.

Quais métricas foram descontinuadas pela Meta 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 suas métricas Media Views e Media Viewers no lugar: 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 suas variantes únicas, pagas, orgânicas, virais e de fãs, e post_impressions_unique em um vídeo.
  • Espectadores de 3 segundos: total_video_views_unique e suas versões orgânicas e pagas, post_video_views_unique e suas versões orgânicas e pagas, e page_video_views_unique.

post_video_views e page_video_views ainda são válidas?

Sim. As duas 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. 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 os insights de vídeo são solicitados?

Em três objetos, cada um com suas próprias 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 retorna os totais do vídeo. As métricas de vídeo no nível da publicação, como post_video_views, são lidas com GET /{page-post-id}/insights, e as no 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

Quais 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 cita read_insights e pages_manage_engagement, enquanto o guia de insights de vídeo cita pages_read_engagement. Os dados cobrem os últimos 2 anos, insights de vídeos de usuários ou grupos não estão disponíveis, e um vídeo com crossposting tem um ID separado em cada Página onde foi publicado.

As métricas no nível da Página incluem os Reels?

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

Como o easyCoexistence lê essas métricas?

get_social_insights lê o endpoint insights da Página ou de uma publicação: metrics, um period e object_id para uma publicação, com parâmetros extras como since e until repassados. video_insights é um endpoint próprio, que nenhuma ferramenta lê, então as métricas próprias de um vídeo ou de um Reel são lidas no Meta Business Suite. Uma métrica descontinuada volta como erro da Meta, para que sua IA possa trocar o nome.

Erros comuns

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

De US$ 9 a US$ 0.75 por número conectado por mês, caindo conforme você adiciona números, com os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

O que substituiu total_video_views_unique?

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

Como pego as reproduções de um Reel pela API?

Leia blue_reels_play_count, ou fb_reels_total_plays para incluir os replays, em GET /{video-id}/video_insights com o ID de vídeo que a chamada de início do Reel retornou.

post_impressions_unique ainda funciona para Reels?

Não. A tabela de Reels da Meta ainda a lista, 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.

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

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

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

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

Verificado em