youtube/
trending-shorts

入力不要で、いまYouTubeでトレンド入りしているショートをサンプリングし、タイトル、チャンネル、視聴回数、高評価数、コメント数、再生時間、正確な公開日時を返します。

YouTube Trending Shorts API

入力不要
実行ごとに新しいサンプル
視聴回数・高評価数・コメント数
結果1件あたり0.5クレジット
準備完了
README

SocQ 編集 · 更新

YouTube Trending Shorts

トレンド入りしたショートは、YouTubeがいま幅広い視聴者に届けている縦型動画で、それぞれタイトル、投稿したチャンネル、視聴回数、高評価数、コメント数、長さ、正確な公開日時を持ちます。これらをあわせて見ると、どのテーマ、フォーマット、クリエイターが伸びているのか、そしてショートが公開後どれだけの速さで視聴回数を集めるのかがわかります。

YouTube Trending Shorts API の主な機能

  • トレンドプールから直接取得入力項目はありません。実行するたびに、YouTubeがその時点で推しているショートを1回あたり約48件取得し、複数回の取得結果は重複なく results_limit までまとめます。
  • ショートごとに3つのエンゲージメント指標metrics には視聴回数と高評価数の正確な値に加えて、YouTubeに表示されるコメント数が入るため、議論が活発なショートと、見られているだけのショートを見分けられます。
  • すべてのショートにチャンネル情報author にはチャンネルID、ハンドル、名前、URL、アイコンが入っており、そのままチャンネル単位のAPIに渡せます。
  • 公開日時と長さpublished_at はUTCでの正確なアップロード日時、duration_seconds は再生時間です。あわせて見れば、トレンド入りしたショートがどれだけ新しく、どれだけの長さなのかがわかります。
  • キャプションからハッシュタグを抽出タイトルや説明文に書かれたタグを、先頭の # を除いて hashtags に一覧で返します。

YouTube Trending Shorts API のパラメータ

パラメータ必須説明
results_limit任意返すトレンドショートの件数です。1〜200で指定でき、デフォルトは48です。

YouTube Trending Shorts API の使い方

結果件数を任意で指定して送信し、タスク完了後にショートを読み取ります。

  1. {"results_limit": 48} を /v1/youtube/trending-shorts に POST します。本文は空でもかまいません。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からショートを読み取り、has_more が true の間は results.next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit":48}'

# Each item is one Short with metrics.views_count and author.
# Read them from GET /v1/tasks/{task_id}.

YouTube Trending Shorts API の主なユースケース

  • 毎日のトレンドスナップショット: 決まった時刻に実行して結果を保存し、トレンド入りしたショートに繰り返し登場するテーマやフォーマットを把握します。
  • 急成長中のクリエイターの発見: views_count と published_at を比べ、新しい投稿が数日で数百万回の視聴を集めているチャンネルを見つけます。
  • ショートのハッシュタグ観測: トレンド入りしたショート全体でハッシュタグを集計し、今週バズっている短尺動画にどのタグが付いているかを確認します。

YouTube Trending Shorts API 活用のヒント

  • 実行ごとに新しいサンプルになるため、保存するショートの id を記録し、数分おきの実行結果をまとめる際は重複を除いてください。
  • views_count を published_at からの経過時間で割ると、総視聴回数ではなく伸びの速さでショートを並べられます。
  • チャンネル登録者数やチャンネルの説明文も必要な場合は、author.url を YouTube Channels に渡してください。

YouTube Trending Shorts 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 Shorts API — よくある質問

YouTube Trending Shorts APIは、検索語を入力せずに、YouTubeがいまトレンドとして推しているショートをサンプリングするためのプログラムインターフェースです。各ショートのタイトル、チャンネル、視聴回数、高評価数、コメント数、再生時間、公開日時を返します。

実行ごとにトレンドプールから新しいサンプルを取得するため、数分違いの実行で共通するショートはわずかです。複数回の実行を予約して id で統合すると、トレンドの全体像をより広くつかめます。

results_limit は1〜200の範囲で指定できます。デフォルトは48で、トレンドプールからのおよそ1回分の取得量に相当します。

視聴回数と高評価数は正確です。views_count と likes_count は各ショートから取得した完全な整数です。comments_count はYouTubeに表示される数値に基づくため、1,000件を超えると 4.8K が4800になるように丸められた値になります。クリエイターが高評価数やコメント数を非表示にしている場合、該当するフィールドは null になります。

国を指定するパラメータはありません。実行するたびにその時点のトレンドプールにあるショートを返すため、定期的に実行して id で統合すると、プールの変化を追えます。

返されたショート1件につき0.5クレジットです。デフォルトの48件なら24クレジットになります。