N8N Tools - YouTube Enhanced icon

N8N Tools - YouTube Enhanced

Comprehensive YouTube Data API v3 and Analytics integration for N8N workflows
Join our community

Actions83

Overview

The "Get Playlist Performance Data" operation in the Analytics resource of this YouTube Enhanced node fetches detailed performance metrics for a specified YouTube playlist over a defined date range. This node is useful for content creators, marketers, and analysts who want to monitor how their playlists are performing in terms of views, watch time, engagement, and revenue-related metrics.

Typical use cases include:

  • Tracking the growth and engagement of a playlist over time.
  • Analyzing which playlists drive the most viewer interaction or revenue.
  • Comparing performance metrics across different playlists.
  • Integrating playlist analytics into automated reporting workflows.

For example, a user can retrieve the number of views, estimated minutes watched, likes, and shares for a playlist between two dates to understand audience behavior and optimize content strategy.

Properties

Name Meaning
Channel ID The unique identifier of the YouTube channel that owns the playlist.
Playlist ID The unique identifier of the YouTube playlist for which performance data is requested.
Start Date The start date (inclusive) for the analytics data period.
End Date The end date (inclusive) for the analytics data period.
Metrics The list of performance metrics to include in the report. Options include:
- Views, Estimated Minutes Watched, Average View Duration, Average View Percentage
- Subscribers, Subscribers Gained, Subscribers Lost
- Likes, Dislikes, Comments, Shares
- Estimated Revenue, Ad Revenue, Gross Revenue
- CPM, CPC, Impressions, Monetized Playbacks
- Playback Based CPM
- Annotation Impressions, Clicks, Closable Impressions, Closes, Close Rate
- Card Impressions, Clicks, Click Rate, Teaser Impressions, Teaser Clicks, Teaser Click Rate
- Audience Watch Ratio, Relative Retention Performance
Max Results Maximum number of results to return (default 100, min 1, max 1000).
Start Index Index of the first result to return (default 1, minimum 1).

Output

The node outputs an array of JSON objects containing the requested playlist performance data as returned by the underlying YouTube Analytics API. Each object corresponds to a set of analytics data points matching the query parameters.

The exact structure depends on the selected metrics but typically includes fields such as:

  • Metric names with their respective values (e.g., views, estimatedMinutesWatched).
  • Date or dimension information if applicable.

No binary data output is produced by this operation.

Dependencies

  • Requires a valid API key credential for the external "N8N Tools API" service to validate subscription and access rights.
  • Requires OAuth2 credentials or API keys configured for accessing the YouTube Data and Analytics APIs.
  • The node internally uses helper classes to interact with YouTube's Analytics endpoints.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws an error about invalid subscription or API key, verify that the API key credential is correct and active.
  • Missing Required Parameters: Ensure that Channel ID, Playlist ID, Start Date, End Date, and at least one metric are provided.
  • API Quotas or Limits: Exceeding YouTube API quotas may cause errors; consider reducing Max Results or optimizing queries.
  • Date Range Issues: Providing an invalid or future date range may result in empty or error responses.
  • Network or Permission Errors: Check network connectivity and ensure the OAuth2 token has sufficient permissions for YouTube Analytics.

Links and References

Discussion