youtube/
search-suggestions

入力途中の検索語に対してYouTubeの検索ボックスが表示する検索候補を、視聴者に表示される順位どおりに、指定した言語と地域で取得します。

YouTube Search Suggestions API

検索候補
言語と地域
1リクエスト固定料金
1リクエストあたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

YouTube Search Suggestions

検索候補は、視聴者が入力している途中でYouTubeの検索ボックスが提案する補完語で、視聴者の言語と国に合わせて順位づけされています。種となるキーワードの周りで実際に使われている検索の言い回しがそのまま表れるため、キーワード調査、動画タイトル、タグ、企画のアイデアを考える際の直接の材料になります。

YouTube Search Suggestions API の主な機能

  • 視聴者が見るとおりの順位rank には各候補がドロップダウンの何番目に表示されるかが入り、最上位の候補が1になります。
  • 市場を選べるlanguage と region で別の市場の候補に切り替えられます。たとえば es と MX なら、メキシコのスペイン語検索になります。
  • 候補ごとの検索リンク各候補には、その語句でのYouTube検索結果のURLが付き、リクエスト時の種キーワードと市場もあわせて記録されます。

YouTube Search Suggestions API のパラメータ

パラメータ必須説明
query必須補完したい検索語の書き出しです。最大100文字です。
language任意候補の言語コードです。en、es、pt-BR などを指定でき、デフォルトは en です。
region任意検索市場を表す2文字の国コードです。US や GB などを指定でき、デフォルトは US です。

YouTube Search Suggestions API の使い方

検索語の書き出しを送信し、順位づけされた候補を読み取ります。

  1. {"query": "iphone 17"} を /v1/youtube/search-suggestions に POST します。別の市場が必要な場合は language と region を追加します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から rank 順に候補を読み取り、has_more が true の間は results.next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"iphone 17"}'

# Each item is one suggestion: keyword, rank, language and region.

YouTube Search Suggestions API の主なユースケース

  • 種キーワードの拡張: 商品名やテーマ名の補完語を集め、視聴者が実際に検索している長めの言い回しを見つけます。
  • 検索に合った動画タイトル: 上位の候補から言い回しを選び、動画タイトルを人々が入力する検索語に合わせます。
  • 市場ごとの需要の比較: 同じ種キーワードを異なる language と region で実行し、国によって検索意図がどう変わるかを確認します。

YouTube Search Suggestions API 活用のヒント

  • iphone 17 a のように種キーワードの後に1文字加えると、その文字に続く補完語を取得できます。
  • 同じ種キーワードを継続的に追跡する場合は、language と region を固定してください。市場ごとに返る候補の一覧が異なります。

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

  • YouTube Channel Videos API — チャンネルURLから、ショートとライブ配信を除く通常の公開動画を取得します。
  • YouTube Comments API — 公開コメント、投稿者、エンゲージメント、元の動画、会話の情報を取得します。
  • YouTube Search API — キーワードで通常の公開動画を検索します。対応するメタデータのフィルターを指定できます。
  • YouTube Hashtag Search API — ハッシュタグフィードから公開動画を探します。すべてのコンテンツか、ショートのみかを選んで取得できます。
  • YouTube Channel Search API — キーワードでチャンネルを検索し、チャンネル名、チャンネル登録者数、アイコン、説明文の抜粋を返します。
  • YouTube Shorts Search API — キーワードでショートを検索し、リンク、キャプション、視聴回数、縦長のサムネイルを返します。

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

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

YouTube Search Suggestions API — よくある質問

YouTube Search Suggestions APIは、入力途中の検索語に対するYouTubeの検索候補を、指定した言語と地域で取得するためのプログラムインターフェースです。各候補の語句とその順位を返します。

はい。YouTubeの検索ボックスに入力したときに表示される補完候補を、同じ順番で返します。

YouTubeがその検索語に対して提示する数だけ返します。通常は十数個です。

公式のData APIにはオートコンプリート(typeahead)のエンドポイントがありません。このエンドポイントは、YouTubeの検索ボックスに表示される検索候補を、指定した言語と地域での順位どおりに返します。

返される候補の数にかかわらず、1リクエストあたり固定で0.5クレジットです。