scraping-youtube-channel-info

抓取 YouTube 频道信息

原始数据收集。不假设具体用例——返回完整数据集，供下游分析使用。

---

输入

参数	类型	必填	默认值	说明
startUrls	array	可选	[]	YouTube 频道 URL
youtubeHandles	array	可选	[]	YouTube 账号标识（例如 @kurzgesagt）
keywords	array	可选	[]	用于查找频道的搜索关键词
gl	string	可选	us	国家代码（例如 US）
hl	string	可选	en	语言代码（例如 en）
sort	string	可选	r	排序顺序
maxItems	number	可选	不限	返回的频道数量上限
customMapFunction	string	可选	—	用于转换每个输出对象的 JavaScript 函数

运行方法

使用 run_actor.js（推荐）

# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~youtube-channel-scraper" --input '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~youtube-channel-scraper" --input '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~youtube-channel-scraper" --input '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}' --output results.json --format json

REST API 备用方案

curl -X POST "https://api.apify.com/v2/acts/apidojo~youtube-channel-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["cooking channel"], "gl": "us", "maxItems": 20}'

如果可以使用 Apify MCP： 使用 Apify MCP 的 call_actor 工具，指定 actor apidojo~youtube-channel-scraper 和上述输入。

---

输出字段

字段	类型	描述
id	string	YouTube 频道 ID
name	string	频道名称
url	string	频道 URL
description	string	频道描述
subscriberCount	number	订阅者数量
videosCount	number	已发布视频总数
thumbnails	array	频道缩略图
isVerified	boolean	已认证标记
isFamilySafe	boolean	适合家庭观看标记
keywords	array	频道关键词
availableCountries	array	可使用的国家/地区
tags	array	频道标签

边缘情况

• 找不到频道：检查账号标识是否正确，或改用 URL。
• subscriberCount 为文本：字段返回的是“1.2M subscribers”而非数字——如有需要，可在下游解析。
• 元数据中没有关键词：部分频道未设置关键词，因此标签数组将为空。
• 私人或已终止的频道：该频道不会返回任何结果。