seo/
ranked-keywords

検索市場で1つのドメイン、サブドメイン、ページが上位表示されているキーワードを調べ、URL、掲載順位、検索指標、検索意図、推定トラフィックの情報を返します。

Ranked Keywords API

ドメインまたはページを指定
キーワードと上位表示URLの対応
掲載順位の情報
結果1件あたり0.1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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つ、市場の設定と結果の取得範囲とともに送信し、完了した非同期タスクから各上位表示キーワードを読み取ります。

  1. target を1つ選び、location_code、language_code、1〜1,000の results_limit、0以上の offset を指定します。
  2. ペイロードを /v1/seo/ranked-keywords に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. 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 true

Ranked 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、市場、言語で重複排除してください。

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つのドメインのインデックス済みページを一覧化し、オーガニック検索と広告の順位分布、推計トラフィック、推定コストの情報を返します。

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

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

Ranked Keywords API — よくある質問

Ranked Keywords APIは、選択した市場と言語において、1つのドメイン、サブドメイン、ページに関連する検索語を調べるためのプログラムインターフェースです。一致したURL、掲載順位、キーワードの計測値、月別の推移、検索意図、ソース要素の全体を返します。

https:// や www. を付けないドメイン、プロトコルを付けないサブドメイン、または1つのページを表す完全なURLを使用してください。プロトコルのないページパスを指定すると、範囲がドメイン全体に広がることがあります。

いいえ。掲載順位は選択した検索インデックスと市場における値であり、すべてのユーザーに同じリアルタイムの結果が表示されることを示すものではありません。繰り返し取得したスナップショットを比較する場合は collected_at を使用してください。

rank.page は検索結果のページ番号、offset はスキップするソースのキーワード行数、next_cursor はSocQタスクにすでに保存された結果をページ送りするための値です。これらは互いに置き換えられません。

いいえ。etv は extra.ranked_serp_element に保持されるモデルによる推定値であり、対象サイトの非公開のトラフィックやコンバージョンの解析データではありません。

返された上位表示キーワード1件につき0.1 SocQクレジットです。結果が空の場合は結果に対する課金は発生しません。results_limit はリクエスト前の見積もりに使われるもので、最終的な件数を保証するものではありません。