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
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
What happens if I select multiple Facebook Pages?
What happens if I select multiple Facebook Pages?
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.
Why can't I use 'Compared To' with post-level data?
Why can't I use 'Compared To' with post-level data?
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.
Why can't I use 'date' dimension with post-level fields?
Why can't I use 'date' dimension with post-level fields?
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.
I can't find my Facebook Page when connecting - what should I check?
I can't find my Facebook Page when connecting - what should I check?
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
How do I add a page I forgot to select during setup?
How do I add a page I forgot to select during setup?
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
What permissions does this integration need?
What permissions does this integration need?
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)
Why don't I see Facebook Reels in my post data?
Why don't I see Facebook Reels in my post data?
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.
My connection stopped working after changing my Facebook password
My connection stopped working after changing my Facebook password
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
Do Facebook sources work with Two-Factor Authentication (2FA)?
Do Facebook sources work with Two-Factor Authentication (2FA)?
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
Why are geographic breakdowns only available for some metrics?
Why are geographic breakdowns only available for some metrics?
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