POST
/
api
/
search
/
deep_research
Initiate 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,
  "hard_filter_company_urls": [
    "<string>"
  ]
}'
{
  "job_id": "<string>",
  "status": "<string>",
  "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",
    "limit": 50,
    "hard_filter_company_urls": ["https://www.linkedin.com/company/google", "https://wwww.linkedin.com/company/microsoft"]
  }'

Request Body

ParameterTypeRequiredDefaultDescription
querystringYesThe search query to research.
limitintegerNo30The maximum number of results to return.
hard_filter_company_urlsarray of stringsNoA list of company LinkedIn URLs to filter results to specific companies.

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.

Authorizations

Authorization
string
header
required

API key authentication. Keys start with 'lk_'.

Body

application/json

Deep research parameters including search query and optional settings

The body is of type object.

Response

200 - application/json

Job initiated

The response is of type object.