Use for a quick synchronous search when the user supplies one natural-language brief and can wait for results in the current tool call. For durable progress, retry, export, or large agent workflows, use start_lead_search instead.

Use for a quick synchronous search when target, geography, and qualification fields are already structured. Use research_businesses for a plain-language brief, or start_lead_search for durable asynchronous work.

Return deterministic fictional businesses without consuming provider capacity. Use this to test schemas, clients, and agent loops.

Use for the recommended durable asynchronous workflow. Creates a private queued search job and returns a job id plus jobToken for progress polling, cursor paging, refinement, retry, cancellation, and CSV or JSON export.

Read job status or one cursor-paginated result page. Keep jobToken private and pass nextCursor back unchanged.

Create a new private search job by changing the brief or criteria of a completed job. The original job stays unchanged.

Create a replacement job when a prior job failed or exceeded its execution window. The original job stays available for audit.

Cancel a queued or running search job. Completed and failed jobs remain immutable.

Get result semantics, limits, interface URLs, and safe operating guidance. This tool does not consume a search.