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 の使い方
結果件数を任意で指定して送信し、タスク完了後にショートを読み取ります。
- {"results_limit": 48} を /v1/youtube/trending-shorts に POST します。本文は空でもかまいません。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 に渡してください。
関連API
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 Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos 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
- YouTube Trending Videos API