seo/
relevant-pages

1つのドメインのインデックス済みページを一覧化し、ページURL、順位の分布、モデルによる推定検索トラフィック、検索広告のコスト情報を正規化されたレコードで返します。

Relevant Pages API

ページの検索露出
順位の分布
推定トラフィック
結果1件あたり0.15クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Relevant Pages

関連ページとは、オーガニック検索または検索広告で計測可能な露出があるインデックス済みのURLで、キーワード数、掲載順位帯、モデルによる推定トラフィック、コストの推定値、順位変動の指標を含みます。これらのページ単位の計測値は、検索露出の棚卸し、検索上のプレゼンスの比較、トラフィック価値の確認、繰り返し取得したスナップショットの分析に活用できます。

Relevant Pages API の主な機能

  • ドメイン単位のページ一覧選択した検索インデックスにおいて、オーガニック検索または検索広告で計測可能な関連性を持つ、1つのドメインのページの絶対URLを返します。
  • オーガニック検索の順位分布掲載順位帯ごとのオーガニックキーワード数を保持し、取得できる場合は新規、上昇、下降、消失した順位の件数もあわせて保持します。
  • 検索広告での露出状況各ページについて、取得可能な広告キーワード数、掲載順位の範囲、モデルによる推定トラフィック、推定広告トラフィックコストを提供します。
  • ページ指標オブジェクトの全体ページURLは安定して識別できるよう正規化し、ネストされたオーガニック、広告、その他の可変のページ単位の計測値は extra に保持します。

Relevant Pages API のパラメータ

パラメータ必須説明
target必須必須。https:// や www. を含まないドメインです(例:example.com)。
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から数えます。

Relevant Pages API の使い方

正しい形式のドメインを1つ、市場の設定とソースの取得範囲とともに送信し、完了した非同期タスクから各関連ページを読み取ります。

  1. https:// や www. を含まないドメインを1つ選び、location_code、language_code、1〜1,000の results_limit、0以上の offset を指定します。
  2. ペイロードを /v1/seo/relevant-pages に 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/relevant-pages" \
  -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

Relevant Pages API の主なユースケース

  • 検索で露出しているページの一覧化: 返されたページURLを使い、インデックス上で計測可能な検索上の関連性を持つページに絞ったドメインのページ一覧を作成します。
  • オーガニック検索での露出の比較: オーガニックキーワード数、順位帯、順位変動のフィールドを比較し、検索露出がページ間でどのように分布しているかを把握します。
  • 検索広告のページ別確認: 広告キーワード数、掲載順位の範囲、モデルによる推定トラフィック、推定コストを使い、返されたページの広告での露出状況を比較します。
  • ページ露出のスナップショット: 繰り返し取得したレコードを page_address と市場ごとに保存し、取得時期ごとの順位分布や推定トラフィックを比較します。

Relevant Pages API 活用のヒント

  • このエンドポイントは完全なページURLではなくドメインを想定しているため、送信前に target から https:// と www. を取り除いてください。
  • 返された url をページの識別子として使用してください。text は同じURLを代替値として入れたもので、ページ本文は含まれません。
  • 繰り返し取得した結果の範囲を比較する場合は、target、location_code、language_code、results_limit、offset を固定してください。
  • offset はページ番号ではなくソース行の数として扱い、タスク結果の next_cursor とは分けて保存してください。
  • オーガニック検索と検索広告の計測値は extra.metrics から読み取り、ネストされた指標グループや個別のフィールドが欠落する可能性を考慮してください。
  • etv と estimated_paid_traffic_cost は、非公開の解析データや実際の売上ではなく、モデルによる検索の推定値として解釈してください。

Relevant Pages 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サイトに関連するキーワードを、取得可能な需要指標、月次推移、市場情報、元データの全行とともに生成します。
  • Ranked Keywords API — ドメイン、サブドメイン、ページがランクインしているキーワードを、一致するURL、順位、検索指標、検索意図、元データの全要素とともに取得します。

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

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

Relevant Pages API — よくある質問

Relevant Pages APIは、プロトコルやwwwを除いた1つのドメインについて、計測可能な検索上の関連性を持つインデックス済みページを見つけるためのプログラムインターフェースです。ページURL、オーガニック検索と検索広告の順位分布、モデルによる推定トラフィック、コストの推定値、順位変動の件数、ソースの行全体を返します。

https:// と www. を付けずに、example.com のようなドメインを1つ送信してください。このドメイン単位のページ一覧では、完全なページURLは送信しないでください。

いいえ。検索インデックスで把握されており、オーガニック検索または検索広告で計測可能な関連性を持つページを返します。そのため、インデックスされていないページや計測可能な露出がないページは含まれない場合があります。

ソースの行には、オーガニックと広告のキーワード数、掲載順位帯、モデルによる推定トラフィック、推定広告トラフィックコスト、順位変動の件数が含まれる場合があります。これらのネストされた値は、正規化されたトップレベルの metrics オブジェクトではなく extra.metrics に保持されます。

いいえ。etv とトラフィックコストの値はモデルによる検索の推定値であり、非公開の解析データ、実際の訪問数、売上の計測値ではありません。

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