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つ、市場の設定とソースの取得範囲とともに送信し、完了した非同期タスクから各関連ページを読み取ります。
- https:// や www. を含まないドメインを1つ選び、location_code、language_code、1〜1,000の results_limit、0以上の offset を指定します。
- ペイロードを /v1/seo/relevant-pages に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- 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 trueRelevant 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 は、非公開の解析データや実際の売上ではなく、モデルによる検索の推定値として解釈してください。
関連API
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、順位、検索指標、検索意図、元データの全要素とともに取得します。
- 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