Checking Job Status

Some Scraper API endpoints process requests asynchronously.

Instead of returning the final result immediately, the API creates a job and returns a unique job ID. You can use that job ID to check the progress of the request.

Common job statuses include:

Check a Job

Use the endpoint associated with your API to retrieve the latest status of a job.

For example:

GET /v1/extract/jobs/{job_id}

or

GET /v1/batch/jobs/{job_id}

or

GET /v1/crawl/jobs/{job_id}

The response contains the current status and any available results.

Typical Workflow

Create Request
        │
        ▼
Receive Job ID
        │
        ▼
Check Job Status
        │
        ▼
Completed
        │
        ▼
Read Results

Continue checking the job until its status changes to completed or failed.

When to Use

Checking job status is useful when:

• Processing large requests
• Crawling multiple pages
• Running batch operations
• Using asynchronous processing modes