Log inStart Free Trial
easyCoexistence Official APIs

Facebook post insights through the API: views, reach and engagement

Facebook post insights come from GET /{page-post-id}/insights with metrics such as post_media_view, the times the post was played or displayed, post_total_media_view_unique, its unique viewers, post_clicks and post_reactions_by_type_total. Meta deprecated post_impressions in November 2025 and post_impressions_unique in June 2026, so views and unique viewers now stand in for impressions and reach.

easyCoexistence reads Facebook post insights with get_social_insights, so Claude, ChatGPT or your own code can ask how a post did and get Meta's current views, unique viewers, clicks and reactions back, with list_social_posts to find the post.

post_total_media_view_unique

Meta's recommended replacement for post_impressions_unique, whose deprecation for all API versions it set for June 2026.

15 Nov 2025

When post_impressions stopped returning data in all versions; Meta names post_media_view as its alternative.

lifetime

The period Meta lists for post metrics such as post_media_view, post_clicks and the reaction totals.

Like + care

What Meta's like reaction counts include: both like and care reactions.

Empty dataset

What Meta returns, instead of an error, when the app lacks the read_insights permission.

Which post metrics work in 2026?

These are in Meta's insights reference and outside its deprecation lists as of November 1, 2026. Each is read on the post's ID, with period lifetime unless noted:

  • post_media_view: times the post was played or displayed, with is_from_ads and is_from_followers breakdowns.
  • post_total_media_view_unique: the post's unique viewers, Meta's replacement for reach.
  • post_clicks: clicks anywhere in the post that did not generate a story; post_clicks_by_type splits them by consumption type.
  • post_reactions_by_type_total: reactions by type, plus one total per type such as post_reactions_love_total or post_reactions_anger_total.
  • post_video_views: plays of a video for at least 3 seconds, with period lifetime or day.

What replaced post impressions and reach?

Meta moved post measurement from impressions to media views in two rounds, each for all API versions at once, and a retired name now returns an invalid metric error. Its changelog, its deprecated metrics page and its Graph API v25 notes give these alternatives:

DeprecatedUse instead
Nov 15, 2025post_impressionspost_media_view
Nov 15, 2025post_impressions_paidpost_media_view with is_from_ads
Nov 15, 2025post_impressions_fanpost_media_view with is_from_followers
June 2026post_impressions_uniquepost_total_media_view_unique
June 2026post_impressions_paid_unique, post_impressions_organic_uniquepost_media_view breakdowns, which count views rather than people

What is the difference between views and unique viewers?

Views count displays, unique viewers count people. post_media_view adds up each time the post was played or displayed, so one person seeing it twice counts twice, while post_total_media_view_unique counts the post's unique viewers once each. Meta marks metrics ending in _unique as approximate and calculates unique values independently, so a total need not equal the sum of its parts.

How do you request a post's insights?

With GET /{page-post-id}/insights and metric set to a comma-separated list, or GET /{page-post-id}/insights/{metric} for one. The token has to come from someone who can perform the ANALYZE task on the Page, with read_insights and pages_read_engagement granted, and each result carries name, period, values, title and description. Meta's own example asks for reaction totals:

Meta's example request and response for one post, trimmed
GET /{page-post-id}/insights?metric=post_reactions_like_total,post_reactions_love_total

{
  "data": [
    {
      "name": "post_reactions_like_total",
      "period": "lifetime",
      "values": [{ "value": 226 }],
      "title": "Lifetime Total Like Reactions of a post.",
      "id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
    },
    {
      "name": "post_reactions_love_total",
      "period": "lifetime",
      "values": [{ "value": 17 }],
      "title": "Lifetime Total Love Reactions of a post.",
      "id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
    }
  ]
}

How do you count reactions, comments and shares?

From the post's own fields, beside its insights. fields=reactions.summary(total_count) returns the total reactions, and reactions.type(LOVE).limit(0).summary(total_count) the count of one type, from LIKE, LOVE, WOW, HAHA, SORRY and ANGRY. The shares field holds the share count, which Meta says may include deleted posts and posts the token cannot see, and the comments edge with summary=true adds a total_count.

How do post metrics relate to Page metrics?

Page metrics add up the Page's content over a period, while post metrics give one post's lifetime totals. page_post_engagements counts engagement with the Page's posts through reactions, comments, shares and more, by day, week or days_28, and page_media_view and page_total_media_view_unique do the same for views and viewers. Meta removed post_engaged_users in 2024, so engagement per post is built from clicks, reactions, comments and shares.

How fresh is the data, and how far back does it go?

Most metrics update once a day, and those Meta marks with an asterisk, such as post_clicks, several times a day. Meta keeps two years of insights for public Pages but only 5 days for unpublished ones. lifetime means the period for which data is available, two years or shorter by default. Page Insights data needs a Page with 100 or more likes, and several video metrics read 0 on a video reshared from another Page.

How does easyCoexistence read post insights?

get_social_insights takes the metrics and, for one post, its object_id, the post ID that list_social_posts returns; without object_id it reads the Page. period and extra parameters such as since and until pass through to Meta unchanged, and a retired metric comes back as Meta's invalid metric error, so the AI can switch to a current name.

Common mistakes

  • Requesting post_impressions_unique. Meta deprecated it for all API versions in June 2026; ask for post_total_media_view_unique to count unique viewers.
  • Adding up unique viewers across posts. Each post counts its own viewers, approximately, so a person who saw two posts is counted twice.
  • Reading insights on a video reshared from another Page. Several video metrics return 0 for reshares; only the Page that created the video gets accurate values.
  • Trusting a zero from an empty response. Without read_insights Meta returns an empty dataset rather than an error, so check the permission first.
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 post reach on Facebook?

post_total_media_view_unique, the count of a post's unique viewers, after Meta deprecated post_impressions_unique in June 2026.

Can I see who reacted to a Page post?

No. Meta returns reaction counts by type, but a Page or person can query only its own reaction; the others stay private.

Do like counts include care reactions?

Yes. Meta's like totals count both like and care, in insights and on the reactions edge alike.

Can I read insights for a post on another Page?

Not through Page insights: they need a token from someone who can perform the ANALYZE task on the Page that made the post.

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