Ranked Keywords
上位表示キーワードとは、一致する検索結果URLを通じてドメイン、サブドメイン、ページと結びついた検索クエリで、グループ内順位、全体順位、検索結果のページ番号に加え、取得可能な需要、難易度、検索意図、トラフィックの指標が含まれます。これらのクエリとページの関係は、検索での露出状況の棚卸し、ランディングページの対応付け、機会の検討、対象ごとのスナップショット比較に活用できます。
Ranked Keywords API の主な機能
- ドメイン・サブドメイン・ページ単位の範囲指定正しい形式で指定した1つのWeb対象を、ドメイン全体、サブドメイン、1つのページURLなど、必要な範囲で照会します。
- キーワードとURLの対応返された各キーワードを、上位表示されている検索結果要素が示す一致した遷移先URLと組み合わせて返します。
- 掲載順位とキーワードの計測値取得可能なグループ内順位、全体順位、検索結果のページ番号を、検索ボリューム、CPC、競合性、難易度、月別の推移、検索意図とあわせて返します。
- 一致した要素の全体keyword_data と ranked_serp_element を extra に保持するため、結果タイプ、モデルによる推定トラフィック、正規化されていないソースの詳細も参照できます。
Ranked Keywords API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
target | 必須 | 必須。ドメイン、サブドメイン、ページのいずれかの対象です。ドメインの場合は https:// と www. を省略し、サブドメインの場合はプロトコルを省略してください。1つのページを指定する場合は完全なURLを使用します。 |
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から数えます。 |
Ranked Keywords API の使い方
正しい範囲で指定した対象を1つ、市場の設定と結果の取得範囲とともに送信し、完了した非同期タスクから各上位表示キーワードを読み取ります。
- target を1つ選び、location_code、language_code、1〜1,000の results_limit、0以上の offset を指定します。
- ペイロードを /v1/seo/ranked-keywords に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きをリクエストします。
curl -X POST "https://api.socq.ai/v1/seo/ranked-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueRanked Keywords API の主なユースケース
- オーガニック検索での露出状況の棚卸し: 返されたキーワードと一致したURLを使い、選択した検索市場でドメインやサブドメインがどこに表示されているかを一覧化します。
- ランディングページと順位の対応表: 各キーワード、遷移先URL、rank オブジェクトを組み合わせ、返された各掲載順位にどのページが対応しているかを特定します。
- キーワード機会の検討: 掲載順位を、取得可能な検索ボリューム、CPC、競合性、難易度、検索意図のフィールドと比較し、検討キューを作成します。
- 露出状況のスナップショット比較: 繰り返し実行したタスクの対象入力、collected_at、キーワード、URL、掲載順位を保存し、個別に取得したスナップショットを比較します。
Ranked Keywords API 活用のヒント
- 意図した範囲が正しく解釈されるよう、ドメインの target からは https:// と www. を、サブドメインの target からはプロトコルを取り除いてください。
- ページ単位の結果が必要な場合は完全なページURLを使用してください。プロトコルのないページパスは、ドメイン全体を対象として解釈されることがあります。
- offset はスキップしたいソース行の数だけ増やし、連続した範囲を取得する際は target、市場、言語、上限数を固定してください。
- rank.page は検索結果のページ番号として扱ってください。ソースの取得範囲には offset を、保存されたSocQの結果ページには別途 next_cursor を使用します。
- まず正規化された掲載順位とキーワード指標を読み取り、モデルによる etv など正規化されていないソースフィールドは extra.ranked_serp_element で確認してください。
- 時系列の比較は繰り返し実行したタスクから作成し、ソースの並び順は変わることがあるため、取得範囲はキーワード、一致したURL、市場、言語で重複排除してください。
関連API
Ranked Keywords 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サイトに関連するキーワードを、取得可能な需要指標、月次推移、市場情報、元データの全行とともに生成します。
- Relevant Pages API — 1つのドメインのインデックス済みページを一覧化し、オーガニック検索と広告の順位分布、推計トラフィック、推定コストの情報を返します。
- Keyword Suggestions API
- Related Keywords 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