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
This node operation fetches YouTube Analytics data specifically related to "Playback Location Data" for a given YouTube channel. Playback location analytics provide insights into where viewers are watching your videos, such as on YouTube watch pages, embedded players, or other locations. This information helps content creators and marketers understand viewer behavior and optimize video distribution strategies.
Common scenarios where this node is beneficial include:
- Analyzing which platforms or websites drive the most views to your channel.
- Understanding how viewers access your content to tailor marketing efforts.
- Comparing playback locations over time to assess the impact of promotional campaigns.
For example, a creator might use this node to retrieve playback location metrics between two dates to see if embedding videos on their blog increased views from external sites.
Properties
| Name | Meaning |
|---|---|
| Channel ID | The unique identifier of the YouTube channel for which to retrieve playback location data. |
| Start Date | The start date (inclusive) for the analytics data range. |
| End Date | The end date (inclusive) for the analytics data range. |
| Metrics | The specific playback-related 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 node outputs JSON data containing the requested playback location analytics for the specified channel and date range. The structure typically includes rows of data with the selected metrics aggregated by playback location types or other dimensions if specified.
The output JSON will contain fields representing the metrics chosen, such as views, estimated minutes watched, and others, broken down by playback location categories.
No binary data output is produced by this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service that acts as a proxy or enhancer for YouTube Data API v3 and Analytics.
- Requires OAuth2 credentials for YouTube API access.
- The node internally uses helper classes to interact with YouTube Analytics endpoints via the N8N Tools API.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error about invalid subscription or API key, verify that the API key credential is correctly configured and active.
- Permission Errors: Ensure 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. Use valid past dates.
- Max Results Limits: Requesting more than 1000 results may be rejected; keep within allowed limits.
- Network or API Downtime: Temporary failures in the external API service can cause request failures; retry after some time.