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 の使い方
既知のチャンネル群から、ショート動画だけのクリーンなデータを作成します。タスクはプラットフォームの分類を、後から適用する独自のフォーマットルールとは切り離して扱います。
- 公開チャンネルのURLを用意します。個別のショートURLを直接照会したい場合は Videos を使用します。
- urls と results_limit を /v1/youtube/shorts に POST します。上限はチャンネルごとに適用される点に注意してください。
- チャンネル内の一覧取得が完了するまで /v1/tasks/{task_id} をポーリングします。
- 結果をショート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=50YouTube Shorts API の主なユースケース
- ショート動画の活動モニタリング: 選定したクリエイター、ブランド、パブリッシャー、競合が公開したショートを追跡します。
- ショートのパフォーマンス比較: 選定したチャンネル間で、投稿頻度、再生時間、視聴回数、高評価数、コメント数を比較します。
- ショート動画のコンテンツカタログ: 社内検索、レビュー、レポートのために、公開ショートの正規化されたコレクションを構築します。
- トピック・トレンド分析: タイトル、説明、ハッシュタグ、チャンネルデータ、公開指標を分類や調査のワークフローに活用します。
YouTube Shorts API 活用のヒント
- 一律の再生時間のしきい値で結果を再分類しないでください。このエンドポイントでは、YouTubeが公開しているフォーマット分類が仕様です。
- 上限はチャンネルごとの最大値であり、保証値ではありません。対象となる公開ショートが少ない、またはまったくないチャンネルもあります。
- 重複排除には返された ID を使用してください。同じ項目が、システム内の別の場所で異なる公開URL形式で現れることがあります。
- ショートの表示中の数値は公開後に急速に変動することがあるため、指標とともに collected_at を保持してください。
- このエンドポイントはキーワード検索に対応していません。トピックの発見は Search から始め、必要に応じて既知のショートURLを Videos で照会してください。
- ショート動画と通常の投稿をきれいに比較したい場合は、Channel Videos を別途取得してください。
- 変化しうるチャンネルのメタデータを各項目に繰り返し持たせるのではなく、プロフィールやオーディエンスのフィールドはチャンネルIDで Channels と結合してください。
関連API
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 Search 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 Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API