Skip to main content
POST
Find potential buyers

Authorizations

X-API-Key
string
header
required

Send X-API-Key: sk_live_<your_key>. Keys are issued via POST /signup or via the dashboard. Legacy callers may also use Authorization: Bearer sk_live_<your_key>.

Body

application/json
prompt
string
required

What you sell and who you want to find, as you would tell the sales agent in chat.

Required string length: 1 - 10000
idempotency_key
string | null

Reuse this key within your organization to retrieve the original run, even if the prompt changes. Use a new key for each fresh search. Omit it to create a new run on every POST.

Required string length: 1 - 200
wait_seconds
number
default:0

Wait up to this many seconds for the background run to finish. A 202 response does not cancel the run; poll GET /sales/runs/{run_id}.

Required range: 0 <= x <= 25

Response

Successful Response

run_id
string
required
status
string
required

queued, running, completed, paused_budget, failed, or cancelled.

prompt
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
stop_reason
string | null

Reason execution stopped, when available. A completed run can still have bounded or incomplete coverage.

search_mode
string | null

Search mode this run used: economy (default) or quality. Set per organization; null until the run starts.

answer
string | null

The agent's written findings and buyer qualification; null until available.

evidence
SalesEvidence · object[]

Collected public source material, including items the agent may reject as leads. Read answer for its judgment; an empty list does not prove there are no buyers.