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
}'
{
  "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

​
Rate Limits

Rate limits vary by subscription tier:
  • Free Tier: 2 requests per minute
  • Tier 1: 5 requests per minute
  • Tier 2: 50 requests per minute
  • Tier 3: 100 requests per minute

​
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 validated profile returned costs 1 credit.

Authorizations

​
Authorization
string
header
required

API key authentication. Keys start with 'lk_'.

Body

application/json

Deep research parameters including search query and optional settings

​
query
string

Natural language search query for deep research (required if criteria and opensearch_query are not provided)

​
limit
integer
default:30

Maximum number of profiles to research

Response

200 - application/json

Job initiated

​
job_id
string
​
status
string
​
message
string