discovering-viral-youtube-videos-by-category

按类别发现热门 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 和上述输入。

---

评分与排名

为每个视频评分：

• views → 归一化到 0-1（上限为 10M），权重 0.40
• likes → 归一化到 0-1（上限为 500K），权重 0.35
• recency（趋势视频按定义为 1.0），权重 0.25

score = 0.40 * min(views / 10000000, 1.0) + 0.35 * min(likes / 500000, 1.0) + 0.25

---

分类

分数	等级	标签
≥ 0.70	A	MEGA_VIRAL
0.40–0.69	B	TRENDING
< 0.40	C	RISING

---

边缘情况

• 该国家/地区不提供此类别：有些国家/地区仅提供 n（全部）。请回退到 type=n。
• 数据过期：趋势会在一天内不断变化——数据只是某个时间点的快照。
• 音乐/电影类别：返回完整歌曲或预告片——内容类型与普通视频不同。
• 结果中包含直播：isLive=true 的项目是正在进行的直播——如果只需要点播视频，请进行筛选。
• 国家/地区不匹配：gl 必须是有效的 ISO 国家/地区代码（例如：us、gb、de）。