N8N Tools - YouTube EnhancedInstall

Overview

The "Get Subscriber Analytics" operation of the YouTube Enhanced node fetches detailed subscriber-related analytics data for a specified YouTube channel over a defined date range. This node is useful for content creators, marketers, and analysts who want to monitor subscriber trends, such as gains, losses, and overall subscriber counts, to better understand audience engagement and growth patterns.

Typical use cases include:

• Tracking subscriber growth or decline over time.
• Analyzing the impact of specific campaigns or content on subscriber numbers.
• Generating reports for stakeholders about channel performance.

For example, a user can specify a channel ID and a date range to retrieve metrics like total subscribers gained or lost during that period, helping them evaluate their channel's health and growth.

Properties

Output

The node outputs JSON data containing the requested subscriber analytics metrics for the specified channel and date range. The structure typically includes:

• Time series or aggregated data points corresponding to the selected metrics.
• Each data point may include metric values such as subscriber count, subscribers gained, and subscribers lost.
• Additional metadata related to the analytics query (e.g., date ranges, dimensions if applicable).

No binary data output is produced by this operation.

Example output snippet (simplified):

{
  "subscriberAnalytics": [
    {
      "date": "2024-01-01",
      "subscribers": 1500,
      "subscribersGained": 50,
      "subscribersLost": 10
    },
    {
      "date": "2024-01-02",
      "subscribers": 1540,
      "subscribersGained": 60,
      "subscribersLost": 20
    }
  ]
}

Dependencies

• Requires an active subscription and valid API key credential for the external YouTube analytics service integrated via the "N8N Tools API".
• Requires OAuth2 credentials for YouTube API access.
• The node internally validates the API key with the external service before making requests.
• No additional environment variables are explicitly required beyond these credentials.

Troubleshooting

• Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that the provided API key credential is correct and active.
• Permission Errors: Ensure that the OAuth2 credentials have sufficient permissions to access YouTube Analytics data for the specified channel.
• Date Range Issues: Providing an invalid or future date range may cause errors or empty results. Confirm that start and end dates are valid and logical.
• Max Results Limits: Requesting more than the allowed maximum results (1000) may cause errors; adjust the "Max Results" property accordingly.
• API Quotas: Exceeding YouTube API quotas may result in rate limiting errors; consider optimizing request frequency or applying for higher quota limits.

Links and References

• YouTube Analytics API Documentation
• YouTube Data API Overview
• N8N Documentation on Credentials
• N8N Community Forum