N8N Tools - YouTube Enhanced
Actions83
- Videos Actions
- Channels Actions
- Playlists Actions
- Search Actions
- Analytics Actions
- Get Channel Analytics
- Get Video Analytics
- Get Playlist Analytics
- Get Content Owner Analytics
- Get Audience Retention
- Get Demographics
- Get Geographic Data
- Get Device Data
- Get Traffic Source Data
- Get Revenue Data
- Get Ad Performance Data
- Get Subscriber Analytics
- Get Playback Location Data
- Get Video Performance Data
- Get Playlist Performance Data
- Get Annotation Performance Data
- Get Card Performance Data
- Get Sharing Service Data
- Get Live Streaming Data
- Get Content Type Data
- Get Time Based Data
- Comments Actions
- Subscriptions Actions
- Live Streaming Actions
- Video Upload Actions
- Community Posts Actions
- Thumbnails Actions
- Captions Actions
- Channel Memberships Actions
- Super Chat & Thanks Actions
Overview
The node provides enhanced integration with YouTube's Data API v3 and Analytics, allowing users to retrieve detailed analytics data about YouTube channels, videos, playlists, and live streaming activities. Specifically, the "Get Live Streaming Data" operation under the "Analytics" resource fetches analytics related to live streams of a specified YouTube channel within a given date range.
This node is beneficial for content creators, marketers, and analysts who want to monitor live stream performance metrics such as views, watch time, and engagement over specific periods. For example, a user can track how many viewers tuned into their live broadcasts during a promotional event or analyze audience behavior during live sessions.
Properties
| Name | Meaning |
|---|---|
| Channel ID | The unique identifier of the YouTube channel for which live streaming analytics are requested. |
| Start Date | The start date/time from which to begin collecting analytics data. |
| End Date | The end date/time until which to collect analytics data. |
| Metrics | The specific live streaming 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 | |
| - Annotation Clicks | |
| - Annotation Clickable Impressions | |
| - Annotation Closable Impressions | |
| - Annotation Closes | |
| - Annotation Close Rate | |
| - Card Impressions | |
| - Card Clicks | |
| - Card Click Rate | |
| - Card Teaser Impressions | |
| - Card Teaser Clicks | |
| - Card 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 output JSON contains the live streaming analytics data retrieved from YouTube for the specified channel and date range. This data includes the requested metrics aggregated or segmented according to YouTube's analytics API response format. Each item corresponds to one execution input and contains the analytics report data relevant to that input.
No binary data is output by this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external service providing the YouTube API access.
- Requires OAuth2 credentials configured for YouTube API access.
- The node internally uses helper classes to interact with YouTube APIs, including analytics endpoints.
- The node performs an initial validation call to the external API service before executing operations.
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.
- Permission errors: Ensure that the OAuth2 credentials have sufficient permissions/scopes to access YouTube Analytics data.
- Date range issues: Providing invalid or future dates for start or end date may cause errors or empty results.
- Metric selection: Selecting unsupported or incompatible metrics for live streaming analytics may result in errors.
- Max results limits: Exceeding the maximum allowed results (1000) will cause validation errors; adjust accordingly.
- API quota limits: Frequent or large requests may hit YouTube API quota limits; consider reducing request frequency or scope.