youtube/
trending-videos

ニュース、ゲーム、スポーツなどのカテゴリと国を選ぶと、そのカテゴリの急上昇ページに並ぶ動画を順位どおりに返し、チャンネル、視聴回数、長さ、サムネイルもあわせて取得できます。

YouTube Trending Videos API

7つのカテゴリ
国を自由に指定
順位どおりに取得
結果1件あたり0.5クレジット
準備完了
README

SocQ 編集 · 更新

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に送信し、完了したタスクから順位付きのリストを読み取ります。

  1. {"category": "news", "region": "US", "results_limit": 50} を /v1/youtube/trending-videos に POST し、task_id を控えておきます。
  2. status が succeeded になるまで、数秒ごとに GET /v1/tasks/{task_id} を呼び出します。
  3. 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 に渡せば各急上昇動画で話されている内容を確認できます。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

YouTube Trending Videos API — よくある質問

YouTube Trending Videos APIは、ニュース、ゲーム、スポーツなどYouTubeのカテゴリ別急上昇動画を、指定した国について取得するためのプログラムインターフェースです。各動画の順位、タイトル、チャンネル、視聴回数、長さ、サムネイル、公開からの経過時間を返します。

YouTubeは2025年7月、1つにまとまっていた急上昇ページをカテゴリごとの急上昇リストに置き換え、ゲームの急上昇はゲームの探索ページに残しました。YouTube Trending Videos APIはこれらのカテゴリ別ページを読み取るため、追いたいカテゴリを選んで指定します。

region にその国の2文字コードを指定します。たとえば日本なら JP、ドイツなら DE です。国ごとに独自のリストがあるため、同じカテゴリでも市場によって並ぶ動画が異なります。

ニュース、ゲーム、スポーツ、学習、コース、ファッション、ショッピングです。1つのタスクで指定するカテゴリは1つなので、複数のカテゴリを取得するときはタスクを分けて実行してください。

results_limit で指定し、ランキングの上位から最大50件です。リストが短いカテゴリでは掲載されている分の動画が返り、料金は受け取った行の分だけです。

YouTube Trending Videos APIは返された動画1件につき0.5クレジットです。50件すべてなら25クレジット、上位10件なら5クレジットになります。