N8N Tools - YouTube Enhanced
Comprehensive YouTube Data API v3 and Analytics integration for N8N workflows
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 API, allowing users to retrieve detailed analytics data for YouTube videos. Specifically, the "Get Video Analytics" operation fetches various metrics and dimensions related to a specified YouTube video over a defined date range.
This node is beneficial for content creators, marketers, and analysts who want to monitor video performance, understand audience engagement, and optimize their YouTube content strategy based on data insights.
Practical examples:
- Retrieve total views and average watch duration of a video between two dates.
- Analyze subscriber gains and losses associated with a specific video.
- Group video analytics by day or country to identify trends in viewer demographics.
Properties
| Name | Meaning |
|---|---|
| Video ID | The unique identifier of the YouTube video to analyze. |
| Start Date | The start date for the analytics data range (inclusive). |
| End Date | The end date for the analytics data range (inclusive). |
| Metrics | The list of metrics to include in the analytics 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. |
| Dimensions | Dimensions to group the analytics data by. Options include: Date, Month, Year, Video, Playlist, Channel, Age Group, Gender, Country, Province, Continent, Sub Continent, Device Type, Operating System, Browser, Traffic Source Type, Revenue Source Type, Ad Type, Subscribed Status, Playback Location Type, Annotation Type, Card Type, Sharing Service, Live or On Demand, Content Type, Elapsed Video Time Ratio. Default is "Date". |
| Sort | Optional sort order for the results, e.g., "-views" for descending order by views. |
| Filters | Optional filters to apply to the analytics data. |
| Max Results | Maximum number of results to return (1 to 1000). Default is 100. |
| Start Index | Index of the first result to return (minimum 1). Default is 1. |
Output
The node outputs an array of JSON objects containing the requested analytics data for the specified video. Each object includes the metrics and dimensions as per the request parameters.
The exact structure depends on the selected metrics and dimensions but typically includes fields such as:
- Metric values (e.g., views count, estimated minutes watched)
- Dimension values (e.g., date, country)
- Aggregated or grouped data points according to the dimensions
No binary data output is produced by this operation.
Dependencies
- Requires a valid API key credential for the external service that validates subscription and API key usage.
- Requires OAuth2 credentials or API credentials configured for accessing YouTube Data API v3 and YouTube Analytics API.
- The node internally uses helper classes to interact with YouTube APIs, including analytics endpoints.
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.
- API quota limits: YouTube APIs have quota limits; exceeding these may cause errors or incomplete data. Monitor your quota usage in Google Cloud Console.
- Incorrect Video ID: Providing an invalid or non-existent video ID will result in errors or empty data sets.
- Date range issues: Ensure the start date is before or equal to the end date; otherwise, the API may return errors or no data.
- Missing required parameters: All required properties (Video ID, Start Date, End Date, Metrics) must be provided; missing any will cause execution failure.
- Sorting and filtering syntax: Incorrectly formatted sort or filter strings may cause API errors; refer to YouTube Analytics API documentation for correct syntax.