run_collector
Execute a data collection job by slug with semantic input, returning rows directly or a run ID to poll when processing takes longer.
Instructions
Run a Collector by slug with a semantic input (see list_collectors for each collector's inputSchema and example). Short runs return the rows inline; long runs return 202 with a run_id + statusUrl — poll with collector_run_status. Results are billed per delivered row (never for failures). Set async true to force background execution.
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": {
"slug": "<slug>",
"input": "<input>"
},
"name": "run_collector"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | Collector slug from list_collectors, e.g. 'google_maps_places' | |
| async | No | Force background execution and return a run_id to poll | |
| input | Yes | Input fields matching the collector's inputSchema (e.g. { keyword: 'dentist', location: 'Austin, TX', max_results: 20 }) |