POST
/
api
/
search
/
deep_research
curl --request POST \
  --url https://search.clado.ai/api/search/deep_research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "query": "<string>",
  "limit": 30,
  "email": "<string>"
}'
{
  "job_id": "<string>",
  "status": "pending",
  "message": "<string>"
}

Deep research is an advanced search feature that performs a broad search to provide comprehensive results. The process is asynchronous and uses a job-based system. To check the status of a job, use the Get Research Status endpoint.

​
Initiate Deep Research

curl -X POST https://search.clado.ai/api/search/deep_research \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "software engineers in San Francisco",
    "limit": 50,
    "email": "user@example.com"
  }'

​
Request Body

ParameterTypeRequiredDefaultDescription
querystringYesThe search query to research.
limitintegerNo30The maximum number of results to return.
emailstringNoAn email address to notify when the job is complete.

​
Response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "message": "Deep research job initiated"
}

​
Error Responses

Status CodeDescription
401Unauthorized - API key missing or invalid
402Payment Required - Insufficient credits

​
Notes

  • Deep research jobs can take several minutes to complete.
  • The job_id returned in the response is used to check the status of the research.
  • Each result costs 1 credit.

Authorizations

​
Authorization
string
header
required

API key must be provided as a Bearer token in the Authorization header. Example: lk_your_api_key_here

Body

application/json

Response

200
application/json

Deep research job initiated successfully

The response is of type object.