N8N Tools - Facebook EnhancedInstall

Overview

The "Get Page Insights" operation of the Facebook Enhanced node retrieves various performance metrics for a specified Facebook Page over a defined time period. This node is useful for social media managers, marketers, and analysts who want to monitor and analyze the engagement and reach of their Facebook Pages directly within n8n workflows.

Typical use cases include:

• Tracking daily or weekly page impressions and reach.
• Measuring user engagement on the page.
• Analyzing post and video performance metrics.
• Automating reports on page insights for business intelligence.

For example, a marketing team could automate the retrieval of page impressions and engagement data every day to feed into a dashboard or trigger alerts if certain thresholds are met.

Properties

Output

The node outputs JSON data containing the requested insights metrics for the specified Facebook Page. The structure typically includes metric names, values, and timestamps corresponding to the selected period and date range.

Example output snippet (simplified):

{
  "page_impressions": [
    {
      "value": 12345,
      "end_time": "2024-06-01T07:00:00+0000"
    },
    ...
  ],
  "page_reach": [
    {
      "value": 6789,
      "end_time": "2024-06-01T07:00:00+0000"
    },
    ...
  ]
}

No binary data is produced by this operation.

Dependencies

• Requires a valid API key credential for the external N8N Tools API service used for validation.
• Requires Facebook API credentials with appropriate permissions to access Page insights.
• The node uses the Facebook Graph API v23.0 under the hood.
• Proper configuration of OAuth2 or API key credentials for Facebook is necessary.

Troubleshooting

• Invalid subscription or API key error: If the node throws an error about invalid subscription or API key, verify that the API key credential for the external N8N Tools API is correct and active.
• Permission errors from Facebook API: Ensure that the Facebook credentials have the required permissions to read Page insights.
• Date format issues: The Since and Until properties must be in valid ISO 8601 format; otherwise, the API may reject the request.
• Empty or missing data: If no insights data is returned, check that the Page ID is correct and that the Page has sufficient activity for the requested metrics and period.

Links and References

• Facebook Graph API - Page Insights
• Facebook Graph API Versioning
• n8n Documentation - Creating Custom Nodes