Skip to main content
POST
/
ai
/
v1
/
deep-research
Create a deep research job
curl --request POST \
  --url https://api.messari.io/ai/v1/deep-research \
  --header 'Content-Type: */*' \
  --header 'X-Messari-API-Key: <api-key>' \
  --data '
{
  "query": "<string>",
  "instructions": "<string>",
  "job_id": "aSDinaTvuI8gbWludGxpZnk="
}
'
{
  "created_at": 123,
  "job_id": "aSDinaTvuI8gbWludGxpZnk=",
  "model": "<string>",
  "object": "<string>",
  "query": "<string>",
  "status": "<string>"
}

Authorizations

​
X-Messari-API-Key
string
header
required

Body

*/*
​
query
string
required

The research query or topic for the deep research report

​
instructions
string

Optional system instructions to guide the research process and report generation style

​
job_id
string<byte>

Optional UUID of an existing deep research conversation to continue with a follow-up message

Response

Default response

​
created_at
integer<int64>
required

Unix timestamp when the job was created

​
job_id
string<byte>
required

Unique identifier for the deep research job

​
model
string
required

Model used for the deep research

​
object
string
required

Type of object returned, always 'deep_research'

​
query
string
required

The research query that was submitted for this job

​
status
string
required

Current status of the deep research job: queued, in_progress, completed, failed, cancelled