YouTube Trending Videos
YouTubeのカテゴリ別急上昇ページは、ニュース、ゲーム、スポーツなどのカテゴリで国ごとに注目を集めている動画を順位付けして並べ、各動画の順位、チャンネル、視聴回数、長さ、公開からの経過時間を表示します。これらのランキングを追い続けると、ある市場でどのニュース、ゲーム、クリエイターが伸びているのか、そして動画がどれだけの速さでランキングに入り、入れ替わっていくのかがわかります。
YouTube Trending Videos API の主な機能
- 7つのカテゴリの急上昇ページcategory で news、gaming、sports、learning、courses、fashion、shopping のいずれかの急上昇ページを選べるため、各タスクでそのカテゴリの視聴者が見ているランキングをそのまま追えます。
- 2文字の国コードで国を指定region に US、GB、JP、BR などのコードを指定すると、その国版のページを取得します。同じカテゴリでも、国が違えば並ぶ動画が異なることがよくあります。
- すべての動画に順位を記録rank には1から始まる各動画の順位が category、region とともに入るため、複数のランキングを1つの表にまとめても各行の意味がわかります。
- 急上昇動画ごとのチャンネル情報author にはチャンネルID、名前、@ハンドル、リンク、アイコン、認証バッジが入っており、追加の照会なしで急上昇動画をチャンネル単位にまとめられます。
- 視聴回数、長さ、サムネイルmetrics.views_count、duration_seconds、thumbnail_url、そして text に入る説明文の抜粋が、急上昇ページでの見え方どおりに各動画を表します。
YouTube Trending Videos API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
category | 必須 | 取得する急上昇ページです。news、gaming、sports、learning、courses、fashion、shopping のいずれかを指定します。 |
region | 任意 | 急上昇ページの国を表す2文字の国コードです。US、GB、JP などを指定でき、デフォルトは US です。 |
results_limit | 任意 | ランキングの上位から返す動画の件数です。1〜50で指定でき、デフォルトは50です。 |
YouTube Trending Videos API の使い方
カテゴリと国を選んでYouTube Trending Videos APIに送信し、完了したタスクから順位付きのリストを読み取ります。
- {"category": "news", "region": "US", "results_limit": 50} を /v1/youtube/trending-videos に POST し、task_id を控えておきます。
- status が succeeded になるまで、数秒ごとに GET /v1/tasks/{task_id} を呼び出します。
- results.items の動画を rank の順に読み取ります。results.has_more が true の場合は、results.next_cursor を渡して次のページを読み込みます。
curl -X POST "https://api.socq.ai/v1/youtube/trending-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category":"gaming","region":"GB","results_limit":10}'
# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the ranked videos once status is succeeded.YouTube Trending Videos API の主なユースケース
- 市場ごとの毎朝のトレンドまとめ: 毎朝1つの国のニュースとスポーツのページを取得し、伸びているタイトル、チャンネル、視聴回数を順位付きで編集担当に渡します。
- ゲームの急上昇を追跡: 配信している国々でゲームのページを追い、動画やキャンペーンを計画する前に、勢いのあるゲーム、フォーマット、クリエイターをつかみます。
- 同じカテゴリを国どうしで比較: 同じカテゴリを複数の region コードで実行し、動画IDでリストを突き合わせて、国を越えて広がる動画と地元で伸びている動画を見分けます。
- 連絡するチャンネルのリスト作り: カテゴリの急上昇ページに繰り返し登場するチャンネルを、ハンドルや認証バッジとあわせて集め、タイアップ候補の最初のリストにします。
YouTube Trending Videos API 活用のヒント
- 同じカテゴリと国を決まった時刻に実行し、id で結果を結合してください。rank の変化から、順位を上げている動画と下げている動画がわかります。
- published_time_text は collected_at とあわせて読んでください。ページには「15 min ago」のように経過時間がテキストで表示されるため、おおよそのアップロード日時が必要なときは収集時刻からその分を差し引きます。
- 上位だけが必要なときは results_limit を10や20にしてください。YouTube Trending Videos APIは返された動画の件数に応じて課金されます。
- 集めた動画IDを YouTube Videos API に渡せば高評価数、コメント、説明文全体を、YouTube Transcripts API に渡せば各急上昇動画で話されている内容を確認できます。
関連API
YouTube Trending Videos API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。
- YouTube Channel Videos API — チャンネルURLから、ショートとライブ配信を除く通常の公開動画を取得します。
- YouTube Comments API — 公開コメント、投稿者、エンゲージメント、元の動画、会話の情報を取得します。
- YouTube Transcripts API — 取得可能なプレーンテキストの文字起こしを取得します。言語は任意で指定できます。
- YouTube Channels API — 公開チャンネルのアカウント情報、画像、認証状態、表示中のオーディエンス統計を取得します。
- YouTube Videos API — 既知の動画またはショートのURLから、メタデータ、サムネイル、再生時間、エンゲージメントを取得します。
- YouTube Shorts API — チャンネルごとに、公開ショート、サムネイル、再生時間、公開情報、エンゲージメントを取得します。
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API