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 ツールを使用し、アクター 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 の項目は配信中です。VOD のみが必要な場合は除外してください。
• 国の不一致：gl は有効な ISO 国コード（例：us、gb、de）である必要があります。