> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/social-media/facebook-public-data/data-overview.md).

# Data Overview

Facebook Public Data gives you two report types: page-level statistics and post-level statistics. Both pull data from public Facebook Pages only — you cannot import data from personal profiles using this source.

## Report types

| Report Type             | What it shows                                                          | Best for                                |
| ----------------------- | ---------------------------------------------------------------------- | --------------------------------------- |
| Public pages statistics | Aggregated metrics for your entire page (followers, engagement, reach) | Tracking overall page health and trends |
| Public posts statistics | Performance of individual posts published to your page                 | Analyzing which content performs best   |

## Page statistics metrics

#### Engagement

* Page likes
* New followers (daily)
* Page views (daily)
* Post views (daily)
* Follower demographics (age, gender, location, language)

#### Visibility & reach

* Page reach
* Impressions
* Website clicks
* Call button clicks
* Direction request clicks

## Post statistics metrics

#### Performance

* Post reach
* Post impressions
* Engagements (total interactions)
* Shares
* Comments
* Reactions (likes, love, haha, wow, sad, angry)
* Clicks (external links, CTAs)

#### Content details

* Post type (status, photo, video, link)
* Post creation date
* Post text/caption
* Permalink to the post

## Common analysis patterns

**Track post performance over time** — Use "Public posts statistics" to identify your best-performing content by reach, engagement, or specific reaction types. Filter by date range to analyze seasonal trends.

**Compare multiple pages** — Enter multiple page IDs (one per line) to pull statistics from all your pages in a single data flow. Use an Append transformation if you want to combine them into one table, or keep them separate for side-by-side comparison.

**Join post data with external sources** — Combine post statistics with your marketing data in Google Sheets or BigQuery using a Join transformation. For example, match posts with paid campaign data by date to see organic vs. paid impact.

## Use cases by role

{% tabs %}
{% tab title="Social media managers" %}
Pull weekly or daily post performance reports to see which content resonates with your audience. Use "Public posts statistics" to identify top-performing posts by engagement and reach, then replicate that content style. Export to Google Sheets for easy sharing with the team.
{% endtab %}

{% tab title="Marketing teams" %}
Combine Facebook data with ad spend data from other sources using a Join transformation. Export page statistics to Google Sheets or Looker Studio to build dashboards tracking follower growth, reach, and engagement over time. Use this to justify social media investment.
{% endtab %}

{% tab title="Business analysts" %}
Aggregate post data across multiple pages and time periods in BigQuery. Create custom calculations (engagement rate, reach per post, etc.) and build dashboards in Looker Studio. Use Append transformations to centralize data from all your pages for company-wide reporting.
{% endtab %}

{% tab title="AI & content insights" %}
Send post data and captions to Claude or ChatGPT via Coupler.io's AI destinations to auto-generate content insights, identify themes in top-performing posts, or get recommendations for future content. Send page statistics to Gemini or Perplexity for competitive analysis.
{% endtab %}
{% endtabs %}

## Platform-specific notes

* **Page IDs vs. usernames** — You must use either your page's numeric ID (e.g., `123456789`) or its public alias (e.g., `yourpagename`). Do not use the full URL or page name. If unsure, visit your page, look at the URL, and extract the ID or name.
* **Public pages only** — This source works only for pages with public content. Personal profiles cannot be imported, even if the profile is set to public.
* **No custom date ranges for page stats** — "Public pages statistics" returns all available historical data from Facebook. You cannot filter by a specific date range for overall page metrics.
* **Post data requires date range** — "Public posts statistics" requires you to set both "Published after" and "Published before" dates. Posts outside this range will not be returned.
* **Data freshness** — Facebook typically updates public page data within a few hours. Scheduled refreshes work best on a daily or weekly basis.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/social-media/facebook-public-data/data-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.