client.run() hands your prompt to a cloud agent, waits
while it does the research, and returns finished rows.
1. Install
2. Run your first task
client.run() starts a task, polls until it finishes, and returns the output.
result.output is the list of rows the task produced. result.task_id is the durable id.
Keep it to continue or re-read the task later.
What a task can do
- Data extraction: scrape sites and collect structured rows with sources
- Enrichment: fill in people, companies, jobs, contacts, filings
- Multi-step research: search across many sources, compare, and summarize
- List building: find N entities that match criteria, with per-row evidence
- Continuation: refine, expand, or fix a previous task without starting over
Next
Structured output
Get typed objects back with a Pydantic or Zod schema.
Live messages
Stream events as the agent works.
Follow-up tasks
Continue the same task with new instructions.
Python SDK
Full method reference.