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 "Get Audience Retention" operation under the Analytics resource in this YouTube Enhanced node fetches audience retention data for a specified YouTube video over a defined date range. Audience retention metrics help content creators understand how viewers engage with their videos, showing which parts hold attention and where viewers drop off.
This node is beneficial for YouTubers, marketers, and analysts who want to optimize video content by analyzing viewer engagement patterns. For example, a creator can use this data to identify segments of a video that lose viewers quickly and improve future content accordingly.
Properties
| Name | Meaning |
|---|---|
| Video ID | The unique identifier of the YouTube video for which to retrieve audience retention data. |
| Start Date | The start date for the analytics data range (inclusive). |
| End Date | The end date for the analytics data range (inclusive). |
Output
The output JSON contains the audience retention analytics data returned from the YouTube API for the specified video and date range. This typically includes detailed metrics about how viewers watched the video over time, such as retention curves or percentages at different video timestamps.
The exact structure depends on the YouTube Analytics API response but generally provides insights into viewer engagement throughout the video duration.
No binary data output is involved in this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external N8N Tools API service.
- Requires OAuth2 credentials for accessing the YouTube Data API v3.
- The node internally uses helper classes to interact with YouTube APIs and validate API keys.
- Proper configuration of these credentials in n8n is necessary before using this node.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correct and has the necessary permissions.
- Missing Required Parameters: Ensure that the Video ID, Start Date, and End Date are provided and correctly formatted.
- API Rate Limits: Exceeding YouTube API quotas may cause errors; monitor usage and apply for higher quota if needed.
- Date Range Issues: The Start Date must be earlier than or equal to the End Date; otherwise, the API may return errors or empty results.
- Network or Connectivity Errors: Check network connectivity and proxy settings if requests fail unexpectedly.