Start a search (spends credits)
run_searchStarts a ready search for leads leads. SPENDS CREDITS: first call quote_search, show the price to the user, and only after their explicit yes call this with confirm_credits = the quote's credits_high. stop_at_target (default true) stops at the number of leads. Returns at once (maybe queued); then poll get_search every 30-60 s. Needs a plan or credits on the balance. [REST: POST /api/tasks/{id}/run]
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"task_id": "<task_id>",
"leads": "<leads>",
"confirm_credits": "<confirm_credits>"
},
"name": "run_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| leads | Yes | ||
| task_id | Yes | The search id (task id), e.g. from list_searches or create_search. | |
| version | No | The spec version from get_search (optional: protects against an edit made meanwhile in the web). | |
| stop_at_target | No | ||
| confirm_credits | Yes | The price in credits the matching quote returned, shown to the user and confirmed by them. |