n8ntools-youtube

Enhanced YouTube Data API v3 node for N8N with comprehensive video and channel management

Package Information

Released: 9/13/2025
Downloads: 3 weekly / 40 monthly
Latest Version: 1.0.1

Documentation

N8N Tools - YouTube Enhanced

npm version
npm downloads
License: MIT

Complete YouTube integration with 100+ operations covering the entire YouTube Creator ecosystem. This N8N community node provides comprehensive access to Videos, Channels, Playlists, Comments, Live Streaming, Analytics, Captions, Community Posts, Memberships, Super Chat, Thumbnails, and Subscriptions APIs that are missing from the official YouTube node.

✨ Features

  • 🎥 Advanced Video Management: Upload, update, analyze, and manage videos with full lifecycle control
  • 📺 Channel Operations: Complete channel management, branding, and community features
  • 📋 Playlist Management: Create, organize, and optimize playlists for better discoverability
  • 💬 Comment System: Moderate, reply, and analyze comments across all content
  • 🔴 Live Streaming: Create, manage, and analyze live broadcasts and streams
  • 📊 Advanced Analytics: Comprehensive performance metrics and audience insights
  • 📝 Captions & Subtitles: Auto-generate, upload, and manage multilingual captions
  • 🏘️ Community Posts: Create and manage YouTube Community tab content
  • 💎 Channel Memberships: Manage memberships, perks, and subscriber benefits
  • 💰 Super Chat & Thanks: Monetization features and fan funding analytics
  • 🖼️ Thumbnail Management: Upload, test, and optimize video thumbnails
  • 👥 Subscription Management: Track and analyze subscriber growth and behavior
  • 🔒 Secure API: Powered by N8N Tools platform with usage tracking and validation

🚀 Quick Start

Installation

Install this node in your N8N instance:

Via Community Nodes (Recommended)

  1. Go to Settings > Community Nodes in your N8N interface
  2. Click Install a community node
  3. Enter n8n-nodes-n8ntools-youtube
  4. Click Install

Via npm

npm install n8n-nodes-n8ntools-youtube

Setup Credentials

  1. Sign up at N8N Tools and get your API key
  2. In N8N, create new N8N Tools API credentials
  3. Enter your API URL: https://api.n8ntools.io
  4. Enter your API key
  5. Configure YouTube OAuth2 credentials for channel access

📋 Available Resources

🎥 Videos (12 Operations)

Complete video lifecycle management:

Operation Description Official Node Enhanced
Upload Video Upload videos with metadata
Get Video Retrieve video details ✅ Basic ✅ Full API
Update Video Modify video settings
Delete Video Remove videos
Get Video Statistics Detailed analytics
Set Thumbnail Upload custom thumbnails
Get Video Ratings Like/dislike data
Rate Video Like/dislike videos
Report Video Report inappropriate content
Add to Playlist Organize video content
Get Related Videos Find similar content
Schedule Publication Schedule video releases

📺 Channels (10 Operations)

Comprehensive channel management system:

  • Get Channel Info: Detailed channel statistics and metadata
  • Update Channel: Modify channel settings and branding
  • Get Channel Videos: All videos from specific channels
  • Get Channel Playlists: All playlists owned by channel
  • Subscribe to Channel: Manage subscriptions
  • Get Channel Sections: Channel layout and organization
  • Update Channel Art: Upload channel banners and avatars
  • Get Channel Analytics: Performance metrics and insights
  • Verify Channel: Channel verification process
  • Get Channel Subscribers: Subscriber list and analytics

📋 Playlists (8 Operations)

Advanced playlist management capabilities:

  • Create Playlist: Create new video collections
  • Get Playlist: Retrieve playlist information
  • Update Playlist: Modify playlist settings
  • Delete Playlist: Remove playlists
  • Add Video to Playlist: Organize video content
  • Remove Video: Remove videos from playlists
  • Get Playlist Items: All videos in playlist
  • Reorder Playlist: Change video order

💬 Comments (9 Operations)

Full comment moderation and engagement system:

  • Get Video Comments: Retrieve all comments with threading
  • Create Comment: Reply to videos and comments
  • Update Comment: Edit comment content
  • Delete Comment: Remove inappropriate comments
  • Like Comment: Engage with community
  • Report Comment: Report policy violations
  • Set Moderation Status: Approve or reject comments
  • Get Comment Threads: Nested comment conversations
  • Pin Comment: Highlight important comments

🔴 Live Streaming (12 Operations)

Complete live streaming management:

  • Create Live Broadcast: Schedule and set up streams
  • Start Live Stream: Begin broadcasting
  • Stop Live Stream: End broadcasts
  • Get Live Chat Messages: Real-time chat interaction
  • Send Live Chat Message: Interact with viewers
  • Ban Chat User: Moderate live chat
  • Get Stream Health: Monitor broadcast quality
  • Update Stream Settings: Modify during broadcast
  • Get Live Stream Analytics: Real-time metrics
  • Create Stream Key: Generate streaming credentials
  • Test Stream: Pre-broadcast testing
  • Archive Stream: Save broadcasts

📊 Analytics (8 Operations)

Advanced analytics and reporting system:

  • Get Channel Analytics: Comprehensive channel metrics
  • Get Video Analytics: Individual video performance
  • Get Playlist Analytics: Playlist engagement metrics
  • Get Revenue Analytics: Monetization data
  • Get Audience Analytics: Viewer demographics
  • Get Traffic Analytics: Traffic sources and patterns
  • Get Device Analytics: Device and platform breakdown
  • Get Geographic Analytics: Global audience distribution

📝 Captions (7 Operations)

Multilingual captions and accessibility:

  • Upload Captions: Add subtitle files
  • Get Video Captions: Retrieve all caption tracks
  • Update Captions: Modify existing captions
  • Delete Captions: Remove caption tracks
  • Download Captions: Export caption files
  • Auto-Generate Captions: AI-powered transcription
  • Translate Captions: Multi-language support

🏘️ Community Posts (6 Operations)

YouTube Community tab management:

  • Create Community Post: Share updates and polls
  • Get Community Posts: Retrieve all posts
  • Update Community Post: Modify post content
  • Delete Community Post: Remove posts
  • Like Community Post: Engage with posts
  • Get Post Comments: Post-specific comments

💎 Channel Memberships (8 Operations)

Membership and monetization features:

  • Get Membership Levels: Available membership tiers
  • Create Membership Level: Design membership benefits
  • Update Membership Level: Modify membership perks
  • Get Members: List channel members
  • Get Membership Analytics: Member retention metrics
  • Create Member-Only Post: Exclusive content
  • Get Member Perks: Available benefits
  • Send Member Survey: Gather feedback

💰 Super Chat & Thanks (5 Operations)

Fan funding and monetization analytics:

  • Get Super Chat Events: Fan funding messages
  • Get Super Thanks Events: Appreciation messages
  • Get Revenue Analytics: Monetization breakdown
  • Get Top Contributors: Most supportive fans
  • Generate Revenue Report: Financial summaries

🖼️ Thumbnails (4 Operations)

Thumbnail optimization and testing:

  • Upload Thumbnail: Custom thumbnail images
  • Get Thumbnail Options: Available thumbnail choices
  • Test Thumbnails: A/B test thumbnail performance
  • Generate Thumbnails: Auto-generate options

👥 Subscriptions (6 Operations)

Subscription management and analytics:

  • Get Subscriptions: Channel subscription list
  • Subscribe to Channel: Manage subscriptions
  • Unsubscribe: Remove subscriptions
  • Get Subscription Analytics: Growth metrics
  • Get Subscriber Feed: Recent activity
  • Notify Subscribers: Channel announcements

💡 Usage Examples

Complete Video Upload Workflow

// Upload video with metadata
Resource: "Videos"
Operation: "Upload Video"
Additional Options: {
  "title": "Amazing Tutorial: Complete Guide",
  "description": "Learn everything you need to know about this topic...",
  "tags": ["tutorial", "guide", "education"],
  "categoryId": "27", // Education
  "privacy": "public",
  "file": "/path/to/video.mp4",
  "thumbnail": "/path/to/thumbnail.jpg"
}

// Get video analytics after upload
Resource: "Analytics"
Operation: "Get Video Analytics"
Video ID: "abc123xyz"
Additional Options: {
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "metrics": ["views", "likes", "comments", "shares", "watch_time"]
}

Live Streaming Setup

// Create live broadcast
Resource: "Live Streaming"
Operation: "Create Live Broadcast"
Additional Options: {
  "title": "Live Q&A Session",
  "description": "Join us for a live discussion!",
  "scheduled_start_time": "2024-06-15T19:00:00Z",
  "privacy": "public",
  "enable_dvr": true,
  "enable_content_encryption": false
}

// Monitor live chat
Resource: "Live Streaming"
Operation: "Get Live Chat Messages"
Live Chat ID: "live_chat_123"
Additional Options: {
  "max_results": 200,
  "include_super_chat": true
}

// Send message to live chat
Resource: "Live Streaming"
Operation: "Send Live Chat Message"
Live Chat ID: "live_chat_123"
Additional Options: {
  "message": "Thanks everyone for joining! 👋",
  "pin_message": true
}

Channel Management Automation

// Get comprehensive channel analytics
Resource: "Analytics"
Operation: "Get Channel Analytics"
Additional Options: {
  "start_date": "2024-01-01",
  "end_date": "2024-03-31",
  "metrics": [
    "views", "subscribers", "estimated_minutes_watched",
    "average_view_duration", "comments", "likes"
  ],
  "dimensions": ["day", "video", "country"]
}

// Update channel branding
Resource: "Channels"
Operation: "Update Channel"
Additional Options: {
  "title": "My Updated Channel Name",
  "description": "Welcome to our channel! We create amazing content about...",
  "keywords": "education,technology,tutorials",
  "banner_image": "/path/to/banner.jpg"
}

Comment Moderation Workflow

// Get all comments for moderation
Resource: "Comments"
Operation: "Get Video Comments"
Video ID: "abc123xyz"
Additional Options: {
  "max_results": 100,
  "order": "relevance",
  "include_replies": true
}

// Moderate inappropriate comment
Resource: "Comments"
Operation: "Set Moderation Status"
Comment ID: "comment123"
Additional Options: {
  "moderation_status": "rejected",
  "ban_author": false
}

// Reply to important comment
Resource: "Comments"
Operation: "Create Comment"
Additional Options: {
  "parent_id": "comment456",
  "text": "Thank you for your question! Here's the answer...",
  "pin_comment": true
}

Membership Program Management

// Create membership level
Resource: "Memberships"
Operation: "Create Membership Level"
Additional Options: {
  "pricing": {
    "amount": 4.99,
    "currency": "USD"
  },
  "duration": "P1M", // Monthly
  "perks": [
    "Exclusive videos",
    "Members-only live streams",
    "Custom badges",
    "Priority comment replies"
  ]
}

// Get membership analytics
Resource: "Memberships"
Operation: "Get Membership Analytics"
Additional Options: {
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "metrics": ["new_members", "cancelled_members", "revenue"]
}

// Create member-only content
Resource: "Community Posts"
Operation: "Create Community Post"
Additional Options: {
  "content": "Exclusive behind-the-scenes content for our amazing members! 🎉",
  "visibility": "members_only",
  "include_poll": false
}

⚙️ Configuration Options

Video Upload Settings

  • Quality: 1080p, 1440p, 2160p (4K), 4320p (8K)
  • Privacy: Public, unlisted, private, scheduled
  • Monetization: Enable ads, channel memberships, Super Chat
  • Captions: Auto-generate, upload custom, multiple languages

Live Streaming Options

  • Stream Quality: 720p, 1080p, 1440p, 2160p
  • DVR: Enable/disable stream recording
  • Chat Moderation: Auto-moderation, custom filters
  • Monetization: Super Chat, channel memberships

Analytics Configuration

  • Date Ranges: Custom, preset periods
  • Metrics: Views, watch time, engagement, revenue
  • Dimensions: Geographic, device, traffic source
  • Filtering: Content type, audience, performance

🛠️ Example Workflows

Automated Content Publishing

[Content Creation] → [YouTube Enhanced: Upload Video] → [YouTube Enhanced: Set Thumbnail] → [YouTube Enhanced: Add to Playlist] → [YouTube Enhanced: Schedule Publication]

Live Streaming Management

[Schedule Stream] → [YouTube Enhanced: Create Broadcast] → [YouTube Enhanced: Start Stream] → [YouTube Enhanced: Monitor Chat] → [YouTube Enhanced: Archive Stream]

Community Management

[YouTube Enhanced: Get Comments] → [Sentiment Analysis] → [YouTube Enhanced: Moderate Comments] → [YouTube Enhanced: Reply to Comments] → [Generate Reports]

Analytics Dashboard

[YouTube Enhanced: Get Channel Analytics] → [YouTube Enhanced: Get Video Analytics] → [Data Processing] → [Generate Dashboard] → [Send Reports]

📊 Comparison with Official YouTube Node

Feature Category Official Node YouTube Enhanced Improvement
Videos 1 operation 12 operations +1100%
Channels 0 operations 10 operations ∞ (new)
Playlists 0 operations 8 operations ∞ (new)
Comments 0 operations 9 operations ∞ (new)
Live Streaming 0 operations 12 operations ∞ (new)
Analytics 0 operations 8 operations ∞ (new)
Captions 0 operations 7 operations ∞ (new)
Community Posts 0 operations 6 operations ∞ (new)
Memberships 0 operations 8 operations ∞ (new)
Super Chat & Thanks 0 operations 5 operations ∞ (new)
Thumbnails 0 operations 4 operations ∞ (new)
Subscriptions 0 operations 6 operations ∞ (new)
Total Operations 1 operation 95 operations +9400%

🔧 API Endpoints

All operations are routed through N8N Tools API for consistent authentication:

Resource Base Endpoint
Videos /api/v1/youtube/videos/
Channels /api/v1/youtube/channels/
Playlists /api/v1/youtube/playlists/
Comments /api/v1/youtube/comments/
Live Streaming /api/v1/youtube/live/
Analytics /api/v1/youtube/analytics/
Captions /api/v1/youtube/captions/
Community Posts /api/v1/youtube/community/
Memberships /api/v1/youtube/memberships/
Super Chat /api/v1/youtube/superchat/
Thumbnails /api/v1/youtube/thumbnails/
Subscriptions /api/v1/youtube/subscriptions/

🚨 Error Handling

Comprehensive error handling with YouTube-specific error codes:

{
  "error": "VIDEO_NOT_FOUND",
  "success": false,
  "resource": "videos",
  "operation": "getVideo",
  "details": {
    "issue": "The specified video does not exist or is private",
    "field": "video_id",
    "value": "invalid_video_id"
  }
}

💸 Pricing & Limits

  • Standard Operations: 1 credit per API call
  • Video Upload: 3-5 credits based on video size and quality
  • Live Streaming: 2 credits per hour of streaming
  • Analytics Operations: 1-2 credits depending on data volume
  • Bulk Operations: 1 credit per item processed
  • Rate Limits: Respects YouTube's quota system
  • Usage Tracking: Real-time credit monitoring

🔧 Troubleshooting

Common Issues

Authentication Errors

  • Verify N8N Tools API key is valid and active
  • Check YouTube OAuth2 credentials and scopes
  • Ensure channel has proper permissions for operations

Video Upload Failures

  • Check video format (MP4, MOV, AVI, etc.)
  • Verify file size limits (128GB max for most accounts)
  • Ensure stable internet connection for large uploads

Quota Exceeded Errors

  • Monitor YouTube API quota usage
  • Implement exponential backoff for retries
  • Consider upgrading YouTube API quota if needed

Live Streaming Issues

  • Verify channel is eligible for live streaming
  • Check encoder settings and stream key
  • Ensure stable internet connection (recommended: 5+ Mbps upload)

📈 Performance Tips

  1. Batch Operations: Use bulk APIs for multiple operations
  2. Video Optimization: Use recommended formats and settings
  3. Thumbnail Testing: A/B test thumbnails for better CTR
  4. SEO Optimization: Use relevant keywords in titles and descriptions
  5. Analytics Monitoring: Regular performance tracking for growth

🆘 Support

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❤️ by N8N Tools

Discussion