🎥 YouTube Video & Channel Scraper: High-Fidelity Data Extractor

A professional, high-performance YouTube scraper designed for reliability and speed. Extract structured data from Search Keywords and Channel Uploads using a sophisticated dual-engine strategy (Direct JSON + yt-dlp) and native support for US Residential Proxies.

No API keys, no complex authentication, and no rate-limit headaches.

---

🌟 Key Features

• 🔍 Keyword Search: Extract up to 600+ videos per keyword query with deep metadata.
• 📺 Channel Scraper: Support for @handles, channel IDs, and URLs. Pull latest uploads with one click.
• 💎 High-Fidelity Metadata: Get Video IDs, Titles, Descriptions, exact View Counts, Relative Dates, and Durations.
• 🏢 Real Channel Insights: Captures Channel Avatar URLs, Subscriber Counts, and Verified Status.
• 🛡️ Built-in Proxy Support: Optimized for Apify Residential Proxies (Default: US) to ensure maximum uptime.
• 🚀 Dual-Engine Logic: Uses direct ytInitialData parsing for speed with a robust yt-dlp fallback for high-quota reliability.

---

🛠️ How it Works

This Actor avoids the overhead of a headless browser, making it significantly faster and cheaper to run.

1. Direct Extraction (Default): Directly parses YouTube's internal data layer for near-instant results.
2. Intelligent Fallback: If a query requires deep pagination (like fetching 100+ videos), the engine automatically triggers an optimized fallback to fill your quota without timing out.

---

📥 Input Parameters

Field	Type	Description
Keywords	array	One or more search terms (e.g., ["openclaw", "SaaS marketing"]).
Channels	array	List of channel handles or IDs (e.g., ["@mkbhd"]).
Max videos per keyword	number	The total number of videos to return for each search.
Max videos per channel	number	The number of recent uploads to fetch from each channel.
Proxy configuration	object	Recommended: Use Residential Proxies (set to US by default).

---

📤 Sample Output

The scraper returns clean, structured JSON ready for integration with your CRM, database, or analytics tool:

{
  "record_type": "video",
  "query_type": "direct_search",
  "query": "openclaw",
  "video_id": "dQw4w9WgXcQ",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "title": "OpenClaw Deep Dive: Future of AI",
  "view_count": 1250430,
  "view_count_text": "1,250,430 views",
  "published_text": "2 days ago",
  "duration_text": "12:45",
  "channel_name": "Tech Insider",
  "channel_handle": "@techinsider",
  "channel_subscribers_text": "1.2M subscribers",
  "scraped_at": "2026-04-19T21:00:00Z"
}

---

💡 Use Cases

• Market Research: Analyze video performance trends in specific niches.
• Sponsorship Tracking: Monitor product mentions and influencer activity.
• SEO & Content Strategy: Find high-view videos with low competition to model your titles.
• Brand Protection: Monitor mentions of your brand across new uploads.

---

⚖️ Legal Disclaimer

This tool is intended for research and educational purposes. Please ensure your use case complies with YouTube's Terms of Service and your local data privacy laws. We recommend using ethical scraping practices such as respecting robots.txt and using appropriate request delays.