YouTube Scraper Fast ⚡

High-performance YouTube data extractor optimized for speed and reliability. Extract essential video metadata 4-5x faster than traditional scrapers with no residential proxy required.

---

🚀 Key Features

• ⚡ 4-5x Faster: ~1.5-2s per video (vs 5-6s traditional scrapers)
• 💰 No Proxy Required: Works reliably without residential proxy (optional for high volume)
• 📊 12 Essential Fields: Focused on data that matters, 95-100% reliability
• 🔄 Smart Rate Limiting: Error-based exponential backoff (0s delay when smooth)
• 🌍 Localization: Country and language support
• 📦 Bulk Processing: Text file upload or remote file links
• 🎯 Multiple Inputs: Keywords, channels, playlists, direct URLs

Best for: Content research, SEO analysis, competitive intelligence, trend monitoring, influencer discovery

---

🎯 At a Glance

Feature	Value
Speed	~1.5-2s per video
Throughput	40-50 videos/minute (2,400-3,000/hour)
Fields	12 essential fields with 95-100% reliability
Proxy	Optional (works great without)
Concurrency	5 parallel video visits
Code Size	79% smaller than v2.4 (optimized for speed)

---

💡 Why This Scraper?

Traditional YouTube scrapers are slow and expensive. YouTube Scraper Fast fixes that:

Metric	YouTube Scraper Fast	Traditional Scrapers
Time per video	~1.5-2s	~5-6s
Proxy requirement	❌ Optional	✅ Required
Artificial delays	0s (error-based only)	3-8s per video
Field reliability	95-100% without proxy	10-50%
Cost per 1,000 videos	$0 (no proxy)	$0.50-$2 (proxy required)
Videos per minute	40-50	10-12

Performance Optimizations:

• Zero artificial delays (smart error-based backoff only)
• Streamlined field extraction (12 fields vs 30+)
• Multiple DOM fallbacks for reliability
• Resource blocking (video streams, fonts, ads)
• Optimized timeouts (20s data load, 40s navigation)

---

📋 Input Parameters

Field	Key	Type	Default	Description
Search Keywords	searchQueries	Array	[]	Search terms, topics, or channel handles (@name)
YouTube URLs	startUrls	Array<Object|string>	[]	Direct video/channel/playlist URLs. Supports file upload
Include Shorts	includeShorts	boolean	false	Include YouTube Shorts in results
Max Results	maxResultsPerQuery	integer	10	Max videos per search term/channel
Country	regionCode	string	"US"	ISO country code (US, GB, CA, AU, etc.)
Language	language	string	"en"	Language code (en, es, de, fr, etc.)
From Date	dateFrom	string	""	Filter start date (YYYY-MM-DD). Search keywords only
To Date	dateTo	string	""	Filter end date (YYYY-MM-DD). Search keywords only
Use Proxy	useResidentialProxy	boolean	false	Enable residential proxy (optional, costs apply)
Proxy Country	proxyCountryCode	string	""	Proxy exit country (e.g., "US", "AU")

Important Notes:

• 📅 Date filtering only applies to Search Keywords, not Direct URLs
• 📁 Bulk upload: Upload text file (one URL per line) or link to remote file
• 🌐 Proxy: Optional - scraper works reliably without it for most use cases

---

📤 Output Schema

Performance-Optimized: 12 Essential Fields

All fields have multiple extraction fallbacks for 95-100% reliability without proxy.

#	Field	Type	Description	Reliability
1	type	String	One of: video, shorts, live	✅ 100%
2	VideoId	String	YouTube video ID (e.g., dQw4w9WgXcQ)	✅ 100%
3	PageURL	String	Full YouTube video URL	✅ 100%
4	title	String	Video title	✅ 100%
5	shortDescription	String | null	First 200 characters of description	✅ 95%
6	thumbnailUrl	String | null	Thumbnail URL (maxresdefault)	✅ 100%
7	duration	String | null	Duration in HH:MM:SS format	✅ 98%
8	isLiveContent	Boolean	Whether video is/was a live stream	✅ 100%
9	viewCount	Integer | null	Total view count	✅ 98%
10	likeCount	Integer | null	Total like count	✅ 95%
11	publishDate	String | null	Publish date (YYYY-MM-DD)	✅ 98%
12	channel	Object	Channel metadata (5 fields)	✅ 100%
12.1	channel.id	String | null	Channel ID (UC...)	✅ 98%
12.2	channel.name	String | null	Channel display name	✅ 100%
12.3	channel.handle	String | null	Channel handle (e.g., @username)	✅ 100%
12.4	channel.url	String | null	Full channel URL	✅ 100%
12.5	channel.subscriberCount	String | null	Subscriber count (e.g., "91K subscribers")	✅ 95%

Why These Fields?

• ✅ Essential for 90% of use cases (research, SEO, analytics)
• ✅ Fast extraction (no lazy-loaded content waits)
• ✅ Reliable without proxy (multiple DOM fallbacks)
• ✅ Clean data (no null-heavy bloat)

---

📊 Output Examples

Overview View (Key Fields)

{
  "type": "video",
  "VideoId": "E19_kwN0f38",
  "PageURL": "https://www.youtube.com/watch?v=E19_kwN0f38",
  "title": "GPT-5 Codex is the best way to build apps with AI ever (5 tricks you need to know)",
  "viewCount": 2176,
  "likeCount": 123,
  "duration": "16:39",
  "publishDate": "2025-10-09",
  "channel": {
    "id": "UCfQNB91qRP_5ILeu_S_bSkg",
    "name": "Alex Finn",
    "handle": "@AlexFinnOfficial",
    "url": "https://www.youtube.com/@AlexFinnOfficial",
    "subscriberCount": "41.9K subscribers"
  }
}

All Fields View

{
  "type": "video",
  "VideoId": "E19_kwN0f38",
  "PageURL": "https://www.youtube.com/watch?v=E19_kwN0f38",
  "title": "GPT-5 Codex is the best way to build apps with AI ever (5 tricks you need to know)",
  "shortDescription": "Enjoy the videos and music you love, upload original content, and share it all with friends, family, and the world on YouTube.",
  "thumbnailUrl": "https://i.ytimg.com/vi/E19_kwN0f38/maxresdefault.jpg",
  "duration": "16:39",
  "isLiveContent": false,
  "viewCount": 2176,
  "likeCount": 123,
  "publishDate": "2025-10-09",
  "channel": {
    "id": "UCfQNB91qRP_5ILeu_S_bSkg",
    "name": "Alex Finn",
    "handle": "@AlexFinnOfficial",
    "url": "https://www.youtube.com/@AlexFinnOfficial",
    "subscriberCount": "41.9K subscribers"
  }
}

Performance Benefits:

• ⚡ Lightweight: ~400 bytes per record (vs 2KB+ traditional)
• ⚡ Fast: ~1.5s extraction time
• ⚡ Reliable: 95-100% field population without proxy
• ⚡ Clean: No null-heavy bloat

---

🎬 Quick Start

Example 1: Search with Date Filter

{
  "searchQueries": ["AI tools", "machine learning", "@veritasium"],
  "maxResultsPerQuery": 20,
  "includeShorts": false,
  "dateFrom": "2025-01-01",
  "dateTo": "2025-12-31",
  "regionCode": "US",
  "language": "en"
}

Example 2: Direct Video URLs

{
  "startUrls": [
    {"url": "https://www.youtube.com/watch?v=7Sx0o-41r2k"},
    {"url": "https://www.youtube.com/watch?v=5oAnKSCP4do"}
  ],
  "maxResultsPerQuery": 10,
  "regionCode": "US",
  "language": "en"
}

Example 3: Bulk URL Upload (Remote File)

{
  "startUrls": [
    {
      "requestsFromUrl": "https://raw.githubusercontent.com/coregentdevspace/youtube-scraper-assets/main/youtube-scraper-pro-direct-url-text-file.txt"
    }
  ],
  "maxResultsPerQuery": 100,
  "useResidentialProxy": false
}

---

💪 Performance & Reliability

Architecture

• Concurrency: 5 parallel video page visits
• Timeouts: Optimized (20s data, 40s navigation, 45s handler)
• Rate Limiting: Error-based exponential backoff (2s→4s→8s→16s→30s)
• Resource Blocking: Blocks video streams, fonts, ads for speed
• DOM Fallbacks: Multiple extraction paths for each field

Smart Rate Limiting

Traditional scrapers add 3-8s artificial delays every video. YouTube Scraper Fast adds 0s delay when running smoothly, only backing off when errors occur.

• ✅ 0 errors: Full speed (no delays)
• ⚠️ 1-2 errors: 2-4s backoff
• ⚠️ 3-5 errors: 8-16s backoff
• ✅ 5 successes: Backoff resets to 0

Throughput Comparison

Videos	YouTube Scraper Fast	Traditional Scraper
10 videos	~15-20 seconds	~50-60 seconds
50 videos	~1.5 minutes	~4-5 minutes
100 videos	~2.5 minutes	~8-10 minutes
500 videos	~12 minutes	~40-50 minutes
1,000 videos	~25 minutes	~85 minutes

---

📚 Use Cases

• SEO Research: Analyze keywords, tags, titles, descriptions
• Content Strategy: Study successful formats, posting patterns
• Competitive Intelligence: Benchmark creators, track performance
• Market Research: Identify trends by topic, region, language
• Brand Monitoring: Find mentions and gauge engagement
• Influencer Discovery: Filter by views/engagement in your niche
• Trend Analysis: Spot emerging topics and viral patterns

---

❓ FAQ

Q: Do I need residential proxy? A: No! The scraper works reliably without proxy for most use cases. All 12 fields populate consistently (95-100%) without proxy. Enable proxy only for high-volume scraping or specific geo-targeting needs.

Q: What about Shorts and live videos? A: Toggle includeShorts to control Shorts inclusion. Live/live-replay videos are auto-detected via type and isLiveContent fields.

Q: Can I filter by date? A: Yes! Use dateFrom and dateTo (YYYY-MM-DD). Note: Date filtering only applies to Search Keywords, not Direct URLs.

Q: Can I target a specific country/language? A: Yes! Set regionCode and language. For stronger geo-targeting, enable useResidentialProxy and set proxyCountryCode.

Q: How do I bulk upload URLs? A: Upload a text file (one URL per line) or provide a requestsFromUrl pointing to a remote text file.

Q: Why are some fields removed compared to v2.4? A: We optimized for performance and reliability. Fields like category, tags, commentCount, and captions were unreliable (often null) and slowed extraction. The current 12 fields cover 90% of use cases with 95-100% reliability.

---

🛠️ Technologies & Architecture

Built with modern web scraping tools for maximum performance and reliability:

• Browser Engine: Puppeteer (headless Chrome) - Full JavaScript execution
• Framework: Crawlee - Enterprise-grade crawling with queue management
• Runtime: Node.js 18+ - Fast async processing
• Extraction: Direct parsing of YouTube's internal APIs (ytInitialData, ytInitialPlayerResponse)
• Anti-Detection: Advanced fingerprinting, human-like behavior, smart request handling
• Optimization: Resource blocking (video streams, fonts, ads), parallel processing, intelligent timeouts

Why These Technologies?

• ✅ Reliable data extraction from complex single-page applications
• ✅ Efficient handling of dynamic content and lazy loading
• ✅ Automatic retry logic and error recovery
• ✅ Scalable architecture for high-volume scraping

---

📋 Best Practices

1. Start small: Test with maxResultsPerQuery: 10
2. Filter early: Use dateFrom/dateTo to narrow results
3. Bulk wisely: Group URLs by topic/channel for better performance
4. Proxy optional: Only enable for high-volume or geo-specific needs
5. Export: JSON/CSV/Excel to your datastore, Google Sheets, or S3

---

📜 Changelog

v2.5 (Current - Performance Release)

• ⚡ 4-5x faster extraction (~1.5-2s per video vs 5-6s)
• ✅ Works without residential proxy (95-100% reliability)
• 📊 Optimized to 12 essential fields (from 30+)
• 🚀 79% code reduction (34KB vs 165KB)
• 💰 Zero artificial delays (error-based backoff only)
• 🎯 Enhanced channel field extraction (works with @handles)
• 📅 Date range filtering for search keywords
• 📁 Bulk URL upload via text file or remote link

v2.0

• Caption tracks in output
• Richer channel fields
• Improved localization

---

🤝 Compliance

• Intended for legitimate research & business intelligence
• Collects only public YouTube data
• Respect YouTube's Terms of Service
• Users responsible for compliance with applicable laws

---

💬 Support

• Issues: Report via GitHub or Apify support
• Feature requests: Open an issue with your use case
• Documentation: See /docs folder for detailed guides

---

Built with ❤️ for performance and reliability