Continue search
Fetch one bounded next turn of an immutable staged search.
Tool: continue_search
Cursors belong to search_id, not lead groups, so company and people searches continue independently. Each turn requires the current search_version and consumes that version even on a retryable provider failure, preventing stale or replayed continuation calls. Call this only after showing the current count and examples and receiving an explicit user request for another turn; never loop it automatically. The response preserves search context on provider failure. NOT for: changing filters → start a new typed search; saving rows → save_search.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
search_id | string | yes | The durable staged search to continue. |
search_version | integer | yes | The current version returned with the staged search. |
limit | integer | no | Maximum provider rows for this bounded turn. |
The search owns its private provider cursor; lead groups never do.
The version is consumed even when a retryable provider call fails, preventing stale or replayed continuation calls.
Changing any query input requires a new typed starter search.
Sample request — success
{
"search_id": "src_JF-IFWLT1jfUJPTx",
"search_version": 2
}Sample request — source continuation
{
"search_id": "src_YtuVm5XgzK0dMr62",
"search_version": 2
}