---
title: "獲得ページ調査取得"
method: POST
path: "/v1/influx-pages"
tags: ["獲得キーワード調査"]
---

# 獲得ページ調査取得

`POST /v1/influx-pages`

獲得ページ調査。

指定ドメイン/URLがGoogleからSEO集客できているページを取得。
競合や自サイトの主力集客ページの把握に有用。

最大10,000件取得。
指定ドメインの各ページの合計推定流入数・合計集客価値(USD)・ランクインキーワード数・最もSEO流入を集めているキーワードを返す。

検索順位やSEO指標は最新でない可能性がある。
この指標を重要視する用途なら、データ取得後にPOST /v1/search-volumeで最新のSEO指標を取得するか、POST /v1/search-rankで最新の検索順位＋SEO指標を取得すること。

競合がすでにSEOで集客できているページは、Google検索のユーザーから需要がある情報が掲載されていることが推定できる。

当機能で発見したページの、2位以降のSEO流入キーワードを確認したい場合はPOST /v1/influx-keywordsをmatchType=urlで使う。

1リクエストあたり4.5クレジットを消費。

## Request body

- InfluxPagesDto
  - `targets` object[], required — 獲得キーワード調査（ページ軸）の対象ドメインまたはURLとマッチタイプの配列。最大20件まで指定可能。
    - `url` string, required — ドメインまたはURL
    - `matchType` 'url' | 'forward_url' | 'domain' | 'sub_domain' — マッチタイプ。url: 完全一致URL / forward_url: 前方一致URL / domain: ドメイン完全一致 / sub_domain: サブドメイン含むドメイン一致。省略時は sub_domain。
  - `topKeywordCollapse` boolean — トップキーワード重複除去の有効/無効。true にすると同一トップキーワードの重複を除去する。省略時は false。
  - `filter` object — 結果のフィルタリング条件。合計推定流入数・キーワード数・合計集客価値・タイトル・URL・トップキーワード・SEO難易度で絞り込む。
    - `totalEtv` object — 合計推定流入数フィルタ（範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `keywordCount` object — キーワード数フィルタ（範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `totalTrafficValue` object — 合計集客価値（USD）フィルタ（範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `title` object — タイトルフィルタ（含む/含まないキーワード指定）
      - `includes` string[] — 含む単語のリスト（複数入力時はOR）
      - `notIncludes` string[] — 含まない単語のリスト（複数入力時はOR）
    - `url` object — URLフィルタ（含む/含まないURL指定）
      - `includes` string[] — 含むURLのリスト（複数入力時はOR）
      - `notIncludes` string[] — 含まないURLのリスト（複数入力時はOR）
    - `topKeyword` object — トップキーワードフィルタ（含む/含まないキーワード指定）
      - `includes` string[] — 含む単語のリスト（複数入力時はOR）
      - `notIncludes` string[] — 含まない単語のリスト（複数入力時はOR）
    - `topSeoDifficulty` object — SEO難易度フィルタ（0〜100の範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
  - `sortBy` 'totalEtv' | 'totalTrafficValue' | 'keywordCount' — ソート項目。totalEtv / totalTrafficValue / keywordCount。省略時は totalEtv。
  - `orderBy` 'asc' | 'desc' — ソート順。asc: 昇順 / desc: 降順。省略時は desc。
  - `limit` integer — 取得件数。1〜10000 の整数を指定する。省略時は 100。

## Response `200`

検索成功

- InfluxPagesResponseDto
  - `result` boolean, required — API 呼び出しの成否。正常時は true、エラー時は false。
  - `meta` object, required — リクエストに関するメタ情報（課金・消費リソースなど）
    - `consumedCredit` number, required — このリクエストで消費されたクレジット数。
  - `data` object, required — 獲得キーワード調査結果（ページ軸）データ
    - `query` object, required — リクエストで指定されたクエリ情報
      - `targets` string[], required — 獲得キーワード調査の対象URLまたはドメイン一覧
    - `summary` object, required — 集計サマリー（件数・推定流入数・キーワード数）
      - `totalCount` number, required — 取得対象全体の件数
      - `returnedCount` number, required — このレスポンスに含まれている件数
      - `estimatedTraffic` number, required — 対象全体の推定検索流入数（月間）
      - `keywordCount` number, required — ランクインしているキーワード数
    - `items` object[], required — 獲得キーワード調査結果（ページ軸）のリスト。各アイテムに対象・ページ情報・パフォーマンス指標・トップキーワードを含む。
      - `target` string, required — このページが属する対象URLまたはドメイン
      - `page` object, required — ページ情報（タイトル・URL）
        - `title` string, required — ページタイトル
        - `url` string, required — ページURL
      - `performance` object, required — パフォーマンス指標（ランクインキーワード数・推定流入数・集客価値）
        - `rankingKeywordCount` number, required — このページでランクインしているキーワード数
        - `estimatedTraffic` number, required — このページの推定検索流入数（月間）
        - `trafficValue` number, required — このページの集客価値（USD）。推定流入数×CPC で算出される広告換算価値。
      - `topKeyword` object, required — トップキーワード情報（キーワード・順位・指標）
        - `keyword` string, required — このページで最もSEO流入を獲得しているトップキーワード
        - `position` number, required — トップキーワードでの検索順位
        - `metrics` object, required — トップキーワードの各種指標（SEO難易度・月間検索数）
          - `seoDifficulty` number, nullable, required — SEO難易度。1–100で表し、高いほど難易度が高い（1–33:低 / 34–66:中 / 67–100:高）。不明な場合は null。
          - `searchVolume` number, required — トップキーワードの月間検索数（年平均）
  - `errors` string[], required — エラーメッセージの配列。正常時は空配列。

## Other responses

- `400` — バリデーションエラー
- `402` — クレジット不足
- `403` — 認証エラー
- `429` — レート制限超過
- `500` — Internal Server Error
- `503` — Service Unavailable - データベース接続エラーなど

---

[API](https://skmtc.dev/rakkokeyword/apis/api.md) · [All operations](https://skmtc.dev/rakkokeyword/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rakkokeyword/api/revisions/23e921f5f25c/schema)