よくある質問検索

よくある質問検索取得

よくある質問検索。 指定キーワードを含む質問を、相対需要の高い順に最大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クレジットを消費。

post/v1/question-search

Request body

keywordstring required

よくある質問検索の元となる検索キーワード。1文字以上の文字列を指定する。

sortBy'relativeDemand' | 'firstSeenRange'

結果のソート項目。relativeDemand: 相対需要 / firstSeenRange: 出現時期。省略時は relativeDemand。

orderBy'asc' | 'desc'

ソート順。asc: 昇順 / desc: 降順。省略時は desc。

limitinteger

出力数の上限。1〜1000 の整数を指定。省略時は 100。

Example request

{
  "keyword": "ラッコ",
  "filter": {
    "keyword": {
      "includes": [
        "水族館"
      ],
      "notIncludes": [
        "グッズ"
      ]
    },
    "relativeDemand": {
      "min": 34,
      "max": 66
    },
    "firstSeenRange": {
      "include": "last_30_days"
    }
  },
  "limit": 100
}

Response

検索成功

resultboolean required

API 呼び出しの成否。正常時は true、エラー時は false。

errorsstring[] required

エラーメッセージの配列。正常時は空配列。

Example response

{
  "result": true,
  "meta": {
    "consumedCredit": 1.5
  },
  "data": {
    "query": {
      "keyword": "ラッコ",
      "filter": {
        "keyword": {
          "includes": [
            "水族館"
          ],
          "notIncludes": [
            "グッズ"
          ]
        },
        "relativeDemand": {
          "min": 34,
          "max": 66
        },
        "firstSeenRange": {
          "include": "last_30_days"
        }
      },
      "sortBy": "relativeDemand",
      "orderBy": "desc",
      "limit": 100
    },
    "summary": {
      "totalCount": 150,
      "returnedCount": 100
    },
    "items": [
      {
        "question": "ラッコが絶滅しそうな理由は何ですか?",
        "metrics": {
          "relativeDemand": 87,
          "firstSeenRange": "last_30_days"
        }
      }
    ]
  },
  "errors": []
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.