N8N Tools - Facebook Enhanced icon

N8N Tools - Facebook Enhanced

Comprehensive Facebook Graph API integration for N8N workflows

Actions72

Insights → Get Video Insights

AI-generated

Overview

The "Get Video Insights" operation of the Insights resource in this Facebook Enhanced node retrieves analytical metrics related to videos on Facebook. It allows users to obtain detailed performance data such as video views, organic views, and engagement statistics over specified time periods.

This node is beneficial for social media managers, marketers, and content creators who want to monitor how their videos perform on Facebook. For example, a user can track the number of video views or engagement rates to evaluate the success of video campaigns or optimize future content strategies.

Practical examples include:

  • Fetching daily video view counts to analyze viewer trends.
  • Comparing organic versus paid video views over a week.
  • Gathering multiple metrics like video views and post engagements for comprehensive reporting.

Properties

Name Meaning
Metrics The specific video-related metrics to retrieve. Options include: Page Impressions, Page Reach, Page Engaged Users, Post Impressions, Post Reach, Post Engagements, Video Views, Video Views Organic. Multiple can be selected.
Period The time period over which to aggregate insights. Options are: Day, Week, Days 28 (last 28 days).
Since The start date/time for the insights data in ISO 8601 format. Optional; if not set, defaults apply.
Until The end date/time for the insights data in ISO 8601 format. Optional; if not set, defaults apply.

Output

The node outputs JSON data containing the requested video insight metrics for each input item. The structure typically includes metric names with their corresponding values aggregated over the specified period and date range.

Example output snippet (simplified):

{
  "video_views": 1234,
  "video_views_organic": 567,
  "post_engagements": 89
}

If multiple metrics are requested, all will be included in the output JSON object.

The node does not output binary data for this operation.

Dependencies

  • Requires an API key credential for the external N8N Tools API service that validates subscription and access.
  • Requires valid Facebook API credentials (OAuth2 or API token) configured in n8n to authenticate requests to Facebook Graph API.
  • The node uses the Facebook Graph API v23.0 endpoints internally via helper classes.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws errors about invalid subscription or API key, verify that the API key credential for the external validation service is correct and active.
  • Facebook API Errors: Errors from Facebook API (e.g., permission denied, invalid IDs) may occur if the provided post ID is incorrect or the access token lacks required permissions.
  • Date Format Issues: Ensure that the "Since" and "Until" dates are in proper ISO 8601 format; otherwise, the API may reject the request.
  • Empty Results: If no data is returned, check that the video post ID exists and that the selected metrics are applicable to the video content.

Links and References

Discussion