---
title: "よくある質問検索取得"
method: POST
path: "/v1/question-search"
tags: ["よくある質問検索"]
---

# よくある質問検索取得

`POST /v1/question-search`

よくある質問検索。
指定キーワードを含む質問を、相対需要の高い順に最大1,000件取得する。
Q&A/SEO記事作成や、AIO/GEO/LLMO対策の際、質問サンプルを得るのに有用。

ラッコキーワードのDBに蓄積した質問文を返却する。
ユーザーがGoogle検索AIモードや、チャットAIに入力する可能性の高い質問・疑問を網羅的に集められる。

相対需要は、その検索結果内で最も需要が高い質問を100とした1〜100の相対値。
絶対的な検索数や表示回数ではないため、検索キーワードが異なる結果の間では比較できない。

質問文・相対需要・出現時期での絞り込み（filter）と、相対需要・出現時期での並び替え（sortBy / orderBy）ができる。

そのキーワードを検索したときにGoogle検索結果に表示される質問を取得したい場合はPOST /v1/other-keywordsを使う。

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

## Request body

- SearchQuestionDto
  - `keyword` string, required — よくある質問検索の元となる検索キーワード。1文字以上の文字列を指定する。
  - `filter` object — 結果のフィルタリング条件。質問文・相対需要・出現時期などで絞り込む。
    - `keyword` object — キーワードフィルタ（含む/含まない質問文の指定）
      - `includes` string[] — 含む単語のリスト（複数入力時はOR）
      - `notIncludes` string[] — 含まない単語のリスト（複数入力時はOR）
    - `relativeDemand` object — 相対需要フィルタ（1〜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` 'relativeDemand' | 'firstSeenRange' — 結果のソート項目。relativeDemand: 相対需要 / firstSeenRange: 出現時期。省略時は relativeDemand。
  - `orderBy` 'asc' | 'desc' — ソート順。asc: 昇順 / desc: 降順。省略時は desc。
  - `limit` integer — 出力数の上限。1〜1000 の整数を指定。省略時は 100。

## Response `200`

検索成功

- SearchQuestionResponseDto
  - `result` boolean, required — API 呼び出しの成否。正常時は true、エラー時は false。
  - `meta` object, required — リクエストに関するメタ情報（課金・消費リソースなど）
    - `consumedCredit` number, required — このリクエストで消費されたクレジット数。
  - `data` object, required — よくある質問検索結果データ
    - `query` object, required — 検索クエリ情報
      - `keyword` string, required — よくある質問検索の元になった検索キーワード
      - `filter` object — リクエストで指定された絞り込み条件（質問文・相対需要・出現時期）。指定がない場合は省略される。
        - `keyword` object — キーワードフィルタ（含む/含まない質問文の指定）
          - `includes` string[] — 含む単語のリスト（複数入力時はOR）
          - `notIncludes` string[] — 含まない単語のリスト（複数入力時はOR）
        - `relativeDemand` object — 相対需要フィルタ（1〜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` 'relativeDemand' | 'firstSeenRange', required — リクエストで指定されたソート項目。relativeDemand: 相対需要 / firstSeenRange: 出現時期。
      - `orderBy` 'asc' | 'desc', required — リクエストで指定されたソート順。asc: 昇順 / desc: 降順。
      - `limit` integer, required — リクエストで指定された出力数の上限
    - `summary` object, required — 件数サマリー（全体件数とレスポンスに含まれる件数）
      - `totalCount` number, required — 取得対象全体の件数
      - `returnedCount` number, required — このレスポンスに含まれている件数
    - `items` object[], required — 質問アイテムのリスト
      - `question` string, required — 検索キーワードに関連する質問
      - `metrics` object, required — 質問の各種指標（相対需要・出現時期）
        - `relativeDemand` number, required — 相対需要。検索結果内での相対的な需要の高さ（1〜100）。高いほどよく見られている質問。
        - `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)