認識構造 API

検索語を意図ごとのクラスターにまとめた、消費者の認識構造

APIListeningMind.AIですぐ使う

何をするか

検索語を意図ごとのクラスターにまとめた、消費者の認識構造

カテゴリーを顧客視点のサブテーマに分けたいとき

使用サンプル

リクエスト

curl -X POST https://daas.listeningmind.ai/v1/cluster_finder \
  -H 'Authorization: Bearer $LM_KEY' -H 'Content-Type: application/json' \
  -d '{"keyword": "ノンアルコールビール", "limit": 500, "market": "jp"}'

レスポンス(実際のサンプル、先頭部分) · 2026-09-30

{
 "id": "ex-cluster_finder-jp",
 "tool": "cluster_finder",
 "market": "jp",
 "status": "done",
 "mode": "sample",
 "as_of": "2026-09-30",
 "epistemic": "OBSERVED",
 "clusters": [
  {
   "name": "ノンアルコール ビール クラスタ 0",
   "keywords": [
    "ノンアルコール 意味がわからない",
    "ノンアルコールビール なんのため",
    "ノンアルコール飲んでは いけない 理由",
    "ノンアルコールを飲む理由",
    "ノンアルコールジュース 違い",
    "ノンアル 飲む意味",
    "ノンアルコール 運転",
    "ノンアルコール なんのため"
   ]
  },
  {
   "name": "ノンアルコール ビール クラスタ 1",
   "keywords": [
    "ノンアルコール ビール",
    "未来のレモンサワー ノンアル 口コミ",
    "未来の ノンアル レモン サワー 美味しい",
    "未来のレモン サワー ノンアル 値段",
    "未来 の レモン サワー ノンアル 値段",
    "未来のレモンサワー ノンアル",
    "未来 の ノンアル レモン サワー キャンペーン",
    "未来の ノンアル レモン サワー 価格"
   ]
  },
  {
   "name": "ノンアルコール ビール クラスタ 2",
   "keywords": [
    "ノンアルコール 子供は",
    "ノンアルコール ニュース",
    "ノンアルコール美味しい ランキング",
    "ノンアル 運転 違反",
    "ノン アルコール 売り上げ",
    "ノンアル 運転 警察",
    "ノンアルコール 需要",
    "ノンアルコール アルコール入っ てる"
   ]
  },
  {
   "name": "ノンアルコール ビール クラスタ 3",
   "keywords": [
    "ベリーニ ノンアルコール カクテル",
    "ベリーニ カクテル レシピ",
    "ベリーニ カクテル アレンジ",
    "ノンアルコール ジュース",
    "ノンアルコール ロゼ スパークリング",
    "ノンアルコール ぶどうジュース",
    "ノン アルコール スパークリング ジュース",
    "ベリーニ 度数"
   ]
  },
  {
   "name": "ノンアルコール ビール クラスタ 4",
   "keywords": [
    "微アルコール sky",
    "業務スーパー ビール ドイツ",
    "業務用スーパー お酒",
    "ロー アルコール ビール 運転",
    "スカイブルー 販売中止 理由",
    "sky ビール 通販",
    "業務スーパービール 500ml",
    "ビール もどき"
   ]
  },
  {
   "name": "ノンアルコール ビール クラスタ 5",
   "keywords": [
    "ノンアルコール飲料 歴史",
    "昔のノンアルコールビール",
    "キリン フリー",
    "ノンアルコール いつから飲める",
    "ノン アルコール ビール wiki",
    "ノンアルコールビール日本初",
    "ノンアル ビール 歴史",
    "ノンアル カクテル"
   ]
  }
 ],
 "cost_detail": {
  "total_cost": 0,
  "unit": "lima",
  "would_cost": 183,
  "note": "Saved sample. No Lima was used."
 },
 "provenance": {
  "system": "Intent KG",
…

接続する

Claude

設定 → コネクタ → カスタムコネクタを追加し、アドレスを貼り付けます。

https://daas.listeningmind.ai/mcp

ChatGPT

GPTを作成 → アクション → OpenAPIスキーマを取り込みます。

https://daas.listeningmind.ai/openapi.json

Cursor · Claude Code

mcp.jsonにサーバーを追加します。

https://daas.listeningmind.ai/mcp

REST

Authorization: Bearer キーで呼び出します。

https://daas.listeningmind.ai/v1

権限と安全

範囲検索データの照会と分析の実行。外部システムは変更しません。
費用呼び出す前に値段を確認でき(estimate_cost)、max_limaを超える呼び出しは実行しません。
人の承認キーの発行と月間上限は人が承認します。個別の呼び出しは上限内で承認なしに実行されます。

買い方

人が買うとき

リマをチャージして使った分だけ差し引きます(1リマ = 10円、1リマ単位)。現在チャージは相談で承ります。チャージの相談 · m-support@listeningmind.com

エージェントが買うとき

エージェントはPOST /v1/keys/requestでキーを申請し、POST /v1/estimate_costで値段を確認してからPOST /v1/cluster_finderを呼び出します。

評価 ·

    まだ評価がありません。

    評価できる人: 自分のメールで受け取ったAPIキーでデータを使った会員. 名前は最初の一文字だけ表示されます。もう一度残すと前の評価を置き換えます。

    よくある質問

    認識構造 APIとは何ですか?

    検索語を意図ごとのクラスターにまとめた、消費者の認識構造。

    料金はいくらですか?

    1回2リマ+クラスター内のキーワード1,000件あたり650リマ。

    どう始めますか?

    キーはすぐ発行され毎月の無料枠があり、サンプル呼び出しは無料です。