intent_finder

Parameters

Request examples

curl -X POST https://daas.listeningmind.ai/v1/intent_finder \
  -H "Authorization: Bearer $LM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 20, "keyword": "running shoes", "market": "us", "max_lima": 2}'

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "intent_finder",
    "arguments": {
      "limit": 20,
      "keyword": "running shoes",
      "market": "us",
      "max_lima": 2
    }
  }
}

// A browser agent with this page open
const est = await document.modelContext.callTool("estimate_cost", {
  tool: "intent_finder", arguments: {"limit": 20, "keyword": "running shoes", "market": "us", "max_lima": 2}
});
const res = await document.modelContext.callTool("intent_finder", {"limit": 20, "keyword": "running shoes", "market": "us", "max_lima": 2});

Response

The start of a real response saved from the 2026-08-24 run for running shoes in United States. Full result →

{
  "id": "ex-intent_finder-us",
  "tool": "intent_finder",
  "market": "us",
  "status": "done",
  "mode": "sample",
  "as_of": "2026-08-24",
  "epistemic": "OBSERVED",
  "request": {
    "limit": 20,
    "keyword": "running shoes",
    "market": "us"
  },
  "items": [
    {
      "rank": 1,
      "keyword": "running shoes"
    },
    {
      "rank": 2,
      "keyword": "nike running shoes"
    },
    {
      "rank": 3,
      "keyword": "hoka running shoes for women"
    },
    {
      "rank": 4,
      "keyword": "best running shoes"
    },
    {
      "rank": 5,
      "keyword": "new balance running shoes"
    },
    {
      "rank": 6,
      "keyword": "best running shoes for men"
    }
  ],
  "cost_detail": {
    "total_cost": 0,
    "unit": "lima",
    "would_cost": 2,
    "note": "Saved sample. No Lima was used."
  },
  "provenance": {
    "system": "Intent KG",
    "run_id": "64225b5571fb",
    "collected": "2026-08-24",
    "sources": [
      "google"
    ]
  },
  "untrusted_content": false
}

Response fields

Errors

Errors come as application/problem+json. What to do next is in next.

HTTP/1.1 402 Payment Required
Content-Type: application/problem+json

{
  "type": "https://www.listeningmind.ai/errors/budget",
  "title": "The price is above max_lima",
  "status": 402,
  "price": 2,
  "unit": "lima",
  "max_lima": 1,
  "next": "Each call costs 2 Lima. Raise max_lima to at least 2."
}

Examples built on it

ICSSBefore fielding a survey, does this question split responses?Prompt BuilderDoes our brand appear when customers ask AI?Brand Naming AgentWhich protectable names come from the words customers search?Intent KGCan one topic become a market knowledge graph?