🎬 YouTube Video Downloader - High Quality Video & Audio Extractor

Download YouTube videos and audio in multiple formats and qualities with metadata extraction, thumbnails, captions, and direct download links. Supports regular videos and YouTube Shorts!

📋 Table of Contents

• 🚀 Features
• 🎯 Use Cases
• ⚡ Quick Start
• 📊 Input Parameters
• 📤 Output Format
• 🔧 Configuration
• 📈 Performance
• ❓ FAQ
• 🛠️ Troubleshooting
• 📞 Support

🚀 Features

🎥 Video Download Capabilities

• ✅ Multiple Quality Options - Download in 240p, 360p, 480p, 720p, 1080p, and higher
• ✅ Multiple Format Support - MP4, WebM, and adaptive streaming formats
• ✅ Audio Extraction - Extract high-quality audio tracks
• ✅ YouTube Shorts Support - Full compatibility with YouTube Shorts
• ✅ Batch Processing - Download multiple videos simultaneously

📊 Metadata Extraction

• ✅ Complete Video Information - Title, description, duration, view count
• ✅ Channel Details - Channel name, ID, and subscriber information
• ✅ Keywords & Tags - SEO keywords and video tags
• ✅ Thumbnails - Multiple thumbnail sizes and formats
• ✅ Captions & Subtitles - Multi-language subtitle support

🌍 Global Support

• ✅ Geo-Location Optimization - Country-specific content delivery
• ✅ Multi-Language Support - Audio tracks in various languages
• ✅ Regional Content Access - Access region-specific videos

🎯 Use Cases

Use Case	Description	Benefits
🎓 Educational Content	Download educational videos for offline learning	Access content without internet, create learning materials
📱 Content Creation	Extract video content for editing and remixing	High-quality source material, multiple format options
📊 Market Research	Analyze video metadata and engagement metrics	Competitor analysis, trend identification
🎵 Music Collection	Extract audio from music videos	High-quality audio files, metadata preservation
📚 Content Archiving	Backup important video content	Long-term preservation, offline access
🌐 Multi-Platform Distribution	Prepare content for various platforms	Format optimization, quality variants

⚡ Quick Start

1️⃣ Basic Usage

{
  "video_urls": [
    "https://www.youtube.com/watch?v=RgKAFK5djSk",
    "https://youtu.be/dQw4w9WgXcQ"
  ],
  "country_code": "us",
  "language": "en"
}

2️⃣ Advanced Configuration

{
  "video_urls": [
    "https://www.youtube.com/watch?v=RgKAFK5djSk"
  ],
  "country_code": "us",
  "language": "en",
  "include_formats": true,
  "include_captions": true,
  "include_thumbnails": true
}

📊 Input Parameters

Parameter	Type	Required	Description	Example
video_urls	Array	✅	List of YouTube video URLs	["https://youtube.com/watch?v=..."]
country_code	String	✅	ISO 3166 country code	"us", "in", "gb"
language	String	❌	Language code for audio	"en", "es", "fr"
include_formats	Boolean	❌	Include all video formats	true (default)
include_captions	Boolean	❌	Include subtitle information	true (default)
include_thumbnails	Boolean	❌	Include thumbnail URLs	true (default)

🔗 Supported URL Formats

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://www.youtube.com/embed/VIDEO_ID
• https://m.youtube.com/watch?v=VIDEO_ID
• Direct video ID: VIDEO_ID

📤 Output Format

🎬 Video Data Structure

{
  "source": "youtube",
  "video_id": "RgKAFK5djSk",
  "title": "Video Title",
  "description": "Video description...",
  "duration_seconds": 237,
  "view_count": "1000000",
  "channel_title": "Channel Name",
  "channel_id": "UC...",
  "keywords": ["keyword1", "keyword2"],
  "thumbnails": [...],
  "formats": [...],
  "adaptive_formats": [...],
  "captions": {...}
}

📊 Format Information

Each format includes:

• Quality Label (240p, 360p, 480p, 720p, 1080p)
• File Size and Bitrate
• Direct Download URL
• MIME Type and Codecs
• Resolution (width × height)

🔧 Configuration

🌍 Country Codes

Region	Code	Description
🇺🇸 United States	us	Best for global content
🇬🇧 United Kingdom	gb	European content
🇮🇳 India	in	South Asian content
🇩🇪 Germany	de	Central European content
🇯🇵 Japan	jp	Asian content
🇧🇷 Brazil	br	South American content

🗣️ Language Codes

Language	Code	Audio Support
English	en	✅ Primary
Spanish	es	✅ Full
French	fr	✅ Full
German	de	✅ Full
Hindi	hi	✅ Full
Japanese	ja	✅ Full

📈 Performance

⚡ Speed Metrics

• Processing Time: ~2-5 seconds per video
• Batch Processing: Up to 50 videos simultaneously
• API Response: Sub-second metadata extraction
• Download Links: Instant generation

🔄 Reliability Features

• Automatic Retry Logic - Handles temporary failures
• Rate Limiting - Prevents API throttling
• Error Handling - Comprehensive error reporting

❓ FAQ

Q: What video qualities are supported?

A: We support all YouTube quality levels from 240p to 4K (2160p), including:

• 240p, 360p, 480p (Standard Definition)
• 720p, 1080p (High Definition)
• 1440p, 2160p (Ultra High Definition)

Q: Can I download YouTube Shorts?

A: Yes! Our actor fully supports YouTube Shorts with the same quality and metadata extraction capabilities.

Q: Are there any usage limits?

A: Usage depends on your Apify subscription plan. The actor is optimized for efficient API usage.

Q: How do I get the best download speeds?

A: Use the correct country_code parameter matching your server location for optimal CDN routing.

Q: Can I extract only audio?

A: Yes! The adaptive_formats include audio-only streams in various qualities and formats.

Q: What about copyright concerns?

A: This tool is for personal use and research. Users are responsible for complying with YouTube's Terms of Service and copyright laws.

🛠️ Troubleshooting

🚨 Common Issues

Issue	Cause	Solution
"Invalid YouTube URL"	Malformed URL	Check URL format, ensure it's a valid YouTube link
"Video not available"	Private/deleted video	Verify video exists and is public
"Country code required"	Missing parameter	Add valid ISO 3166 country code

🔍 Debug Tips

1. Verify URLs - Test URLs in browser first
2. Check Logs - Review actor run logs for detailed errors
3. Test Single Video - Start with one video before batch processing
4. Validate Parameters - Ensure all required fields are provided

📞 Support

🆘 Need Help?

• 📧 Issues: Report bugs and feature requests
• 💬 Community: Join our developer community
• 📖 Documentation: Comprehensive guides and examples
• 🎯 Best Practices: Optimization tips and tricks

🔗 Useful Links

• Actor Documentation
• YouTube API Guidelines

---

🏷️ Find Me

youtube downloader, youtube video extractor, youtube api, video metadata, youtube shorts, youtube video download, youtube audio extraction, youtube thumbnail extractor, youtube caption downloader, youtube batch video processing, youtube scraper, youtube video quality, youtube apify actor, youtube automation. youtube captions downloader, youtube storyboards downloader

---

⭐ Star this actor if it helps you download YouTube content efficiently!

Built with ❤️ using Apify Platform