Skip to main content
GET
/
research
/
v1
cURL
curl -X GET 'https://api.exa.ai/research/v1?limit=10' \
  -H 'x-api-key: YOUR-EXA-API-KEY'
{
  "data": [
    {
      "researchId": "01jszdfs0052sg4jc552sg4jc5",
      "model": "exa-research",
      "instructions": "What species of ant are similar to honeypot ants?",
      "status": "running"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Get your Exa API key

Authorizations

​
x-api-key
string
header
required

Your Exa API key

Query Parameters

​
cursor
string

The cursor to paginate through the results

Minimum string length: 1
​
limit
number
default:10

Number of results per page (1-50)

Required range: 1 <= x <= 50

Response

200 - application/json

List of research requests

​
data
(Pending · object | Running · object | Completed · object | Canceled · object | Failed · object)[]
required

Research requests ordered by creation time (newest first)

  • Pending
  • Running
  • Completed
  • Canceled
  • Failed
Example:
{
  "researchId": "01jszdfs0052sg4jc552sg4jc5",
  "model": "exa-research",
  "instructions": "What species of ant are similar to honeypot ants?",
  "status": "running"
}
​
hasMore
boolean
required

If true, use nextCursor to fetch more results

​
nextCursor
string | null
required

Pass this value as the cursor parameter to fetch the next page