Page Insights Report

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

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

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?

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?

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?

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?

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?

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?

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

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)?

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?

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

Documentation Index

​When to Use It

​Inputs

​Options Reference

​Report Levels

​Output

​Credit Cost

​Example Setup

​Important Limitations

​Post-Level Reporting Restrictions

​Geographic Data Availability

​Data Retention

​FAQs