Data reference

Introduction

Facebook Page Organic surfaces page-level and post-level organic performance for a connected Facebook Page through the Meta Graph API (v23.0). It covers feed posts, reels, videos, and stories, alongside lifetime page-level signals such as follower count, fans, profile views, and reaction totals. This is the v2 connector; the legacy v1 Facebook Organic connector is deprecated and hidden from new-connection flows, though existing v1 widgets continue to function. Organic connectors capture both page and post performance, each provided in a different shape by the Meta APIs — lifetime aggregates for the page itself, per-post metrics with limited historical depth, and short-lived story metrics. As an organic-social connector, engagement metrics, audience breakdowns, and post-level groupings are standardized so widgets can aggregate alongside paid sources without additional configuration. To connect this data source, see How to connect Facebook Page Organic to Adriel.

Data refresh strategy

Architecture data

The Facebook Page and post hierarchy is refreshed daily at 8:00 PM UTC. On first connection, posts created within the last 1098 days are retrieved, but only lifetime metrics are available for them — there are no historical daily values. Metrics accumulate in the cache from the connection date forward, and new posts appear after the next daily refresh.

Reports data

Reports refresh on the following schedules, all in UTC:

Lifetime page data — daily at 8:00 PM.
Post data — daily at 8:00 PM.
Story data — twice daily at 8:00 PM and 8:00 AM, with a rolling 2-day fetch window so short-lived content is not missed across timezone boundaries.
Daily page data — initial fetch covers the last 90 days; subsequent refreshes update the most recent 3 days each cycle at 8:00 PM.
Monthly page data — daily at 8:20 PM.

Follower-type metrics (followers and fans) have no historical backfill — only daily snapshots are cached from the connection date forward.

Architecture levels

Facebook Page → Post (feed post / reel / video / story)

Date range limits

Time-grouping breakdowns are capped by granularity. Data outside the cap may be truncated.

Breakdown	Max range
Daily	93 days
Weekly	1 year

Monthly, quarterly, and yearly breakdowns have no hard range cap.

Metrics

How to read the columnsData type uses this vocabulary: Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean.API Key in code style such as page_post_engagements is the literal Meta Graph API field name. Italic text describes how a value is produced when it does not map cleanly to a single API field.

Page reach and impressions

Because organic reach reflects unique users per day, summing it across multiple days adds up each day’s value, so a multi-day total may be higher than the true number of unique users reached. Meta deprecated the page impressions metrics (page_impressions, page_impressions_organic, page_impressions_paid) on 2025-11-15; media views replace them (Meta — Deprecated Page Insights metrics) (see Media views). The organic-only and ads-only reach splits were deprecated 2026-06-16.

Metric	Description	Data type	API Key
Reach	Organic-and-ads page reach, surfaced as the default reach metric.	Number	Direct copy of `page_impressions_unique`
Reach (organic & ads)	Unique users who saw any Page content.	Number	`page_impressions_unique`
Reach (ads)	Unique users reached through ad-attributed views. Deprecated 2026-06-16.	Number	`page_impressions_paid_unique`
Reach (organic)	Unique users reached organically. Deprecated 2026-06-16.	Number	`page_impressions_organic_unique`

Page engagement

Metric	Description	Data type	API Key
Engagement	Total Page post engagements.	Number	`page_post_engagements`
Profile views	Views of the Page profile.	Number	`page_views_total`
Page post count	Total posts published.	Number	Derived from the post feed
Post count by type — feed / reel / video / story	Posts published, split by content type.	Number	Derived from the post feed
Ad posts (marketing tier)	Posts boosted as ads; only present when marketing metrics are enabled.	Number	`ads_post.total_count`

Page reactions

Metric	Description	Data type	API Key
Page likes	Like reactions on Page content.	Number	`page_actions_post_reactions_like_total`
Page love	Love reactions.	Number	`page_actions_post_reactions_love_total`
Page wow	Wow reactions.	Number	`page_actions_post_reactions_wow_total`
Page haha	Haha reactions.	Number	`page_actions_post_reactions_haha_total`
Page sorry	Sad reactions.	Number	`page_actions_post_reactions_sorry_total`
Page anger	Anger reactions.	Number	`page_actions_post_reactions_anger_total`

Page video

Metric	Description	Data type	API Key
Page video views (organic)	Organic video views on the Page.	Number	`page_video_views_organic`
Page video views (ads)	Ad-attributed video views.	Number	`page_video_views_paid`
Page video views (organic & ads)	Combined video views.	Number	`page_video_views`
30s complete views (organic)	Videos viewed to 30s or completion, organic.	Number	`page_video_complete_views_30s_organic`
30s complete views (ads)	30s completes, ad-attributed.	Number	`page_video_complete_views_30s_paid`
30s complete views (organic & ads)	Combined 30s completes.	Number	`page_video_complete_views_30s`

Page fans and followers

Follower and fan counts are lifetime snapshots with no historical backfill; daily snapshots accumulate from the connection date forward.

Metric	Description	Data type	API Key
Follow count	Page followers.	Number	`followers_count`
Fans	Page fans (lifetime).	Number	`fan_count`

Media views

Media views replace the deprecated impressions metrics. They only return data for posts created on or after 2024-09-22, a Meta API constraint. Organic and ads splits are separated by the is_from_ads parameter.

Metric	Description	Data type	API Key
Media views	Total media views on the Page.	Number	`page_media_view`
Media views (organic)	Organic media views.	Number	`page_media_view` where `is_from_ads` = false
Media views (ads)	Ad-attributed media views.	Number	`page_media_view` where `is_from_ads` = true

Post reactions

Metric	Description	Data type	API Key
Post likes	Like reactions on the post.	Number	`like.total_count`
Post love	Love reactions.	Number	`love.total_count`
Post haha	Haha reactions.	Number	`haha.total_count`
Post wow	Wow reactions.	Number	`wow.total_count`
Post sad	Sad reactions.	Number	`sad.total_count`
Post angry	Angry reactions.	Number	`angry.total_count`
Post care	Care reactions.	Number	`care.total_count`
Post reactions	Total reactions on the post.	Number	`reactions.total_count`

Post reach

The organic-only and ads-only post reach splits were deprecated 2026-06-16.

Metric	Description	Data type	API Key
Post reach (organic & ads)	Unique users who saw the post.	Number	`post_impressions_unique`
Post reach (organic)	Organic reach of the post. Deprecated 2026-06-16.	Number	`post_impressions_organic_unique`
Post reach (ads)	Ad-attributed reach. Deprecated 2026-06-16.	Number	`post_impressions_paid_unique`

Post clicks and engagement

Metric	Description	Data type	API Key
Post clicks	Total post clicks.	Number	`post_clicks`
Post link clicks	Clicks on links in the post.	Number	`post_clicks_by_type.link clicks`
Post other clicks	Other clicks on the post.	Number	`post_clicks_by_type.other clicks`
Post photo views	Photo views.	Number	`post_clicks_by_type.photo view`
Post video views (clicks)	Video-view clicks on the post.	Number	`post_clicks_by_type.video view`
Post comments	Comments on the post.	Number	`comments.total_count`
Post comment replies	Replies on comments.	Number	`commentreplies.total_count`
Post shares	Times the post was shared.	Number	`shares.count`
Post engagement	Reactions plus comments plus shares plus clicks.	Number	Adriel-computed (reactions + comments + shares + clicks)

Post video

Metric	Description	Data type	API Key
Post video views (organic)	Organic video views on the post.	Number	`post_video_views_organic`
Post video views (ads)	Ad-attributed video views.	Number	`post_video_views_paid`
Post video views (organic & ads)	Combined video views.	Number	`post_video_views`
Post video views (15s)	Views to 15 seconds.	Number	`post_video_views_15s`
Post video views (60s)	Views to 60 seconds.	Number	`post_video_views_60s_excludes_shorter`
Post video complete views (organic)	Complete organic views.	Number	`post_video_complete_views_organic`
Post video complete views (ads)	Complete ad-attributed views.	Number	`post_video_complete_views_paid`
Post unique video complete views (organic)	Unique complete organic views.	Number	`post_video_complete_views_organic_unique`
Post unique video complete views (ads)	Unique complete ad-attributed views.	Number	`post_video_complete_views_paid_unique`
Post video view time	Total time watched.	Duration	`post_video_view_time`
Post video view time (organic)	Organic watch time.	Duration	`post_video_view_time_organic`

Post media views

Post media views only return data for posts created on or after 2024-09-22. For reels, the organic and ads splits may not sum to the total because of Meta-side tracking differences.

Metric	Description	Data type	API Key
Post media views	Media views on the post.	Number	`post_media_view`
Post media views (organic)	Organic post media views.	Number	`post_media_view` where `is_from_ads` = false
Post media views (ads)	Ad-attributed post media views.	Number	`post_media_view` where `is_from_ads` = true

Post metadata

Metric	Description	Data type	API Key
Post type	Post format (post, reel, video, or story).	Text	Derived from the post object
Post date	Publish date of the post.	Date	`created_time`
Post link	Permalink to the post.	URL	`permalink_url`
Post media	Post cover image.	URL	`full_picture`
Post text	The post message text.	Text	`message`

Story

Metric	Description	Data type	API Key
Story impressions	Impressions on the story.	Number	`page_story_impressions_by_story_id`
Story reach	Unique accounts reached.	Number	`page_story_impressions_by_story_id_unique`
Story sticker interactions	Interactions with stickers.	Number	`pages_fb_story_sticker_interactions`
Story replies	Reply messages.	Number	`pages_fb_story_replies`
Story thread lightweight reactions	Lightweight reactions in the thread.	Number	`pages_fb_story_thread_lightweight_reactions`
Story shares	Times the story was shared.	Number	`pages_fb_story_shares`
Story interactions	All story interactions.	Number	`story_interaction`

Video and Reels

These object-level metrics come from the Video breakdown and use Meta’s total_video_* and reel-specific fields. Many granular view splits exist; the most common are listed here. Deprecated video impression fields are omitted.

Metric	Description	Data type	API Key
Video views (organic)	Organic views of the video.	Number	`total_video_views_organic`
Video views (organic & ads)	Combined video views.	Number	`total_video_views`
Video unique views (organic)	Unique organic views.	Number	`total_video_views_organic_unique`
Video unique views (ads)	Unique ad-attributed views.	Number	`total_video_views_paid_unique`
Video unique views (organic & ads)	Unique combined views.	Number	`total_video_views_unique`
Video sound-on views	Views played with sound on.	Number	`total_video_views_sound_on`
Video auto-played views	Views that auto-played.	Number	`total_video_views_autoplayed`
Video clicked views	Views started by a click.	Number	`total_video_views_clicked_to_play`
Video views (10s)	Views to 10 seconds.	Number	`total_video_10s_views`
Video views (10s, organic)	10s views, organic.	Number	`total_video_10s_views_organic`
Video views (10s, ads)	10s views, ad-attributed.	Number	`total_video_10s_views_paid`
Video views (30s)	Views to 30 seconds.	Number	`total_video_30s_views`
Video views (60s)	Views to 60 seconds.	Number	`total_video_60s_excludes_shorter_views`
Video completed views (organic)	Complete organic views.	Number	`post_video_complete_views_organic`
Video completed views (ads)	Complete ad-attributed views.	Number	`total_video_complete_views_paid`
Video completed views (organic & ads)	Combined complete views.	Number	`total_video_complete_views`
Video completed unique views (organic)	Unique complete organic views.	Number	`total_video_complete_views_organic_unique`
Video completed unique views (ads)	Unique complete ad-attributed views.	Number	`total_video_complete_views_paid_unique`
Video completed unique views (organic & ads)	Unique complete combined views.	Number	`total_video_complete_views_unique`
Video auto-play completed views	Complete views that auto-played.	Number	`total_video_complete_views_auto_played`
Video clicked completed views	Complete views started by a click.	Number	`total_video_complete_views_clicked_to_play`
Video average watch time	Average time watched.	Duration	`total_video_avg_time_watched`
Video view total time (organic)	Total watch time, organic.	Duration	`total_video_view_total_time_organic`
Video view total time (ads)	Total watch time, ad-attributed.	Duration	`total_video_view_total_time_paid`
Video view total time (organic & ads)	Combined total watch time.	Duration	`total_video_view_total_time`
Video reactions (like / love / haha / wow / sorry / anger)	Reactions on the video, by type.	Number	`total_video_reactions_by_type_total.{like,love,haha,wow,sorry,anger}`
Video comments	Comments on the video.	Number	`comments.total_count`
Video comments and replies	Comments plus replies.	Number	`commentreplies.total_count`
Video creation date	Date the video was created.	Date	`created_time`
Video length	Duration of the video.	Duration	`length`
Video title	Video title.	Text	`title`
Video link	Permalink to the video.	URL	`permalink_url`
Video media	Video cover image.	URL	`picture`
Reels play count	Play count for reels.	Number	`blue_reels_play_count`
Reels average watched time	Average watch time for reels.	Duration	`post_video_avg_time_watched`
Reels view time	Total watch time for reels.	Duration	`post_video_view_time`
Reels follows	Follows gained from the reel.	Number	`post_video_followers`
Reels comments	Comments on the reel.	Number	`post_video_social_actions.COMMENT`
Reels shares	Shares of the reel.	Number	`post_video_social_actions.SHARE`
Reels reactions (like / love / haha / wow / sorry / anger)	Reactions on the reel, by type.	Number	`post_video_likes_by_reaction_type.REACTION_{LIKE,LOVE,HAHA,WOW,SORRY,ANGER}`

Breakdowns

Hierarchy

Breakdown	Description	API Key
Page	Group by the Facebook Page.	`pageId`
Post	Group by the individual post, reel, video, or story.	`id`
Post type	Group by post format (post, reel, video, or story).	Derived from the post object
Post date	Group by post publish date.	`created_time`
Post text	Group by the post message text.	`message`
Video	Group by video object.	`id`

Audience demographics

Follower demographic breakdowns return the lifetime fan count for each bucket rather than the report metrics.

Breakdown	Description	API Key
City (followers)	Followers bucketed by city.	`page_follows_city`
Country (followers)	Followers bucketed by country.	`page_follows_country`

Time grouping

Meta returns daily records; Adriel groups them into these views for reporting, so all time-grouping breakdowns are Adriel-side aggregations of the same underlying daily data.

Breakdown	Description
Auto Time Breakdown	Automatically picks the best granularity for the date range.
Daily	Split reports by day.
Weekly (Start: Mon)	Split reports by week, starting Monday.
Monthly	Split reports by calendar month.
Quarterly	Split reports by calendar quarter.
Yearly	Split reports by calendar year.

Overview

Channel is a constant grouping label used for cross-connector rollup; for this data source it is always “facebook”.

Breakdown	Description
Channel	Constant grouping label used for cross-connector rollup.
No Grouping	Do not break down; return one aggregated row.

Limitations

No historical backfill for lifetime metrics — follower counts, fans, and audience demographics have no history before the connection date; daily snapshots accumulate from that day forward.
Media views are post-2024-09-22 only — the post_media_view and page_media_view series only return data for posts created on or after that date.
Deprecated impressions — Meta deprecated the page and post impressions metrics on 2025-11-15; media views replace them (Meta — Deprecated Page Insights metrics). The organic-only and ads-only reach splits were deprecated 2026-06-16.
Reach sums across days — because organic reach counts unique users per day, aggregating over a longer period may overstate the true unique audience.
Roughly 600 posts per year — Meta’s API returns about 600 ranked, published posts per year (Meta — Page feed reference). On Pages that publish more, older posts become unfetchable and their performance stops updating.
Temporary content — stories and reels may contain missing or inaccurate fields, and associated media may expire once a post is no longer accessible through the API.
Old or unretrievable posts — delta values for very old posts (3+ years) or posts that became unretrievable (deleted, restricted, or shortlisted by the platform) are not recorded.

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Page reach and impressions

Page engagement

Page reactions

Page video

Page fans and followers

Media views

Post reactions

Post reach

Post clicks and engagement

Post video

Post media views

Post metadata

Story

Video and Reels

Breakdowns

Hierarchy

Audience demographics

Time grouping

Overview

Limitations

API references (Meta)

See also

​Introduction

​Data refresh strategy

​Architecture data

​Reports data

​Architecture levels

​Date range limits

​Metrics

​Page reach and impressions

​Page engagement

​Page reactions

​Page video

​Page fans and followers

​Media views

​Post reactions

​Post reach

​Post clicks and engagement

​Post video

​Post media views

​Post metadata

​Story

​Video and Reels

​Breakdowns

​Hierarchy

​Audience demographics

​Time grouping

​Overview

​Limitations

​API references (Meta)

​See also

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Page reach and impressions

Page engagement

Page reactions

Page video

Page fans and followers

Media views

Post reactions

Post reach

Post clicks and engagement

Post video

Post media views

Post metadata

Story

Video and Reels

Breakdowns

Hierarchy

Audience demographics

Time grouping

Overview

Limitations

API references (Meta)

See also