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 コードを指定してください。
• データの鮮度：急上昇動画は頻繁に変わるため、データはある時点のスナップショットを反映しています。