Company Logo
DocumentationBlog
GuidesAPI Reference
Crawl

Get the Status of a crawl job

Retrieves the current Status of a crawl job and its result if completed.

GET
/crawl/v1/status/{job_id}

Path Parameters

job_id*string

The job ID to get Status for

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://edge.uprock.com/crawl/v1/status/f2bf9f8b-10ee-4c61-9633-4eacc3e8aac8"
{
  "job_id": "f2bf9f8b-10ee-4c61-9633-4eacc3e8aac8",
  "method": "GET",
  "placement": {},
  "session_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "submitted_at": "2026-02-17T11:38:58.467667051Z",
  "timeout_sec": 30,
  "url": "https://example.com/"
}
"invalid request: url is required"
"unauthorized: invalid or missing API key"
"not found: job does not exist or you are not authorized to view it"
"internal server error: please try again later"

Start a new crawl job POST

Starts a new job to crawl a URL with the specified parameters. The job will be scheduled for execution on an appropriate device based on the requested capabilities and placement constraints. After submitting a job, use the Get Job Status endpoint to track its progress and retrieve results when completed.

Get detailed information about a crawl job GET

Retrieves detailed information about a crawl job including all headers, cookies, and result data.