Pause, resume or stop an advanced search
control_advanced_searchaction pause or stop takes effect after the batches running now (a queued batch is cancelled and refunded); resume carries on.
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": {
"campaign_id": "<campaign_id>",
"action": "<action>"
},
"name": "control_advanced_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | ||
| campaign_id | Yes | An id from run_advanced_search or list_advanced_searches. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| name | No | ||
| leads | No | Unique leads charged so far. | |
| places | No | How many places it searches. | |
| status | Yes | running | paused | completed | stopped. Paused by itself when a Free account runs out of leads (they don't renew: upgrade, then resume). | |
| estimate | No | { expected_leads, low, high, minutes } as estimated when it started. | |
| keywords | No | Each { keyword, exact }. | |
| lead_cap | No | ||
| resume_at | No | When a waiting search carries on by itself. | |
| created_at | No | ||
| leads_with | No | How to read its leads: query_leads or export_leads with campaign_id. | |
| finished_at | No | ||
| finish_reason | No | all_searched | lead_limit | stopped once finished; null while it runs. | |
| searches_done | No | ||
| status_detail | No | One sentence on where it is — e.g. waiting for the daily city budget, and until when, or why it was paused. | |
| searches_total | No | Keywords × places. |