API
Overview
The Research API automates end-to-end web research — searching, reasoning, and structuring the results so you don’t have to.
The Research API helps you ask complex questions and receive structured answers backed by citations. Under the hood, Exa agents:
- Break your instructions into sub-tasks.
- Gather relevant sources from the public web.
- Extract key facts and reason over them with an LLM.
- Return JSON that exactly matches the schema you provided.
Because tasks are asynchronous, you submit a request and immediately receive a task id
. Poll the task until it is complete or failed, or list all tasks to monitor progress in bulk.
Core Endpoints
Action | Method & Path |
---|---|
Create a task | POST /research/tasks |
Get a task | GET /research/tasks/{id} |
List tasks | GET /research/tasks |
Typical Flow
- Create – Submit natural-language instructions and an output schema.
- Poll – Periodically call
GET /research/tasks/{id}
until the status iscompleted
. - Consume – Use the structured
output
returned by the task in your application.
You can also call GET /research/tasks
to retrieve a paginated list of tasks and their statuses.