Check the status and results of a deep research job with optional pagination
Parameter | Type | Required | Description |
---|---|---|---|
job_id | string | Yes | The job ID returned from initiating deep research |
Parameter | Type | Required | Description |
---|---|---|---|
page | integer | No | Page number (1-indexed). If not provided, returns all results without pagination |
page_size | integer | No | Number of results per page (1-100, default: 25). Only applies when page parameter is provided |
page
parameter is provided, all results are returned:
page
parameter is provided, results are paginated:
Status | Description |
---|---|
pending | Job is queued and waiting to start |
searching | Job is actively searching for profiles |
processing | Job is validating and processing found profiles |
completed | Job finished successfully with results |
error | Job encountered an error |
cancelled | Job was cancelled by user |
Status Code | Description |
---|---|
400 | Bad Request - Invalid pagination parameters (e.g., page < 1 or page_size out of range) |
401 | Unauthorized - API key missing or invalid |
403 | Forbidden - Not authorized to access this job |
404 | Not Found - Job ID does not exist |
page
parameter is provided, all results are returned (backward compatible)pagination
object is only included in responses when the page
parameter is providedfinal_results_count
field shows the total number of validated profiles across all pagesAPI key authentication. Keys start with 'lk_'.
Unique identifier for the deep research job (returned from POST /api/search/deep_research)
Page number (1-indexed). If not provided, returns all results without pagination
x >= 1
Number of results per page when pagination is used. Only applies when page parameter is provided
1 <= x <= 100
Job status and results (paginated if page parameter is provided)
The response is of type object
.