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 integrates with the YouTube Data API v3 and provides enhanced functionality via an external service API. Specifically, for the Videos resource with the List Videos operation, it retrieves a list of videos from YouTube based on parameters such as maximum results, pagination token, and language code.
Common scenarios where this node is beneficial include:
- Fetching a curated list of videos for display or further processing in workflows.
- Paginating through large video collections by using page tokens.
- Filtering or localizing video lists by specifying language codes.
Practical example:
- A content manager wants to automate the retrieval of the latest 25 videos from a channel or search query, optionally continuing to fetch more pages using the page token.
- A marketing team needs to gather video metadata filtered by language to analyze regional content performance.
Properties
| Name | Meaning |
|---|---|
| Max Results | Maximum number of videos to return. Accepts values between 1 and 50. |
| Page Token | Pagination token to retrieve the next set of results in a paginated response. |
| Language | Language code (e.g., "en" for English, "pt" for Portuguese) to filter or localize results. |
Output
The node outputs an array of JSON objects representing the retrieved videos. Each item corresponds to one video entry returned by the YouTube API or the enhanced API service. The exact structure depends on the underlying API response but typically includes video metadata such as video ID, title, description, thumbnails, and other relevant details.
If multiple input items are processed, the output contains corresponding arrays of results for each input.
No binary data output is indicated for this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service that enhances YouTube API capabilities.
- Requires OAuth2 credentials for YouTube API access.
- The node performs an initial validation call to the external API service to verify subscription and API key validity.
- No additional environment variables are explicitly required beyond standard n8n credential configurations.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the provided API key credential is correct and active.
- API rate limits or quota exceeded: Since the node relies on YouTube API and an external service, hitting quota limits may cause errors. Consider monitoring usage and applying appropriate quotas.
- Pagination issues: Ensure the
Page Tokenproperty is correctly used to paginate through results; incorrect tokens may result in empty or repeated data. - Language filtering: Providing unsupported or incorrect language codes may yield no results or unexpected data.
Links and References
- YouTube Data API v3 Documentation
- YouTube API - List Videos Method
- n8n Documentation - Creating Custom Nodes
- External API service documentation (not publicly linked here) for the "N8N Tools API" enhancing YouTube integration