🚀 YouTube Channel's Playlist Scraper ⚡

--- # 🚀 YouTube Channel Playlist Scraper – Surgical Content Extraction + Metadata Control 🎯📊 Scrape SPECIFIC playlists/videos by index 📍 from YouTube channels! Hybrid filtering 🔀 + metadata toggles 🕹️. Residential proxies 🌐 & Apify storage 📦. --- ## 🌟 Overview Need precision scraping of YouTube content? This actor now offers: ✅ Index-based selection: Target exact playlist/video positions (e.g., "2nd playlist, 5th video") ✅ Hybrid filtering: Combine index picks + bulk limits (maxPlaylists/maxVideosPerPlaylist) ✅ Metadata toggle: Remove view counts/tags with includeAdditionalInfo=false ✅ 1-based indexing: Human-friendly numbering (1=first item) Perfect for: 🔍 Targeted content audits 🎯 🧪 Dataset sampling for ML models ⚙️ API integrations needing light payloads > ⚡ New precision controls: > - playlistNumbers="3,7" → 3rd & 7th playlists > - videoNumbers="1,5" → 1st & 5th videos per playlist --- ## 🔥 Key Features ### 🎯 Surgical Selection - Position-Based Targeting: "2,5,8" = 2nd/5th/8th items - Negative Index Support (Planned): "-1" = last item in list - Hybrid Mode: Combine with maxPlaylists=10 to scan first 10 playlists THEN pick positions ### 📊 Metadata Management - includeAdditionalInfo Toggle: - true = Full metadata (views, likes, tags, descriptions) - false = Lightweight output (titles/URLs/thumbnails only) - 50% Data Reduction: When metadata disabled ### 🛠️ Enterprise-Grade - Index Validation: Auto-skips non-existent positions - Error Resilience: Continues after failed items - Proxy Rotation: Residential/IP pools for anti-blocking --- ## ⚙️ Input Configuration json { "channel_url": [ { "url": "https://www.youtube.com/@awakeningrecords", "method": "GET" } ], "includeAdditionalInfo": false, "maxPlaylists": 10, "maxVideosPerPlaylist": 10, "playlistNumbers": "2,5", "videoNumbers": "3,4", "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ### 📋 Input Fields Explained | Parameter | Type | Description | |-----------|------|-------------| | channel_url | Array | YouTube channel URLs (@handle or /channel links) | | includeAdditionalInfo | Boolean | false excludes views/tags/descriptions | | maxPlaylists | Number | 0=unlimited, 10=first 10 playlists | | maxVideosPerPlaylist | Number | 0=all videos, 10=first 10 videos | | playlistNumbers | String | Comma-separated playlist indexes (1-based) | | videoNumbers | String | Comma-separated video indexes per playlist | | proxy | Object | Residential proxies recommended | #### 🎚️ Parameter Interactions: 1. Priority Order: - playlistNumbers overrides maxPlaylists - videoNumbers overrides maxVideosPerPlaylist 2. Empty Values: - Blank playlistNumbers → Use maxPlaylists - Blank videoNumbers → Use maxVideosPerPlaylist --- ## 📤 Output Examples ### With includeAdditionalInfo=true (Default) json { "sourceChannel": "https://www.youtube.com/@awakeningrecords", "playlistTitle": "Awakening Music 2025", "playlistUrl": "https://www.youtube.com/playlist?list=PLoagsPg26SY4IHZw2ksuD_JRAYyy2mXn3", "playlistNumber": 3, "videoNumber": 1, "video_title": "Maher Zain & Harris J - Qalbi Fil Madinah | Official Music Video", "video_url": "https://www.youtube.com/watch?v=2VLqZtded_0", "channel_name": "Awakening Music", "duration": "4m 7s", "thumbnail": "https://i.ytimg.com/vi/2VLqZtded_0/maxresdefault.jpg", "additional_info": { "view_count": 15851657, "like_count": 316260, "tags": ["awakening music", "maher zain"], "description": "Watch Maher Zain & Harris J's new music video..." } } ### With includeAdditionalInfo=false json { "sourceChannel": "https://www.youtube.com/@awakeningrecords", "playlistTitle": "Awakening Music 2025", "playlistUrl": "https://www.youtube.com/playlist?list=PLoagsPg26SY4IHZw2ksuD_JRAYyy2mXn3", "playlistNumber": 3, "videoNumber": 1, "video_title": "Maher Zain & Harris J - Qalbi Fil Madinah | Official Music Video", "video_url": "https://www.youtube.com/watch?v=2VLqZtded_0", "channel_name": "Awakening Music" } --- ## 🆚 Competitive Edge | Feature | 🚀 This Actor | 🐌 Others | |---------|---------------|-----------| | Precision | Index-based + hybrid filtering | Bulk-only scraping | | Flexibility | Combine index picks & bulk limits | Either/or selection | | Data Control | Metadata toggle | All-or-nothing data | | Error Handling | Skips missing indexes | Fails entire job | --- ## 🛠️ How It Works 1. Input Parsing - Converts playlistNumbers="2,5" → [2,5] - Converts videoNumbers="3,4" → [3,4] 2. Playlist Processing - Fetches playlists up to maxPlaylists (10) - Filters to indexes 2 & 5 3. Video Extraction - From each selected playlist: - Fetches videos up to maxVideosPerPlaylist (10) - Filters to indexes 3 & 4 4. Output Generation - Includes/excludes metadata per includeAdditionalInfo - Returns Apify-encrypted dataset --- ## 💡 Use Cases 🎯 Targeted Analysis - Compare performance of 5th vs 10th playlist - Analyze video #3 patterns across playlists 📦 Lightweight API Feeds - Mobile apps needing minimal payload - Dashboard cards without engagement metrics 🔬 Academic Research - Study position bias in playlist engagement - Catalog specific content types by index --- ## ❓ Troubleshooting Issue: "Video index 4 not found in playlist 2" Fix: 1. Check playlist has ≥4 videos 2. Increase maxVideosPerPlaylist beyond 4 Issue: "Playlist 5 skipped - does channel have 5+ playlists?" Fix: - Verify channel's public playlists count - Use maxPlaylists=0 to scan all playlists Issue: "Additional info missing despite includeAdditionalInfo=true" Fix: - YouTube sometimes hides metrics - Retry with residential proxies --- ## 🧩 Related Tools ### 🎥 YouTube Ecosystem - Captions Scraper - Transcripts Extractor - Formats Analyzer ### 🎵 Music & Audio - Spotify Playlist Downloader - TikTok Audio Extractor --- ## 🚀 Deploy Now! First run initializes dependencies – allow 1-2 minutes ⏳