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 node "N8N Tools - YouTube Enhanced" provides a comprehensive integration with the YouTube Data API v3 and YouTube Analytics API. Specifically, for the Analytics resource and the Get Content Type Data operation, it retrieves detailed analytics data about content types on a specified YouTube channel over a defined date range.

This operation is useful for YouTube content creators, marketers, and analysts who want to understand how different types of content perform on their channel. For example, a user can fetch metrics like views, estimated watch time, likes, or shares segmented by content type to optimize their content strategy.

Practical scenarios include:

  • Analyzing which content types generate the most engagement.
  • Tracking performance trends over time for specific content categories.
  • Integrating YouTube analytics into broader marketing dashboards or automation workflows.

Properties

Name Meaning
Channel ID The unique identifier of the YouTube channel for which analytics 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 metrics to include in the analytics report. Options include: views, likes, shares, estimated revenue, CPM, comments, subscribers gained/lost, and many more. Default includes "views" and "estimatedMinutesWatched".
Max Results Maximum number of results to return (minimum 1, maximum 1000). Defaults to 100.
Start Index The index of the first result to return (minimum 1). Defaults to 1.

Output

The output is an array of JSON objects containing the analytics data retrieved from YouTube for the specified content types. Each object corresponds to a set of analytics metrics for the given channel and date range.

The exact structure depends on the YouTube Analytics API response but typically includes:

  • The requested metrics values (e.g., views, estimated minutes watched).
  • Dimensions if applicable (e.g., content type).
  • Metadata such as date ranges or pagination info.

No binary data is output by this operation.

Dependencies

  • Requires a valid API key credential for the external N8N Tools API service.
  • Requires OAuth2 credentials for accessing the YouTube API.
  • The node internally uses helper classes that wrap YouTube API endpoints for analytics.
  • The node performs an initial validation call to the external API service to verify subscription and API key validity.

Troubleshooting

  • Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly configured and active.
  • API quota limits: YouTube API has quota limits; exceeding them may cause errors or incomplete data. Monitor usage and adjust requests accordingly.
  • Missing or incorrect parameters: Ensure required fields like Channel ID, Start Date, End Date, and Metrics are provided and valid.
  • Date range issues: The Start Date must be before or equal to the End Date; otherwise, the API may reject the request.
  • Network or permission errors: Check network connectivity and that the OAuth2 credentials have sufficient permissions to access YouTube Analytics data.

Links and References

Discussion