YouTube Related Videos
関連動画は、YouTubeがある動画の横に次に見る動画として並べるおすすめで、それぞれタイトル、チャンネル、視聴回数、サムネイルとともに表示されます。この一覧からはYouTubeがどの動画やチャンネルを同じグループとみなしているかがわかり、ジャンルの全体像の把握、競合チャンネルの発見、対象動画の隣に並ぶコンテンツの企画に役立ちます。
YouTube Related Videos API の主な機能
- よく使われる動画リンクに対応watch URL、youtu.be の短縮リンク、ショートのリンク、ライブのリンクのいずれからも動画IDを読み取ります。
- 1回の実行で一覧全体を取得1つのタスクで、YouTubeがその動画に表示するおすすめの一覧全体(通常は約20本)を返します。
- 各おすすめ動画のチャンネルauthor には、おすすめ動画ごとのチャンネルID、名前、チャンネルURLが入ります。
- 視聴回数とサムネイルmetrics.views_count は 2.2M のようなYouTubeの表示用の回数から換算した値で、media には最大サイズのサムネイルが入ります。
YouTube Related Videos API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | YouTube動画のリンクです。watch URL、youtu.be リンク、ショートのリンク、ライブのリンクを指定できます。 |
YouTube Related Videos API の使い方
動画リンクを1つ送信し、おすすめ動画を読み取ります。
- {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} を /v1/youtube/related-videos に 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/related-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
# Each item is one recommended video with author and metrics.views_count.YouTube Related Videos API の主なユースケース
- 動画を起点にジャンルを把握: 反響の大きい動画からおすすめを取得し、その結果に対しても同じ処理を繰り返して、YouTubeがひとまとまりにしている動画群を描き出します。
- 競合チャンネルの発見: 自分の動画の横に各 author.id が何回現れるかを数え、YouTubeがどのチャンネルを繰り返しおすすめしているかを確認します。
- 自分の動画がおすすめされている場所の確認: 競合の人気動画に対してこのエンドポイントを実行し、その一覧に自分の動画IDが含まれているかを探します。
YouTube Related Videos API 活用のヒント
- views_count は 2.2M のような丸められた表示用の文字列から換算しているため、概数として扱ってください。
- おすすめは時間とともに変わるため、実行結果を比較する際は各一覧に collected_at を保存してください。
- 残しておく動画のURLを YouTube Videos に渡すと、正確な数値、公開日、再生時間を取得できます。
関連API
YouTube Related 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 Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API