POST
/
api
/
search
/
deep_research
/
{job_id}
/
continue
Continue Deep Research
curl --request POST \
  --url https://search.clado.ai/api/search/deep_research/{job_id}/continue \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "additionalLimit": 30
}'
{
  "job_id": "<string>",
  "status": "<string>",
  "message": "<string>"
}
Continue a completed deep research job to get additional results. This allows you to expand your search beyond the initial limit.

​
Continue Deep Research

curl -X POST https://search.clado.ai/api/search/deep_research/550e8400-e29b-41d4-a716-446655440000/continue \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "additionalLimit": 50
  }'

​
Path Parameters

ParameterTypeRequiredDescription
job_idstringYesThe job ID of the completed deep research job

​
Request Body

ParameterTypeRequiredDefaultDescription
additionalLimitintegerNo30Number of additional results to find

​
Response

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

​
Requirements

  • The original job must be in “completed” status
  • There must be more unprocessed results available
  • You must have sufficient credits for the additional results

​
Error Responses

Status CodeDescription
401Unauthorized - API key missing or invalid
402Payment Required - Insufficient credits
404Not Found - Job ID does not exist
409Conflict - Job is not in completed status or no more results available
500Internal Server Error - Error initiating continuation

​
Notes

  • Each additional profile returned costs 1 credit
  • Rate limited to 5 requests per minute per API key
  • Use Get Deep Research Status to monitor progress
  • Results will be appended to the original job results
  • Maximum total results per job is typically 1000 profiles

Authorizations

​
Authorization
string
header
required

API key authentication. Keys start with 'lk_'.

Path Parameters

​
job_id
string
required

Unique identifier for the deep research job to continue

Body

application/json

Response

200 - application/json

Continuation initiated

The response is of type object.