Ask

POST /properties/{pid}/ask — ask a question in plain English, get the answer Eureka's analyst (Claude) gives in the app. Scope ask.

json

{ "question": "Where do agents drop off in checkout compared with humans?" }

Mention the period in the question ("last month", "since September 1st"); otherwise the analyst picks one, usually the last 28 days.

Response:

json

{
  "question": "Where do agents drop off in checkout compared with humans?",
  "title": "Checkout funnel: agents vs humans",
  "answer": "Agents drop off mostly at the delivery slot step: 24% of the agents who reach /checkout/delivery-slot pick a slot, against 90% of humans…",
  "kind": "funnel",
  "chart": "funnel",
  "report_spec": { "steps": [ … ], "breakdown": "actor_family" },
  "result": { … },
  "calls": [ … ],
  "model": "claude-…",
  "quota": { "used": 215, "limit": 1000 }
}

The analyst runs real reports on your property (at most 8 per question) and writes the answer from their results; calls lists them. It answers in the language of the question.
Each call counts toward your plan's monthly AI questions (Growth 200, Pro 1,000, Scale 5,000). When they are used up, the API returns 429 with code quota_exceeded.
report_spec can be replayed with the reports or funnels endpoints to refresh the figures without asking again.

Ask ​

Ask