Endpoint Playground
Returns the state of a research job by `job_id`: queued, running, cancelling, succeeded, failed or cancelled. The response carries `progress` counts, `research` progress (round, searches completed, sources read, questions answered), usage, warnings, `partial`, `deadline_at` and any error. A job not started within 30 minutes fails with `timeout`.
curl 'https://api.crawlora.net/api/v1/research/jobs/job-123' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| job_id (path) | string | Yes | job-123 | Research job ID |
{
"code": 200,
"msg": "OK",
"data": {
"job_id": "job-123",
"kind": "research",
"state": "running",
"cancel_requested": false,
"partial": false,
"created_at": "2026-10-09T11:00:00Z",
"updated_at": "2026-10-09T11:01:00Z",
"deadline_at": "2026-10-09T11:03:00Z",
"research": {
"round": 1,
"max_rounds": 3,
"searches_completed": 2,
"sources_read": 1,
"questions_answered": 1,
"questions_total": 3
},
"usage": {
"search_requests": 2,
"fetch_attempts": 1,
"fetched_urls": 1,
"browser_renders": 0,
"input_tokens": 0,
"output_tokens": 0,
"credits_reserved": 100,
"credits_charged": 11,
"credits_released": 0,
"settlement_pending": true
},
"warnings": []
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.