Overview

This node interacts with the Facebook Graph API to retrieve analytics data (insights) for a specific Facebook post on a selected Facebook Page. It is useful for social media managers and marketers who want to analyze the performance of individual posts, such as impressions, reach, engagement, clicks, and reactions by type. For example, it can be used to monitor the effectiveness of a marketing campaign post or to gather data for reporting purposes.

Use Case Examples

1. Retrieve insights for a promotional post to evaluate its reach and engagement.
2. Get detailed reaction metrics for a post to understand audience sentiment.

Properties

Output

JSON

• success - Indicates if the API request was successful.
• message - A message describing the result of the operation.
• postId - The ID of the post for which insights were retrieved.
• insights - An array containing the insights data for the post, including metrics like impressions, reach, engagement, clicks, and reactions by type.

Dependencies

• Facebook Graph API access via an OAuth2 API key credential

Troubleshooting

• Ensure the Facebook OAuth2 credentials are valid and have not expired; otherwise, the node will throw an 'Invalid access token' error.
• Verify that the selected Facebook Page is accessible and that the user has the necessary permissions to access post insights.
• Make sure the Post ID is correct and corresponds to a post on the selected Page.
• If the API returns permission errors, check that the Facebook app has the required permissions such as 'pages_read_engagement' and 'pages_show_list'.
• Network or API rate limit issues may cause request failures; retry or check API usage limits.

Links

• Facebook Graph API Insights - Official documentation for Facebook Insights API, detailing available metrics and usage.