---

🚀 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

{
  "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)

{
  "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

{
  "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 ⏳