youtube/
shorts

YouTubeチャンネルのURLから公開ショートを取得し、正規化されたタイトル、チャンネル情報、サムネイル、再生時間、公開情報、表示中のエンゲージメントを返します。

YouTube Shorts API

ショート
チャンネル単位の取得
公開指標
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

YouTube Shorts

YouTubeショートは、タイトル、チャンネル情報、サムネイル、再生時間、公開情報、ソース分類、表示中のエンゲージメントを持つショート動画です。これらのコンテンツ情報とパフォーマンス指標は、フォーマット調査、クリエイター比較、トレンドのモニタリング、キャンペーン分析に活用できます。

YouTube Shorts API の主な機能

  • 複数チャンネルのショート取得複数のチャンネルURLから公開ショートを1回のリクエストでまとめて取得できます。
  • チャンネルごとの件数上限入力チャンネルごとに個別の results_limit を設定できます。デフォルトは100です。
  • 正規化されたショートのメタデータ正規化されたショートのID、コンテンツのメタデータ、サムネイル、再生時間、公開日、投稿元チャンネルを返します。
  • 特定時点のエンゲージメント指標公開されている視聴回数、高評価数、コメント数を collected_at とともに含み、後から比較できます。
  • プラットフォーム準拠のショート判定再生時間や画面の向きだけでショート動画を定義するのではなく、YouTube自身のショート分類を使用します。

YouTube Shorts API のパラメータ

パラメータ必須説明
urls必須公開YouTubeチャンネルのURLです。カンマまたは改行で区切って指定します。
results_limit任意入力URLごとに取得する対象レコードの最大件数です。正の整数で指定し、デフォルトは100です。

YouTube Shorts API の使い方

既知のチャンネル群から、ショート動画だけのクリーンなデータを作成します。タスクはプラットフォームの分類を、後から適用する独自のフォーマットルールとは切り離して扱います。

  1. 公開チャンネルのURLを用意します。個別のショートURLを直接照会したい場合は Videos を使用します。
  2. urls と results_limit を /v1/youtube/shorts に POST します。上限はチャンネルごとに適用される点に注意してください。
  3. チャンネル内の一覧取得が完了するまで /v1/tasks/{task_id} をポーリングします。
  4. 結果をショートIDでインデックス化し、チャンネルと取得時の文脈を保持したうえで、has_more が true の間はページネーションを続けます。
curl -X POST "https://api.socq.ai/v1/youtube/shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

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

  • ショート動画の活動モニタリング: 選定したクリエイター、ブランド、パブリッシャー、競合が公開したショートを追跡します。
  • ショートのパフォーマンス比較: 選定したチャンネル間で、投稿頻度、再生時間、視聴回数、高評価数、コメント数を比較します。
  • ショート動画のコンテンツカタログ: 社内検索、レビュー、レポートのために、公開ショートの正規化されたコレクションを構築します。
  • トピック・トレンド分析: タイトル、説明、ハッシュタグ、チャンネルデータ、公開指標を分類や調査のワークフローに活用します。

YouTube Shorts API 活用のヒント

  • 一律の再生時間のしきい値で結果を再分類しないでください。このエンドポイントでは、YouTubeが公開しているフォーマット分類が仕様です。
  • 上限はチャンネルごとの最大値であり、保証値ではありません。対象となる公開ショートが少ない、またはまったくないチャンネルもあります。
  • 重複排除には返された ID を使用してください。同じ項目が、システム内の別の場所で異なる公開URL形式で現れることがあります。
  • ショートの表示中の数値は公開後に急速に変動することがあるため、指標とともに collected_at を保持してください。
  • このエンドポイントはキーワード検索に対応していません。トピックの発見は Search から始め、必要に応じて既知のショートURLを Videos で照会してください。
  • ショート動画と通常の投稿をきれいに比較したい場合は、Channel Videos を別途取得してください。
  • 変化しうるチャンネルのメタデータを各項目に繰り返し持たせるのではなく、プロフィールやオーディエンスのフィールドはチャンネルIDで Channels と結合してください。

YouTube Shorts API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。

  • YouTube Channel Videos API — チャンネルURLから、ショートとライブ配信を除く通常の公開動画を取得します。
  • YouTube Comments API — 公開コメント、投稿者、エンゲージメント、元の動画、会話の情報を取得します。
  • YouTube Transcripts API — 取得可能なプレーンテキストの文字起こしを取得します。言語は任意で指定できます。
  • YouTube Channels API — 公開チャンネルのアカウント情報、画像、認証状態、表示中のオーディエンス統計を取得します。
  • YouTube Videos API — 既知の動画またはショートのURLから、メタデータ、サムネイル、再生時間、エンゲージメントを取得します。
  • YouTube Channel Live Videos API — チャンネルのライブ欄に表示されている公開配信のレコードを、取得元の情報と表示中の指標とともに取得します。

他のプラットフォームを見る

YouTubeのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

YouTube Shorts API — よくある質問

YouTube Shorts APIは、1つ以上のYouTubeチャンネルURLから公開されているショートを取得するAPIです。正規化されたタイトル、チャンネル情報、サムネイル、再生時間、公開日、エンゲージメント指標、取得時刻を返します。

1つ以上の公開YouTubeチャンネルURLと、任意の results_limit を指定します。

固定の再生時間やアスペクト比のルールだけを使うのではなく、YouTubeのショート分類に従います。

results_limit のデフォルトは100で、チャンネルURLごとに個別に適用されます。対象となる公開ショートが少ないチャンネルでは、最終的な件数が少なくなることがあります。

いいえ。視聴回数、高評価数、コメント数は取得時点で確認できた公開値です。過去との比較には、繰り返し取得する必要があります。

返された正規化ショート結果1件につき0.5クレジットです。