YouTube Shorts Search
ショートの検索結果は、YouTubeがショートのフィルターでキーワードに対して上位に表示する縦型動画で、それぞれキャプション、視聴回数、9:16のサムネイルとともに表示されます。結果を見比べると、そのテーマでどんなつかみや切り口が注目を集めているかがわかり、さらに分析や追跡をするためのショートのリンクもそろいます。
YouTube Shorts Search API の主な機能
- ショートだけを返す結果はYouTubeのショート検索から取得するため、長尺動画、チャンネル、再生リストは含まれません。
- キャプション、視聴回数、サムネイルtext はショートのキャプション、metrics.views_count は表示用の回数から換算した値で、media には縦長のサムネイルとそのサイズが入ります。
- キャプションのハッシュタグキャプションに書かれたタグを hashtags に一覧で返すため、結果全体での集計にそのまま使えます。
- すぐ使えるショートのリンク各結果には youtube.com/shorts/ のURLと動画IDが含まれ、追加の照会に使えます。
YouTube Shorts Search API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | ショートを検索するキーワードです。最大100文字です。 |
results_limit | 任意 | 返すショートの件数です。1〜200で指定でき、デフォルトは25です。 |
YouTube Shorts Search API の使い方
キーワードで検索し、一致したショートを読み取ります。
- {"query": "meal prep", "results_limit": 25} を /v1/youtube/search-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/search-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"meal prep","results_limit":25}'
# Each item is one Short with text, metrics.views_count and a shorts URL.YouTube Shorts Search API の主なユースケース
- テーマごとのつかみの研究: キーワードで視聴回数の多いショートのキャプションを読み、どんな書き出しや約束が視聴を集めているかを確認します。
- ショートでのキーワード追跡: 同じ検索を定期的に実行し、どの動画IDが結果に入ったり外れたりしたかを比較します。
- 詳細分析用のショート収集: テーマごとにショートのURLを集めて YouTube Videos に渡し、チャンネル、高評価数、公開日の詳細を取得します。
YouTube Shorts Search API 活用のヒント
- 検索結果にはキャプションと視聴回数しか含まれないため、チャンネルや高評価数が必要な場合は、残しておくURLを YouTube Videos に送信してください。
- 視聴回数は 635K のような丸められた表示用の文字列から換算しているため、正確な合計ではなく桁の大きさで比較してください。
- 後のページには前のページと同じショートが一部含まれるため、results_limit に数える前に動画IDで重複を除いています。
関連API
YouTube Shorts Search API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。
- YouTube Comments API — 公開コメント、投稿者、エンゲージメント、元の動画、会話の情報を取得します。
- YouTube Videos API — 既知の動画またはショートのURLから、メタデータ、サムネイル、再生時間、エンゲージメントを取得します。
- YouTube Search API — キーワードで通常の公開動画を検索します。対応するメタデータのフィルターを指定できます。
- YouTube Hashtag Search API — ハッシュタグフィードから公開動画を探します。すべてのコンテンツか、ショートのみかを選んで取得できます。
- YouTube Related Videos API — 動画URLの横におすすめとして表示される動画を一覧で取得し、タイトル、チャンネル、視聴回数、サムネイルを返します。
- YouTube Channel Search API — キーワードでチャンネルを検索し、チャンネル名、チャンネル登録者数、アイコン、説明文の抜粋を返します。
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API