Search evidence

Semantic search across the team's evidence. Returns scored, attributed quotes matching a natural-language query.

POST/v1/evidence/search

Example

curl -X POST "https://example.com/v1/evidence/search" \  -H "Authorization: Bearer $ASKENGINE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "query": "confusion setting up API keys",    "limit": 10  }'

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*string

Natural-language search query.

studyId?string

Restrict the search to one study.

kind?EvidenceKind

Default"evidence"

Value in

"evidence"
"counterEvidence"

limit?integer

Maximum number of hits to return.

Range1 <= value <= 50

Default10

minScore?number

Drop hits scoring below this threshold.

Range0 <= value <= 1

Response

{  "data": [    {      "item": {        "evidenceId": "ev_001",        "kind": "evidence",        "quote": "I gave up twice before I figured out where to add my API key.",        "relevance": 0.91,        "themeId": "thm_setup",        "themeLabel": "Setup friction",        "studyId": "std_789",        "studyName": "Onboarding interviews Q4",        "sourceItemId": "src_a1",        "participantId": "par_9",        "participantName": "Ada L.",        "timeInCallSecs": 412,        "capturedAt": 1764453600000      },      "score": 0.83    }  ]}