Log inStart Free Trial
easyCoexistence Official APIs

Facebook Reels and video insights through the API

Facebook video and Reels insights come from GET /{video-id}/video_insights: total_video_views counts plays of at least 3 seconds, total_video_avg_time_watched and total_video_view_total_time give watch time in milliseconds, and Reels add blue_reels_play_count, fb_reels_total_plays and fb_reels_replay_count. Meta deprecated the video impression and unique-viewer metrics, such as total_video_impressions, in June 2026 for all API versions.

easyCoexistence reads Facebook Page and post insights with get_social_insights from Claude, ChatGPT or your own code, so your AI can say how the Page and its posts are doing; a video's or a Reel's own video_insights are read in Meta Business Suite.

3 seconds

Shortest play total_video_views counts, or nearly the full length for videos shorter than that.

June 2026

When Meta deprecated total_video_impressions, total_video_views_unique and post_video_views_unique for all API versions.

2 years

How far back video insights data is available.

40 intervals

How total_video_retention_graph divides a video, reporting plays at each as a percentage of all views.

1 ms

Playback that counts as a Reel play in blue_reels_play_count, which leaves replays out.

Reels left out

Interactions on Reels are not included in Page metrics, among the limitations in Meta's insights reference.

Which metrics does video_insights return for a video?

These video metrics are in Meta's reference and outside its deprecation lists as of November 2026, all lifetime totals read on the video's ID. Views leave out time spent replaying within one play, and several have organic and paid versions, such as total_video_views_organic and 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

Which metrics cover Reels?

Meta's reference has a Reels section, read on the Reel's video ID, with lifetime values:

  • blue_reels_play_count: plays of 1 millisecond or more after an impression is counted, replays left out.
  • fb_reels_total_plays: the same plays with replays included; fb_reels_replay_count: replays in the same session alone.
  • post_video_avg_time_watched and post_video_view_time: average and total milliseconds played, replays included.
  • post_video_followers: follows from the Reel.
  • post_video_likes_by_reaction_type: likes on the Reel.
  • post_video_social_actions: its comments and shares.
  • post_video_retention_graph: plays at points through the Reel, as a percentage of total plays.

Which video metrics did Meta deprecate in 2026?

Meta's Graph API v25 announcement deprecated two groups in June 2026 for all API versions and points to its Media Views and Media Viewers metrics instead: post_total_media_view_unique and page_total_media_view_unique for unique viewers, and post_media_view and page_media_view for paid and organic splits.

  • Video impressions: total_video_impressions with its unique, paid, organic, viral and fan variants, and post_impressions_unique on a video.
  • 3-second viewers: total_video_views_unique and its organic and paid versions, post_video_views_unique and its organic and paid versions, and page_video_views_unique.

Are post_video_views and page_video_views still valid?

Yes. Both stay in Meta's insights reference without a deprecation mark: post_video_views counts a video post's plays of at least 3 seconds, by lifetime or day, and page_video_views counts the Page's, by day, week or days_28. Their unique versions, post_video_views_unique and page_video_views_unique, were deprecated in June 2026 for all API versions, and the 10-second metrics, such as post_video_views_10s, above v18.

How are video insights requested?

On three objects, each with its own metrics. GET /{video-id}/video_insights with metric set to a comma-separated list reads a video or a Reel, and without metric it returns the video's totals. Post-level video metrics such as post_video_views are read with GET /{page-post-id}/insights, and Page-level ones such as page_video_views with GET /{page-id}/insights and a 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

Which permissions and task does it need?

A Page token from someone who can perform the ANALYZE task on the Page. Meta's video_insights reference names read_insights and pages_manage_engagement, while its video insights guide names pages_read_engagement. Data covers the past 2 years, insights for videos on users or groups are not available, and a crossposted video has a separate video ID on each Page it was posted to.

Do Page-level metrics include Reels?

No. Meta's insights reference lists, among its limitations for reading Page metrics, that interactions on Reels are not included. A Reel's plays, follows, comments and shares are read on the Reel itself, through video_insights with its video ID.

How does easyCoexistence read them?

get_social_insights reads the insights edge of the Page or of one post: metrics, a period, and object_id for a post, with extra parameters such as since and until passed through. video_insights is an edge of its own, which no tool reads, so a video's or a Reel's own metrics are read in Meta Business Suite. A retired metric comes back as Meta's error, so your AI can switch names.

Common mistakes

  • Requesting total_video_impressions. Meta deprecated the video impression metrics in June 2026; ask for its Media Views metrics, such as post_media_view, instead.
  • Summing retention graph values. They are percentages of views at each interval, not counts of plays.
  • Looking for Reels in Page totals. Meta's Page insights leave interactions on Reels out, so read each Reel's own video_insights.
  • Reading watch time as seconds. total_video_avg_time_watched, total_video_view_total_time and post_video_view_time are in milliseconds.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

What replaced total_video_views_unique?

Meta points to its Media Viewers metrics: post_total_media_view_unique on the post, and page_total_media_view_unique for the Page.

How do I get a Reel's plays through the API?

Read blue_reels_play_count, or fb_reels_total_plays to include replays, from GET /{video-id}/video_insights with the video ID the Reel's start call returned.

Does post_impressions_unique still work for Reels?

No. Meta's Reels table still lists it, but the v25 announcement deprecated it on video_insights in June 2026; post_total_media_view_unique counts unique viewers on the post.

Which videos have no insights?

Videos published on users or groups. Meta's video insights cover videos on Pages, with data for the past 2 years.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on