Skip to main content
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

FieldTypeRequiredDescription
PagesMulti-select✅Select one or more Facebook Pages to query
Date RangeDate range picker✅Select date range for the report
MetricsMulti-select✅Select metrics to include in the report
DimensionsMulti-select❌Select dimensions to segment your data
FiltersRule-based filters❌Add filters to refine your data
Order BySort configuration❌Set the order of results
LimitNumber❌Maximum number of rows to return
OptionsReport options❌Additional options for the report

​
Options Reference

These optional settings let you format the output from Facebook before passing it to other nodes.
OptionDescription
Pretty Column NamesConverts column headers to Title Case (e.g. pageFollowers becomes Page Followers)
Add Percent Sign to RatiosAppends % to ratio metrics like Engagement Rate
Display Currency SymbolAdds currency symbol if applicable to any monetary metrics
Compact NumbersConverts large numbers to short format (e.g. 10K instead of 10,000)
Pivot Dimensions as ColumnsTransforms 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

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
⌘I