---
title: "同時ランクインキーワード取得"
method: POST
path: "/v1/ranking-keywords"
tags: ["同時ランクインキーワード"]
---

# 同時ランクインキーワード取得

`POST /v1/ranking-keywords`

同時ランクインキーワード取得。
Google検索上位ページが他にSEO流入を獲得しているKWを抽出。検索意図の近い・遠い関連語の発見に使う。

最大5,000件取得。月間検索数・SEO難易度・CPC・競合性などのSEO指標付き。

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

指定キーワードで上位ページ群がランクインしている他のキーワードを集めるため、検索意図の近いキーワードを発見できる。
searchTop / searchRangeの範囲を狭めれば検索意図の近いキーワードが、広げれば検索意図の遠いキーワードの抽出が行える。

relevanceの高いキーワードは、検索意図が近い可能性が高いため、一つのSEO記事で同時にGoogle上位ランクインを狙える可能性が高い。
relevanceの低いキーワードは、検索意図が遠い可能性が高いため、元キーワードとは別の記事として上位ランクインを狙うことが望ましい。
searchTop / searchRangeを広げると、relevanceの低いキーワードを多く取得できるため、既存キーワードと被りづらい・新しいキーワードを発見するのに役立つ。

特定サイト・ページがSEO流入を獲得しているキーワードを調べたい場合は POST /v1/influx-keywords を、
より多くの関連語を取得したい場合は POST /v1/suggest-keywords を使う。

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

## Request body

- RankingKeywordsDto
  - `keyword` string, required — 同時ランクインキーワード取得の元となる検索キーワード。指定キーワードの検索上位URLが他にランクインしているキーワードを取得する。1文字以上の文字列を指定する。
  - `searchTop` union — 検索上位ページの参照数。そのキーワードでGoogle検索で上位表示できているページのうち、上位何件のURLを同時ランクイン判定に使用するかを指定する。選択肢: 3 / 5 / 10 / 20 / 30 / 50。省略時は 20。値を大きくすると、Google検索でより下位にランクインしている＝検索意図とズレのより大きいページが調査対象となる。値を小さくすると、Google検索でより上位にランクインしている＝検索意図に一致するページのみが調査対象となる。
    - 3
    - 5
    - 10
    - 20
    - 30
    - 50
  - `searchRange` union — 検索順位範囲。searchTopで指定したページがGoogle上位表示できているキーワードのうち、この順位以内にランクインしているキーワードを対象にする。選択肢: 10 / 20 / 30 / 50 / 100。省略時は 50。
    - 10
    - 20
    - 30
    - 50
    - 100
  - `filter` object — 結果のフィルタリング条件。キーワード・SEO難易度・月間検索数・CPC・競合性・関連度で絞り込む。
    - `keyword` object — キーワードフィルタ
      - `includes` string[] — 含む単語のリスト（複数入力時はOR）
      - `notIncludes` string[] — 含まない単語のリスト（複数入力時はOR）
    - `seoDifficulty` object — SEO難易度フィルタ（0〜100の範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `searchVolume` object — 月間検索数フィルタ（範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `cpc` object — クリック単価（CPC）フィルタ（USD、範囲指定）
      - `min` number — 最小CPC
      - `max` number — 最大CPC
    - `competition` object — 競合性フィルタ（0〜100の範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
    - `relevance` object — 関連度フィルタ（0〜100の範囲指定）
      - `min` integer — 最小値
      - `max` integer — 最大値
  - `sortBy` 'seoDifficulty' | 'searchVolume' | 'cpc' | 'competition' | 'relevance' — 結果のソート項目。seoDifficulty / searchVolume / cpc / competition / relevance。省略時は relevance。
  - `orderBy` 'asc' | 'desc' — ソート順。asc: 昇順 / desc: 降順。省略時は desc。
  - `limit` integer — 取得件数。1〜5000 の整数を指定する。省略時は 500。

## Response `200`

検索成功

- RankingKeywordsResponseDto
  - `result` boolean, required — API 呼び出しの成否。正常時は true、エラー時は false。
  - `meta` object, required — リクエストに関するメタ情報（課金・消費リソースなど）
    - `consumedCredit` number, required — このリクエストで消費されたクレジット数。
  - `data` object, required — 同時ランクインキーワード検索結果データ
    - `query` object, required — リクエストで指定された検索クエリ情報
      - `keyword` string, required — 同時ランクインキーワード取得の元になった検索キーワード
    - `summary` object, required — 件数サマリー（全体件数とレスポンスに含まれる件数）
      - `totalCount` number, required — 取得対象全体の件数
      - `returnedCount` number, required — このレスポンスに含まれている件数
    - `items` object[], required — 同時ランクインキーワード結果のリスト。各アイテムにキーワード・単語数・SEO指標を含む。
      - `keyword` string, required — 同時ランクインしているキーワード
      - `wordCount` number, required — キーワードのスペース区切りの単語数
      - `metrics` object, required — SEO関連の各種指標（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:高）。
        - `relevance` number, required — 同時ランクイン度。1–100で表し、高いほど元キーワードと検索結果の重複度が高いことを示す。
  - `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)