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

# 獲得キーワード調査取得

`POST /v1/influx-keywords`

獲得キーワード調査。
指定ドメイン/URLがGoogleからSEO流入を獲得しているキーワードを取得。競合のSEO調査・自サイト分析に使う。

最大10,000件取得。
対象サイト・ページが各キーワードで何位にランクインし、どれだけ推定流入数を得ているかを返す。

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

競合がSEO流入を獲得している主要なキーワードを調査するのに有用。
また、コンテンツギャップの調査にも役立つ。
自サイト・競合サイトのデータを比較することで、
競合がランクインしているが、自サイトがランクインできていないキーワードを把握できる。

ページ単位で集計したい場合は POST /v1/influx-pages を、
指定ドメインの競合サイトを抽出したい場合はPOST /v1/competitiveを使う。

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

## Request body

- InfluxKeywordsKeywordDto
  - `targets` object[], required — 獲得キーワード調査の対象ドメインまたはURLとマッチタイプの配列。最大20件まで指定可能。各要素は { url, matchType } のオブジェクト。
    - `url` string, required — ドメインまたはURL
    - `matchType` 'url' | 'forward_url' | 'domain' | 'sub_domain' — マッチタイプ。url: 完全一致URL / forward_url: 前方一致URL / domain: ドメイン完全一致 / sub_domain: サブドメイン含むドメイン一致。省略時は sub_domain。
  - `keywordCollapse` boolean — キーワード重複除去の有効/無効。true にすると同一キーワードの重複を除去する。省略時は false。
  - `filter` object — 結果のフィルタリング条件。キーワード・SEO難易度・検索順位・月間検索数・CPC・競合性・推定流入数で絞り込む。
    - `keyword` object — キーワードフィルタ（含む/含まないキーワード指定）
      - `includes` string[] — 含む単語のリスト（複数入力時はOR）
      - `notIncludes` string[] — 含まない単語のリスト（複数入力時はOR）
    - `seoDifficulty` object — SEO難易度フィルタ（0〜100の範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `rank` object — 検索順位フィルタ（1〜100の範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `searchVolume` object — 月間検索数フィルタ（範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `cpc` object — CPC（$）フィルタ（範囲指定）
      - `min` number — 最小CPC
      - `max` number — 最大CPC
    - `competition` object — 広告競合性フィルタ（0〜100の範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `etv` object — 推定流入数フィルタ（範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
  - `sortBy` 'keyword' | 'seoDifficulty' | 'rank' | 'searchVolume' | 'cpc' | 'competition' | 'etv' — ソート項目。keyword / seoDifficulty / rank / searchVolume / cpc / competition / etv。省略時は etv。
  - `orderBy` 'asc' | 'desc' — ソート順。asc: 昇順 / desc: 降順。省略時は desc。
  - `limit` integer — 取得件数。1〜10000 の整数を指定する。省略時は 100。

## Response `200`

検索成功

- InfluxKeywordsKeywordResponseDto
  - `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またはドメイン
      - `keyword` string, required — 対象が獲得しているSEOキーワード
      - `metrics` object, required — キーワードの各種指標（SEO難易度・月間検索数・CPC・広告競合性）
        - `seoDifficulty` number, nullable, required — SEO難易度。1–100で表し、高いほど難易度が高い（1–33:低 / 34–66:中 / 67–100:高）。不明な場合は null。
        - `searchVolume` number, required — 月間検索数（年平均）
        - `cpc` number, required — 推定クリック単価（USD）
        - `competition` number, required — 広告競合性。0–100で表し、高いほど競合性が高い（0–33:低 / 34–66:中 / 67–100:高）。
      - `ranking` object, required — 検索順位情報（順位・推定流入数・ランクインURL）
        - `position` number, required — 検索順位
        - `estimatedTraffic` number, required — このキーワードからの推定検索流入数（月間）
        - `url` string, required — ランクインしているURL
  - `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)