Skip to main content
POST
/
search
/
v1
/
research
Comprehensive multi-step research
curl --request POST \
  --url https://api.case.dev/search/v1/research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instructions": "<string>",
  "query": "<string>",
  "model": "normal",
  "outputSchema": {}
}
'
{
  "researchId": "research_abc123",
  "model": "normal",
  "results": {
    "summary": "Comprehensive analysis of contract law precedents...",
    "sources": [
      "Supreme Court ruling in...",
      "Federal statute..."
    ],
    "analysis": "Key findings indicate..."
  }
}

Authorizations

Authorization
string
header
required

API key starting with sk_case_

Body

application/json

Research configuration

instructions
string
required

Research instructions or query

query
string

Alias for instructions (for convenience)

model
enum<string>
default:normal

Research quality level - fast (quick), normal (balanced), pro (comprehensive)

Available options:
fast,
normal,
pro
outputSchema
object

Optional JSON schema to structure the research output

Response

Research completed successfully

researchId
string

Unique identifier for this research

model
string

Model used for research

results
object

Research findings and analysis