> ## 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 Public data source in Adriel.

## Introduction

Facebook Page Public retrieves publicly available data from any Facebook Page through the Meta Graph API (v23.0) — no page ownership, admin access, or ad account is required. It surfaces two kinds of data: the Page's public profile (followers, About text, website, cover and profile imagery) and recent feed posts with their public engagement (per-reaction counts, shares, comments, and replies).

This is a public connector, distinct from Facebook Page Organic (owned page analytics that require admin access) and Meta Ads (paid campaign data). Because it reads only public data, it authenticates with a server-side application token rather than a personal login, and the connection is created from a Facebook Page URL.

To connect this data source, see [How to connect Facebook Page Public to Adriel](/data-sources/a-f/facebook-page-public/how-to-connect).

## Data refresh strategy

### Architecture data

Facebook Page Public is a simple-cache connector: for each connected Page, Adriel re-fetches the public data and refreshes the cache on a fixed daily schedule. There is no historical backfill — the cache holds the current snapshot of the Page profile and the most recent feed posts, and values accumulate from the connection date forward as each daily refresh runs.

The Page profile and the feed are stored in two separate cache collections per data source (one for page-profile data, one for posts).

### Reports data

The cache refreshes daily at **6:00 PM UTC** for both the page profile and the posts collection (a single schedule covers both).

This connector does not support date filtering. Reports always read the current cached snapshot: the page-profile view returns a single row, and the posts view returns up to the most recent 100 posts.

## Architecture levels

Facebook Page Public operates in two data modes, and a data source exposes both:

* **Page mode** — reads the Page's public profile from `GET /v23.0/{pageId}`. Always returns exactly one row (the Page itself).
* **Posts mode** — reads the Page's public feed from `GET /v23.0/{pageId}/feed`. Returns one row per post, up to a cap of 100 of the most recent posts.

Metrics and breakdowns differ by mode: page-profile fields are only available in page mode, and post engagement fields are only available in posts mode.

## Date range limits

Not applicable. Facebook Page Public has no date filtering — reports ignore the dashboard date range and always return the current cached snapshot (one page row; up to 100 recent posts).

## Metrics

<Note>
  **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 `followers_count` is the literal Meta Graph API field (or constructed sub-query). *Italic text* describes how a value is produced when it does not map cleanly to a single API field.
</Note>

### Page profile

Available in page mode. Returns a single row describing the Page's public profile.

| Metric          | Description                            | Data type | API Key                                   |
| --------------- | -------------------------------------- | --------- | ----------------------------------------- |
| Followers count | Number of people who follow the Page.  | Number    | `followers_count`                         |
| About           | The Page's public About text.          | Text      | `about`                                   |
| Website         | Website listed on the Page.            | URL       | `website`                                 |
| Page link       | Canonical URL of the Facebook Page.    | URL       | `link`                                    |
| Cover image     | URL of the Page's cover image.         | URL       | *Derived from the `cover` image object*   |
| Profile picture | URL of the Page's profile picture.     | URL       | *Derived from the `picture` image object* |
| Page ID         | Meta's unique identifier for the Page. | Text      | `id`                                      |

### Post engagement

Available in posts mode. Returns one row per post (up to 100 most recent). Reaction totals are fetched as per-type summary counts.

| Metric            | Description                                      | Data type | API Key                                      |
| ----------------- | ------------------------------------------------ | --------- | -------------------------------------------- |
| Post likes        | Like reactions on the post.                      | Number    | `reactions.type(LIKE).summary(total_count)`  |
| Post love         | Love reactions on the post.                      | Number    | `reactions.type(LOVE).summary(total_count)`  |
| Post haha         | Haha reactions on the post.                      | Number    | `reactions.type(HAHA).summary(total_count)`  |
| Post wow          | Wow reactions on the post.                       | Number    | `reactions.type(WOW).summary(total_count)`   |
| Post sad          | Sad reactions on the post.                       | Number    | `reactions.type(SAD).summary(total_count)`   |
| Post angry        | Angry reactions on the post.                     | Number    | `reactions.type(ANGRY).summary(total_count)` |
| Post care         | Care reactions on the post.                      | Number    | `reactions.type(CARE).summary(total_count)`  |
| Post reactions    | Total reactions on the post, all types combined. | Number    | `reactions.summary(total_count)`             |
| Post shares       | Number of times the post was shared.             | Number    | `shares.count`                               |
| Post comments     | Number of top-level comments on the post.        | Number    | `comments.summary(total_count)`              |
| Post replies      | Number of replies on the post's comments.        | Number    | *Derived from the comment-replies stream*    |
| Post created time | Date and time the post was published.            | Date      | `created_time`                               |

## Breakdowns

### Post

Available in posts mode. These group and identify individual posts.

| Breakdown    | Description                             | API Key         |
| ------------ | --------------------------------------- | --------------- |
| Post ID      | Group by the individual post.           | `id`            |
| Post message | Group by the post's message text.       | `message`       |
| Post link    | Group by the post's permalink.          | `permalink_url` |
| Post image   | Group by the post's attached image URL. | `full_picture`  |

### Page

Available in page mode.

| Breakdown | Description                      | API Key |
| --------- | -------------------------------- | ------- |
| Page name | Group by the Facebook Page name. | `name`  |

## Limitations

* **No date filtering** — reports always return the current cached snapshot; the dashboard date range has no effect. There is no historical daily data, only what accumulates from the connection date forward.
* **Posts are capped at \~100** — posts mode returns at most the 100 most recent posts, even though the underlying feed can be paginated further. Older posts are not retrieved.
* **Public data only** — only publicly visible profile fields and public engagement are available. Reach, impressions, and other owner-only insights are not accessible; use Facebook Page Organic for those.
* **Generic data source** — this connector cannot be natively combined with other connector types unless they share identical breakdowns. Cross-connector analysis requires a blended data source.
* **Deletions are not reflected** — if an element (a post or a profile field) is deleted on Facebook, its previously cached value stops updating and the current value becomes unavailable after the deletion.
* **Media may expire** — cover, profile-picture, and post image URLs point to Facebook-hosted media that can expire or change if the underlying content is removed or is no longer accessible through the API.

## API references

* [Facebook Page (Graph API reference)](https://developers.facebook.com/docs/graph-api/reference/page/)
* [Page feed (Graph API reference)](https://developers.facebook.com/docs/graph-api/reference/page/feed/)
* [Reactions (Graph API reference)](https://developers.facebook.com/docs/graph-api/reference/object/reactions/)
* [Graph API versioning (v23.0)](https://developers.facebook.com/docs/graph-api/guides/versioning/)

## See also

* [How to connect Facebook Page Public to Adriel](/data-sources/a-f/facebook-page-public/how-to-connect) (paired how-to)
* [Facebook Page Organic data reference](/data-sources/a-f/facebook-page-organic/data-reference) — owned Page analytics (requires admin access)
* [Meta Ads data reference](/data-sources/g-n/meta-ads/data-reference) — for paid Facebook and Instagram campaigns