youtube/
related-videos

動画URLから、YouTubeがその動画の横におすすめとして表示する動画を一覧で取得し、各動画のタイトル、チャンネル、視聴回数、サムネイルを1回の実行で返します。

YouTube Related Videos API

動画URLで入力
次に再生されるおすすめ
チャンネルと視聴回数
結果1件あたり0.5クレジット
準備完了
README

SocQ 編集 · 更新

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つ送信し、おすすめ動画を読み取ります。

  1. {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} を /v1/youtube/related-videos に 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/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 に渡すと、正確な数値、公開日、再生時間を取得できます。

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

YouTube Related Videos API — よくある質問

YouTube Related Videos APIは、動画のURLから、YouTubeがその動画の横におすすめする動画を一覧で取得するためのプログラムインターフェースです。各おすすめ動画のタイトル、チャンネル、視聴回数、サムネイルを返します。

YouTubeがその動画に表示する一覧全体を返します。通常は約20本です。

はい。ショートのリンク、youtu.be リンク、ライブのリンク、通常の watch URL のいずれも受け付けます。

現在はできません。公式のData APIは2023年8月7日に検索の relatedToVideoId パラメータのサポートを終了しました。YouTubeが動画の横に表示するおすすめの一覧は、このエンドポイントで取得できます。

返されたおすすめ動画1本につき0.5クレジットです。一般的な20本の一覧なら10クレジットになります。