GET
/
api
/
search
/
deep_research
/
{job_id}
curl --request GET \
  --url https://search.clado.ai/api/search/deep_research/{job_id} \
  --header 'Authorization: Bearer <token>'
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "message": "Job completed successfully",
  "results": [
  ],
  "total": 1,
  "query": "software engineers in San Francisco",
  "created_at": 1678886400
}

This endpoint allows you to check the status of a deep research job and retrieve the results once it is complete.

​
Get Job Status

curl -X GET https://search.clado.ai/api/search/deep_research/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Path Parameters

ParameterTypeRequiredDescription
job_idstringYesThe ID of the deep research job.

​
Response

The response will include the job status. If the job is completed, the results array will be populated.

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "message": "Job completed successfully",
  "results": [
  ],
  "total": 1,
  "query": "software engineers in San Francisco",
  "created_at": 1678886400
}

​
Job Statuses

StatusDescription
pendingThe job has been created and is waiting to be processed.
processingThe job is currently being processed.
completedThe job has finished successfully. Results are available.
errorAn error occurred during processing.

​
Error Responses

Status CodeDescription
401Unauthorized - API key missing or invalid.
403Forbidden - Not authorized to access this job.
404Not Found - Job not found.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
job_id
string
required

The ID of the deep research job

Response

200
application/json

Job status and results retrieved successfully

The response is of type object.