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 の使い方
検索語の書き出しを送信し、順位づけされた候補を読み取ります。
- {"query": "iphone 17"} を /v1/youtube/search-suggestions に POST します。別の市場が必要な場合は language と region を追加します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 を固定してください。市場ごとに返る候補の一覧が異なります。
関連API
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 Transcripts API
- YouTube Channels API
- YouTube Videos 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 Related Videos API
- YouTube Email Finder API
- YouTube Trending Videos API