> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Page Insights Report
> Fetch Facebook Page insights including followers, posts, likes, and engagement metrics
The **Get Report** node lets you fetch Facebook Page insights data across one or more pages using specified metrics, dimensions, and filters. This is an **AI-powered node** that can understand natural language instructions.
***
## When to Use It
Use this node to:
* Generate automated social media performance reports
* Track page growth metrics like followers and engagement over time
* Analyze post performance and audience insights
* Create data-driven content strategy decisions
* Export data for further analysis in external tools
***
## Inputs
| Field | Type | Required | Description |
| -------------- | ------------------ | -------- | ------------------------------------------ |
| **Pages** | Multi-select | ✅ | Select one or more Facebook Pages to query |
| **Date Range** | Date range picker | ✅ | Select date range for the report |
| **Metrics** | Multi-select | ✅ | Select metrics to include in the report |
| **Dimensions** | Multi-select | ❌ | Select dimensions to segment your data |
| **Filters** | Rule-based filters | ❌ | Add filters to refine your data |
| **Order By** | Sort configuration | ❌ | Set the order of results |
| **Limit** | Number | ❌ | Maximum number of rows to return |
| **Options** | Report options | ❌ | Additional options for the report |
### Options Reference
These optional settings let you format the output from Facebook before passing it to other nodes.
| Option | Description |
| ------------------------------- | ------------------------------------------------------------------------------------- |
| **Pretty Column Names** | Converts column headers to Title Case (e.g. `pageFollowers` becomes `Page Followers`) |
| **Add Percent Sign to Ratios** | Appends `%` to ratio metrics like Engagement Rate |
| **Display Currency Symbol** | Adds currency symbol if applicable to any monetary metrics |
| **Compact Numbers** | Converts large numbers to short format (e.g. `10K` instead of `10,000`) |
| **Pivot Dimensions as Columns** | Transforms dimension values into separate columns for easier comparison |
### Report Levels
Facebook Page insights can be reported at different levels:
* **Page Level**: Overall page performance and audience metrics
* **Post Level**: Individual post performance and engagement
***
## Output
The node returns a structured dataset with Facebook Page insights metrics and dimensions. The exact format depends on your configuration and the data returned from Facebook.
**Typical Output Structure:**
* **Data Rows**: Performance metrics and dimensions
* **Metadata**: Page information, date ranges, and query details
* **Summary Statistics**: Total records, data freshness, execution time
Can be passed to:
* AI nodes like **Analyze Data** or **Structured Output**
* Export nodes (e.g., Google Sheets)
* Email or Slides nodes
***
## Credit Cost
* **Cost per run**: 1 credit (per successful execution)
***
## Example Setup
```plaintext theme={"dark"}
Scheduler (Daily 10 AM) →
Facebook Get Report →
AI Analysis →
Google Slides Report →
Slack Notification
```
**Configuration Example:**
* **Pages**: My Business Page, Secondary Page
* **Date Range**: Last 30 days
* **Metrics**: Page Followers, Post Reach, Engagement Rate, New Followers
* **Dimensions**: Date, Post Type
* **Limit**: 1000 rows
***
## Important Limitations
### Post-Level Reporting Restrictions
When working with **post-level** data, be aware of these Facebook API limitations:
* **No Historical Comparisons**: You cannot use 'Compared To' functionality with post-level fields
* **No Date Dimension**: You cannot use 'date' dimension with post-level fields
* **Lifetime Data Only**: Facebook only returns lifetime data for posts
* **Use Post Created Time**: Instead of 'date', use 'Post Created Time' dimension for post-level reports
### Geographic Data Availability
* **Limited Geographic Breakdowns**: Country-level or city-level breakdowns are only available for the **Lifetime Likes** metric
* **Page-Level Only**: Geographic dimensions work only with page-level metrics, not post-level
### Data Retention
* **Page Non-aggregatable Insights**: Provides non-aggregatable page-level data reported daily for the last **two years**
* **Historical Access**: Limited by Facebook's data retention policies
***
## FAQs
The data will be **aggregated across all selected pages** into a single
dataset. If you'd like to break it out by page, add the `page_name` or
`page_id` dimension to segment results per page.
Facebook's API limitation: **Post-level fields only return lifetime data**
without historical comparison capabilities. This is a Facebook restriction,
not a tool limitation. Use page-level metrics if you need historical
comparisons.
Facebook only returns **lifetime data for posts**, so the 'date' dimension
isn't applicable. Instead, use the **'Post Created Time'** dimension to
segment posts by when they were created.
Common reasons pages don't appear: - **Page Access**: You need one of these
Facebook Page roles: Admin, Editor, or Moderator - **Business Manager Access
Only**: Access only through Facebook's Business Manager is not sufficient -
**Permission Settings**: Check your Business Integrations settings on Facebook
* **Authentication Scope**: Ensure the page was selected during the Facebook
authentication flow
If you can't find your page when connecting: 1. Look for an **"Edit
Settings"** option during the connection process 2. Add/review the pages you
want access to 3. **Important**: Don't uncheck any previously connected pages
as this will revoke access 4. Make sure all desired pages are checked in
Facebook's authentication dialog
The Facebook integration requires: - **Page Access**: Permission to read
insights from your Facebook Pages - **Business Integration**: Both required
options must be checked in Facebook's authentication - **User Role**: Admin,
Editor, or Moderator role on the Facebook Page(s)
**Facebook Reels are not included** in the Post Insights Report because
Facebook does not consider Reels to be page posts. This is a Facebook API
limitation - Reels data is handled separately from regular page posts.
If you changed your Facebook password: - **Reconnection Required**: You'll
need to reconnect the Facebook Pages source in your account - **Token
Invalidation**: Password changes invalidate existing access tokens -
**Two-Factor Authentication**: If you have 2FA enabled, ensure it's properly
configured before reconnecting
Yes, but with considerations: - **Account-Level 2FA**: Sources with 2FA work
but may need reconnection due to security token updates - **Ad Account 2FA**:
If 2FA is configured for an entire ad account, the connecting user must also
have 2FA activated - **Reconnection**: You may need to reconnect sources after
enabling 2FA
Facebook API restrictions: - **Limited Geographic Data**: Country-level or
city-level breakdowns are only available for the **Lifetime Likes** metric -
**API Limitation**: This is a Facebook restriction, not a tool limitation -
**Page-Level Only**: Geographic dimensions work only with page-level metrics,
not individual posts