Create a task

Create an asynchronous research task that explores the web, gathers sources, synthesizes findings, and returns results with citations. Can be used to generate:

Structured JSON matching an output.schema you provide.
Structured data matching a schema generated by an LLM when output.inferSchema is provided.
A detailed markdown report when no schema is provided.

The API responds immediately with a task id for polling completion status. For more details, see Exa Research.

Alternatively, you can use the OpenAI compatible chat completions interface.

POST

research

tasks

curl --request POST \
  --url https://api.exa.ai/research/v0/tasks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "instructions": "What species of ant are similar to honeypot ants?",
  "model": "exa-research",
  "output": {
    "schema": {
      "type": "object",
      "properties": {
        "answer": {
          "type": "string"
        }
      }
    }
  }
}'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Get your Exa API key

Authorizations

x-api-key

string

header

required

API key can be provided either via x-api-key header or Authorization header with Bearer scheme

Body

application/json

Response

201 - application/json

Research task created

The response is of type object.

curl --request POST \
  --url https://api.exa.ai/research/v0/tasks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "instructions": "What species of ant are similar to honeypot ants?",
  "model": "exa-research",
  "output": {
    "schema": {
      "type": "object",
      "properties": {
        "answer": {
          "type": "string"
        }
      }
    }
  }
}'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Changelog

Get your Exa API key

Authorizations

Body

Response