apidojo-io Scraping Youtube Playlist
Raw data collection. No assumed use case — returns the full dataset for downstream analysis.
Inputs
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
startUrls |
array | Optional | [] |
YouTube playlist URLs |
keywords |
array | Optional | [] |
Search keywords to find playlists |
gl |
string | Optional | us |
Country code (e.g. US) |
hl |
string | Optional | en |
Language code (e.g. en) |
sort |
string | Optional | r |
Sort order |
maxItems |
number | Optional | Unlimited | Maximum videos to return |
customMapFunction |
string | Optional | — | JavaScript function to transform each output object |
How to Run
Using run_actor.js (recommended)
# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~youtube-playlist-scraper" --input '{"startUrls": ["https://www.youtube.com/playlist?list=PLABCDE12345"], "maxItems": 50}'
# Save as CSV
node scripts/run_actor.js --actor "apidojo~youtube-playlist-scraper" --input '{"startUrls": ["https://www.youtube.com/playlist?list=PLABCDE12345"], "maxItems": 50}' --output results.csv --format csv
# Save as JSON
node scripts/run_actor.js --actor "apidojo~youtube-playlist-scraper" --input '{"startUrls": ["https://www.youtube.com/playlist?list=PLABCDE12345"], "maxItems": 50}' --output results.json --format json
REST API fallback
curl -X POST "https://api.apify.com/v2/acts/apidojo~youtube-playlist-scraper/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"startUrls": ["https://www.youtube.com/playlist?list=PLABCDE12345"], "maxItems": 50}'
If Apify MCP is available:
Use the Apify MCP call_actor tool with actor apidojo~youtube-playlist-scraper and the input above.
Output Fields
| Field | Type | Description |
|---|---|---|
type |
string | Always video |
id |
string | Video ID |
title |
string | Video title |
url |
string | Video URL |
description |
string | Video description |
duration |
number | Duration in seconds |
views |
number | View count |
likes |
number | Like count |
status |
string | Availability status |
channel.id |
string | Channel ID |
channel.name |
string | Channel name |
channel.url |
string | Channel URL |
keywords |
array | Video tags/keywords |
isLive |
boolean | Live stream flag |
isPrivate |
boolean | Private flag |
thumbnails |
array | Thumbnail objects |
Edge Cases
- Private playlist: Returns 0 results. Tell user the playlist is private.
- Deleted playlist: Returns error or empty. Check URL.
- Very large playlist: Use maxItems to cap results and avoid long run times.
- Mix playlist (YouTube auto-generated): May behave differently than user-created playlists.