---
title: "関連キーワード取得"
method: POST
path: "/v1/related-keywords"
tags: ["関連キーワード取得"]
---

# 関連キーワード取得

`POST /v1/related-keywords`

関連キーワード取得。

指定キーワードに部分一致するキーワードをラッコのDBから大量に取得する。
関連語が欲しい場合はまずPOST /v1/suggest-keywordsを使い、さらに大量にKWを取得したい場合にのみ当機能を使う。

最大25,000件を取得。月間検索数・SEO難易度・CPC・競合性などのSEO指標付きで返却。
SEO難易度はデータがない場合が多い。またSEO指標は最新でない可能性がある。
この指標を重要視する用途なら、データ取得後にPOST /v1/search-volumeで最新のSEO指標を取得すること。

検索意図の近いキーワードを取得したい場合はPOST /v1/ranking-keywordsを、
LSIキーワードを取得したい場合はPOST /v1/other-keywordsを使う。

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

## Request body

- RelatedKeywordsDto
  - `keyword` string, required — 関連キーワード取得の元となる検索キーワード。1文字以上の文字列を指定する。
  - `matchType` 'partialMatch' | 'phraseMatch' | 'prefixMatch' | 'suffixMatch' | 'wordMatch' — キーワードのマッチタイプ。partialMatch: 部分一致 / phraseMatch: フレーズ一致 / prefixMatch: 前方一致 / suffixMatch: 後方一致 / wordMatch: 単語一致。省略時は partialMatch。
  - `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 — 最大値
    - `firstSeenRange` object — 出現時期フィルタ
      - `include` 'last_7_days' | 'last_30_days' | 'last_90_days' | 'within_6_months' | 'within_1_year' | 'over_1_year' — 出現時期の選択肢
  - `sortBy` 'seoDifficulty' | 'searchVolume' | 'cpc' | 'competition' | 'firstSeenRange' — 結果のソート項目。seoDifficulty / searchVolume / cpc / competition / firstSeenRange。省略時は searchVolume。
  - `orderBy` 'asc' | 'desc' — ソート順。asc: 昇順 / desc: 降順。省略時は desc。
  - `limit` integer — 取得件数の上限。1〜25000 の整数を指定。省略時は 1000 件。

## Response `200`

検索成功

- RelatedKeywordsResponseDto
  - `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 — 検索キーワードを元に取得した関連キーワード
      - `metrics` object, required — SEO関連の各種指標（検索ボリューム・SEO難易度・CPC・競合性・出現時期）
        - `seoDifficulty` number, nullable, required — SEO難易度。1–100で表し、高いほど難易度が高い（1–33:低 / 34–66:中 / 67–100:高）。不明な場合は null。
        - `searchVolume` number, nullable, required — 月間検索数（年平均）。不明な場合は null。
        - `cpc` number, nullable, required — 推定クリック単価（USD）。不明な場合は null。
        - `competition` number, nullable, required — 広告競合性。0–100で表し、高いほど競合性が高い（0–33:低 / 34–66:中 / 67–100:高）。不明な場合は null。
        - `firstSeenRange` 'last_7_days' | 'last_30_days' | 'last_90_days' | 'within_6_months' | 'within_1_year' | 'over_1_year', nullable, required — 出現時期。キーワードが最初にラッコキーワードデータベースで検出された時期を日付範囲ラベルで表す。不明な場合は null。
  - `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)