youtube/
search-shorts

キーワードでYouTubeショートを検索し、各ショートのリンク、キャプション、視聴回数、縦長のサムネイル、キャプション内のハッシュタグをYouTubeの検索順で取得します。

YouTube Shorts Search API

キーワードで入力
ショートのみ
最大200本のショート
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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 の使い方

キーワードで検索し、一致したショートを読み取ります。

  1. {"query": "meal prep", "results_limit": 25} を /v1/youtube/search-shorts に 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/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で重複を除いています。

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

YouTube Shorts Search API — よくある質問

YouTube Shorts Search APIは、キーワードでYouTubeショートを検索するためのプログラムインターフェースです。各ショートのリンク、キャプション、視聴回数、縦長のサムネイルをYouTubeの検索順で返します。

ショートのURLを YouTube Videos に送信してください。各動画のチャンネル、高評価数、コメント数、公開日を返します。

results_limit は1〜200の範囲で指定でき、デフォルトは25です。これはショートの検索結果のおよそ1ページ分です。

公式の検索にはショートだけに絞る条件がなく、videoDuration=short は4分未満のすべての動画が対象になります。このエンドポイントはYouTubeのショート検索から結果を取得するため、返る結果はすべてショートです。

返されたショート1本につき0.6クレジットです。デフォルトの25本なら15クレジットになります。