scraping-youtube-trending-videos

抓取 YouTube 热门视频

原始数据收集。不预设使用场景——返回完整数据集，供下游分析使用。

---

输入

参数	类型	必填	默认值	说明
type	string	可选	n	热门类别：n（当前）、music、movies、gaming
gl	string	可选	us	国家/地区代码（例如：US、GB）
hl	string	可选	en	语言代码（例如：en）
maxItems	number	可选	不限	要返回的最大视频数
customMapFunction	string	可选	—	用于转换每个输出对象的 JavaScript 函数

运行方法

使用 run_actor.js（推荐）

# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~youtube-trending-scraper" --input '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}' --output results.json --format json

REST API 备用方案

curl -X POST "https://api.apify.com/v2/acts/apidojo~youtube-trending-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type": "n", "gl": "us", "hl": "en", "maxItems": 50}'

如果 Apify MCP 可用： 使用 Apify MCP 的 call_actor 工具，调用 actor apidojo~youtube-trending-scraper，并使用上述输入。

---

输出字段

字段	类型	说明
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	是否为直播
thumbnails	array	缩略图对象

边缘情况

• 类别没有结果：某些国家/地区可能没有所有类别页面。请回退到 type=n。
• 结果为空：YouTube 在不同会话中显示的热门内容可能不同——请重试。
• 地区不匹配：gl 和 hl 必须是有效的 ISO 代码。
• 数据时效性：热门内容变化频繁——数据反映某个时间点的快照。