Log inStart Free Trial
easyCoexistence Official APIs

Facebook Page Insights metrics in 2026: which work and which Meta deprecated

Facebook Page Insights metrics that work in late 2026, read from GET /{page-id}/insights by day, week or days_28, include page_media_view, page_total_media_view_unique, page_post_engagements, page_follows and page_views_total. Meta deprecated page_impressions and page_fans on November 15, 2025, replaced by page_media_view and page_follows, and page_impressions_unique and the other reach metrics in June 2026, replaced by page_total_media_view_unique.

easyCoexistence reads Facebook Page and post insights with get_social_insights, so Claude, ChatGPT or your own code can ask how the Page did this month and get Meta's current metrics back.

15 Jun 2026

The date by which Meta deprecated a set of Page Insights metrics for all API versions.

page_total_media_view_unique

Meta's named alternative to page_impressions_unique, which it lists among the deprecated Page Insights metrics.

15 Nov 2025

When page_impressions, page_fans and post_impressions stopped working in all versions, replaced by page_media_view, page_follows and post_media_view.

90 days

Longest range one insights request can cover with the since and until parameters.

100 likes

Page Insights data is available only on Pages with at least this many likes.

Which Page metrics work now?

These are in Meta's reference and outside its deprecation lists as of October 30, 2026, each with the periods it takes:

  • page_media_view: times the Page's content was played or displayed; day, week, days_28, with is_from_ads and is_from_followers breakdowns.
  • page_total_media_view_unique: unique viewers of the Page's content; day, week, days_28.
  • page_post_engagements: engagement with the Page's posts through reactions, comments, shares and more; day, week, days_28.
  • page_follows: the Page's followers, counted as follows minus unfollows over its lifetime; day.
  • page_daily_unfollows_unique: accounts that unfollowed the Page in the period; day, week, days_28.
  • page_views_total: views of the Page's profile by logged-in and logged-out people; day, week, days_28.
  • page_total_actions: clicks on the Page's contact info and call-to-action button; day, week, days_28.

Which post metrics work now?

Read on a post's ID, mostly with period set to lifetime:

  • post_media_view: times the post was played or displayed, with is_from_ads and is_from_followers breakdowns.
  • post_total_media_view_unique: unique viewers of the post.
  • post_clicks: clicks anywhere in the post, counted over its lifetime.
  • post_reactions_by_type_total, and one metric per reaction such as post_reactions_like_total, where like includes care.
  • post_video_views: plays of a video post for at least 3 seconds; lifetime or day.

Which metrics did Meta deprecate, and when?

Meta retires Page metrics for all API versions at once, and a retired name returns an invalid metric error. Earlier rounds, on March 14 and September 16, 2024, removed metrics such as page_engaged_users, page_consumptions and post_engaged_users. The last two rounds came with replacements:

DeprecatedUse instead
Nov 15, 2025page_impressionspage_media_view
Nov 15, 2025page_fanspage_follows
Nov 15, 2025post_impressionspost_media_view
June 2026page_impressions_uniquepage_total_media_view_unique
June 2026post_impressions_uniquepost_total_media_view_unique

Are page_impressions_unique and page_post_engagements still valid?

page_impressions_unique is not. Meta's reference marks it deprecated above Graph API v25, its deprecated metrics page lists it with page_total_media_view_unique as the alternative, and the insights guide gives June 15, 2026 as the date for all versions. page_post_engagements still works: it stays in the reference with day, week and days_28, and appears on none of Meta's deprecation lists.

How are insights read?

With GET /{page-id}/insights for the Page or GET /{page-post-id}/insights for one post, and metric set to a comma-separated list; GET /{object-id}/insights/{metric} reads a single one. The token must come from someone who can perform the ANALYZE task on the Page, with the read_insights and pages_read_engagement permissions. A request with no metric fails with code 3001, subcode 1504028, and an unknown one with (#100) The value must be a valid insights metric.

How do periods and dates work?

period picks the aggregation: day, week and days_28 for Page metrics, lifetime for most post metrics. since and until set a range of up to 90 days per request, and the first value returned includes the since date. Most metrics update once every 24 hours, and Meta keeps metric data for two years on public Pages but only 5 days on unpublished ones.

What thresholds apply?

Page Insights data is only available on Pages with 100 or more likes, and demographic metrics come back only when there is data for 100 or more people. Metrics ending in _unique are approximate, and breakdowns of post and view insights return only non-zero values.

How does easyCoexistence read them?

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

Common mistakes

  • Requesting page_impressions_unique. Meta deprecated it in June 2026; ask for page_total_media_view_unique to count unique viewers.
  • Asking for more than 90 days in one request. Split longer ranges into windows of 90 days or less with since and until.
  • Reading insights on a Page with under 100 likes. Meta makes Page Insights data available only from 100 likes up.
  • Adding up _unique values across days or posts. Each counts people, approximately, so a sum counts someone seen on two days twice.
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 page_impressions_unique?

page_total_media_view_unique, Meta's count of unique viewers of the Page's content, once page_impressions_unique was deprecated in June 2026.

What replaced page_impressions?

page_media_view, the number of times the Page's content was played or displayed, since November 15, 2025.

How far back can Facebook Page insights go?

Two years for public Pages, read in ranges of up to 90 days per request with since and until.

Which permissions do Page insights need?

read_insights with pages_read_engagement, and a token from someone with the ANALYZE task on the Page.

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