Keyword Suggestions
キーワード候補とは、シードとなる単語やフレーズの前後や間に語句が加わったロングテールの検索語で、各レコードには需要、コスト、競合性、月別の推移、検索意図の指標が含まれる場合があります。これらの一致したキーワードと計測値は、検索クエリの拡張、コンテンツ企画のための調査、検索広告の分析、言い回しの違いを条件をそろえて比較する用途に活用できます。
Keyword Suggestions API の主な機能
- 全文一致によるシードの展開送信したシードの単語を含み、フレーズの前後や間への語句の追加や語順の違いを許容した検索語を返します。
- キーワードの計測オブジェクト取得可能な検索ボリューム、CPC、広告の競合性、月別の推移、難易度の詳細を、各レコードのソースデータ内に保持します。
- 検索意図のコンテキスト一致した各キーワードについて、取得可能な主要・副次的な検索意図の情報を提供します。順位に関する推奨として扱うものではありません。
- 取得範囲の制御1〜1,000の結果上限と、0から始まる行オフセットを受け付け、ソースの後続の範囲を取得できます。
Keyword Suggestions API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | 必須。空でないシードキーワードまたはフレーズです。1つのタスクで指定できるクエリは1つです。 |
location_code | 任意 | 正の数値で指定する検索市場コードです。Playgroundの既定値は2840です。 |
location_name | 任意 | 任意。location_code の代わりに使える検索市場名です。指定した場合は location_code より優先されます。 |
language_code | 任意 | 2〜10文字の検索言語コードです。Playgroundの既定値は en です。 |
language | 任意 | 任意。language_code の代わりに使える検索言語名です。指定した場合は language_code より優先されます。 |
results_limit | 任意 | 取得するキーワード候補の上限数で、1〜1,000の範囲で指定します。返される行数がこれより少ない場合があります。 |
offset | 任意 | 指定した取得範囲を収集する前にスキップするソース行の数です。0から数えます。 |
Keyword Suggestions API の使い方
市場の設定と結果の取得範囲を指定して1つのシードクエリを送信し、完了した非同期タスクから各キーワード候補を読み取ります。
- 空でない query を1つ選び、location_code、language_code、1〜1,000の results_limit、0以上の offset を指定します。
- ペイロードを /v1/seo/keyword-suggestions に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きをリクエストします。
curl -X POST "https://api.socq.ai/v1/seo/keyword-suggestions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"keyword research","location_code":2840,"language_code":"en","results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueKeyword Suggestions API の主なユースケース
- ロングテールクエリの拡張: 1つのシードフレーズと返されたキーワードを使い、元の単語を含むより長いクエリのバリエーションを収集します。
- コンテンツ企画の候補調査: 一致したキーワードを、取得可能な検索ボリューム、月別の推移、難易度、検索意図のフィールドと組み合わせ、検討用のキーワードセットを作成します。
- 検索広告キーワードの比較: 候補をプランニングのワークフローに渡す前に、言い回しの異なるキーワード間で取得可能な CPC と広告の競合性の計測値を比較します。
Keyword Suggestions API 活用のヒント
- 厳密に一致するロングテールのバリエーションが必要な場合は具体的なシードフレーズを使用してください。シードの単語を含む必要がない場合は、意味ベースのキーワードエンドポイントを選んでください。
- offset はページ番号ではなく行数として扱い、スキップしたいソースの範囲のサイズ分だけ増やしてください。
- 条件が同じリクエストでも後からソースの並び順が変わることがあるため、query、location_code、language_code、results_limit、offset をまとめて記録してください。
- まず正規化フィールドから keyword と search_intent を読み取り、正規化されていない計測オブジェクトは extra.keyword_info と extra.keyword_properties で確認してください。
- 重複して取得した範囲は、キーワードと市場・言語の組み合わせで重複排除し、任意の指標やネストされたオブジェクトはすべて欠落する可能性を考慮してください。
関連API
Keyword Suggestions API 以外に別の種類の公開SEOデータが必要な場合は、これらのAPIをご利用ください。
- Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
- Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
- Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
- Keyword Search Volume API — 既知のキーワードについて、取得可能な検索ボリューム、CPC、広告の競合度、月間検索数の推移を計測します。
- Keywords for Site API — 1つのWebサイトに関連するキーワードを、取得可能な需要指標、月次推移、市場情報、元データの全行とともに生成します。
- Related Keywords API — 1つのシードクエリから関連検索をたどり、深さを指定して、取得可能なキーワード指標、検索意図の情報、元データの全行を返します。
- Ranked Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API