> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Data reference
> Metrics, breakdowns, refresh cadence, and limits for the Facebook Page Organic data source in Adriel.
## 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-sources/a-f/facebook-page-organic/how-to-connect).
## 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 columns**
**Data 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](https://developers.facebook.com/documentation/pages-api/platforminsights/page/deprecated-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](https://developers.facebook.com/documentation/pages-api/platforminsights/page/deprecated-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](https://developers.facebook.com/docs/graph-api/reference/page/feed/)). 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.
## API references (Meta)
* [Page insights (Graph API)](https://developers.facebook.com/docs/graph-api/reference/page/insights/)
* [Post insights (Graph API)](https://developers.facebook.com/docs/graph-api/reference/insights)
* [Page feed reference](https://developers.facebook.com/docs/graph-api/reference/page/feed/)
* [Page video insights](https://developers.facebook.com/docs/graph-api/reference/video/video_insights/)
## See also
* [How to connect Facebook Page Organic to Adriel](/data-sources/a-f/facebook-page-organic/how-to-connect) (paired how-to)
* [Meta Ads data reference](/data-sources/g-n/meta-ads/data-reference) — for paid Facebook and Instagram campaigns
* [Instagram Organic data reference](/data-sources/g-n/instagram-organic/data-reference) — sister organic platform