scraping-youtube-playlist

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Scraping Youtube Playlist

抓取YouTube播放列表

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

参数	类型	是否必填	默认值	说明
`startUrls`	array	可选	`[]`	YouTube播放列表URL
`keywords`	array	可选	`[]`	用于查找播放列表的搜索关键词
`gl`	string	可选	`us`	国家代码（例如 `US` ）
`hl`	string	可选	`en`	语言代码（例如 `en` ）
`sort`	string	可选	`r`	排序顺序
`maxItems`	number	可选	无限制	返回的最大视频数量
`customMapFunction`	string	可选	—	用于转换每个输出对象的JavaScript函数

How to Run

运行方式

Using run_actor.js (recommended)

使用run_actor.js（推荐）

bash

undefined

bash

undefined

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

保存为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

保存为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

undefined

undefined

REST API fallback

REST API备选方案

bash

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.

bash

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}'

若Apify MCP可用：使用Apify MCP的

call_actor

工具，指定actor为

apidojo~youtube-playlist-scraper

并传入上述输入参数。

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

字段	类型	描述
`type`	string	始终为 `video`
`id`	string	视频ID
`title`	string	视频标题
`url`	string	视频URL
`description`	string	视频描述
`duration`	number	时长（秒）
`views`	number	观看量
`likes`	number	点赞数
`status`	string	可用状态
`channel.id`	string	频道ID
`channel.name`	string	频道名称
`channel.url`	string	频道URL
`keywords`	array	视频标签/关键词
`isLive`	boolean	直播标识
`isPrivate`	boolean	私有标识
`thumbnails`	array	缩略图对象

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.

私有播放列表：返回0条结果。告知用户该播放列表为私有。
已删除的播放列表：返回错误或空结果。请检查URL。
超大播放列表：使用maxItems限制结果数量，避免运行时间过长。
混合播放列表（YouTube自动生成）：表现可能与用户创建的播放列表不同。