YouTube Scraper Extract comprehensive data from YouTube including videos, channels, playlists, and search results. This Actor supports multiple filters, languages, and countries for customized data collection. ## Features - 🔍 Search Functionality: Search YouTube with keywords - 📺 Channel Scraping: Extract videos from YouTube channels using handles or URLs - 📋 Playlist Support: Scrape entire playlists - 🔗 URL Processing: Direct video, channel, and playlist URL scraping - 🌍 Multi-language Support: Configure language and country settings - ⚡ Fast & Efficient: Optimized for speed and reliability - 📊 Rich Data: Get views, likes, duration, channel info, and more ## Input Configuration ### Basic Options - Start URLs: YouTube URLs (videos, channels, playlists) - Keywords: Search terms to find videos - YouTube Handles: Channel handles (e.g., @MrBeast) - Max Items: Maximum number of videos to scrape - Max Items Per Query: Limit per keyword/channel/playlist ### Filters - Location (gl): Country code (US, GB, DE, etc.) - Language (hl): Language code (en, de, fr, etc.) - Upload Date: Filter by recency (hour, today, week, month, year) - Duration: Filter by video length (short, medium, long) - Sort By: Order results (relevance, upload date, view count, rating) ### Advanced Options - Get Trending: Retrieve trending videos - Get Channel Info: Include detailed channel information - Proxy Configuration: Configure proxy settings ## Output Each scraped video includes: json { "type": "video", "id": "VMYmerFEvHE", "title": "Video Title", "url": "https://www.youtube.com/watch?v=VMYmerFEvHE", "description": "Full video description...", "duration": 170, "views": 430284, "likes": 0, "channel.id": "UCFVEEjwyX0_wZkCcwHE8tig", "channel.name": "Channel Name", "channel.url": "https://www.youtube.com/channel/UCFVEEjwyX0_wZkCcwHE8tig", "channelIcon": "https://yt3.ggpht.com/...", "thumbnails": { "id": "VMYmerFEvHE", "width": 720, "height": 404, "url": "https://i.ytimg.com/vi/VMYmerFEvHE/hq720.jpg" }, "isLive": false, "isShorts": false, "isPrivate": false, "keywords": ["keyword1", "keyword2", "keyword3"], "embedUrl": "https://www.youtube.com/embed/VMYmerFEvHE", "isFamilySafe": true, "publishDate": "2025-05-06T12:00:00.000Z", "uploadDate": "2025-05-06T12:00:00.000Z" } ## Usage Examples ### Example 1: Search for Videos json { "keywords": ["apify tutorial", "web scraping"], "maxItems": 50, "sortBy": "view_count" } ### Example 2: Scrape a Channel json { "youtubeHandles": ["@MrBeast"], "maxItemsPerQuery": 100, "getChannelInfo": true } ### Example 3: Extract Playlist Videos json { "startUrls": [ { "url": "https://www.youtube.com/playlist?list=PLxxxxxx" } ], "maxItems": 200 } ### Example 4: Multiple Sources json { "keywords": ["javascript tutorial"], "youtubeHandles": ["@FireshipIO"], "startUrls": [ { "url": "https://www.youtube.com/@Fireship" } ], "maxItems": 100, "uploadDate": "month" } ## Limitations - Rate limiting applies based on YouTube's policies - Subscriber counts and like counts are not available due to YouTube API limitations - Some data may require authentication - Proxy usage recommended for high-volume scraping ## Support For issues or questions, please create an issue in the repository.