N8N Tools - YouTube Enhanced icon

N8N Tools - YouTube Enhanced

Comprehensive YouTube Data API v3 and Analytics integration for N8N workflows

Actions83

Overview

The node provides enhanced integration with YouTube's Data API v3 and Analytics, enabling users to retrieve detailed analytics and monetization data related to YouTube channels. Specifically, for the "Super Chat & Thanks" resource with the "Get Monetization Summary" operation, it fetches a summary of monetization metrics over a specified date range for a given YouTube channel.

This functionality is beneficial for content creators, channel managers, and marketers who want to analyze revenue streams from Super Chats and Super Thanks features on their YouTube channels. For example, a creator can use this node to track how much income was generated from fan donations during live streams or video premieres within a specific period.

Properties

Name Meaning
Start Date The start date for the analytics data range to retrieve monetization summary information.
End Date The end date for the analytics data range to retrieve monetization summary information.

Both properties are required and expect date-time values specifying the time window for the monetization summary.

Output

The node outputs JSON data containing the monetization summary for the specified channel and date range. This typically includes aggregated metrics related to Super Chat and Super Thanks revenue, such as total amounts received, counts of events, and possibly breakdowns by date or other dimensions depending on the underlying API response.

No binary data output is involved in this operation.

Example structure (simplified):

{
  "totalAmount": 123.45,
  "currency": "USD",
  "eventCount": 10,
  "startDate": "2024-01-01T00:00:00Z",
  "endDate": "2024-01-31T23:59:59Z"
}

Actual fields depend on the YouTube API response for monetization summaries.

Dependencies

  • Requires an active subscription and valid API key credential for the external "N8N Tools API" service.
  • Requires OAuth2 credentials for YouTube API access.
  • The node internally uses helper classes that wrap YouTube API endpoints, including a dedicated module for Super Chat & Thanks analytics.
  • Proper configuration of these credentials in n8n is necessary for successful execution.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws errors about invalid subscription or API key, verify that the API key credential is correct and has the necessary permissions.
  • Authentication Errors: Ensure that the YouTube OAuth2 credentials are valid and have not expired.
  • Date Range Issues: Providing an invalid or reversed date range (start date after end date) may cause errors or empty results.
  • API Rate Limits: Exceeding YouTube API quotas may result in throttling; consider adding delays or reducing request frequency.
  • Missing Required Parameters: Both start and end dates must be provided; missing these will cause validation errors.

Links and References


This summary focuses exclusively on the "Super Chat & Thanks" resource and the "Get Monetization Summary" operation as requested.

Discussion