Skip to main content
POST
Rerun a Scraper Studio job
Start a new run from an existing Bright Data Scraper Studio job. Send no request body to rerun the full job from the beginning, or send failed_only: 1 to rerun only the steps that failed. A successful request starts a new job and returns its collection_id. The original job is left untouched.
Only jobs whose data has not expired can be rerun. Check the job’s expired timestamp in List Scraper Studio jobs or Get job metadata before calling this endpoint. If the data has expired, the rerun fails and you must trigger a new job with the original inputs.Scraper Studio retains batch collection results for 16 days and real-time results for 7 days. See Scraper Studio specifications.

Rerun behavior

Request

Send the request without a body to rerun everything:
Add failed_only: 1 to retry only the failed steps:

Response

Use the returned collection_id as the job_id for Get job metadata and Receive batch data. It identifies the new rerun job, not the original one.

How to find a job ID

Use the jobs list endpoint to find the ID of the job you want to rerun:
Use the returned id value as the job_id path parameter. See List Scraper Studio jobs for the full parameter list.

When to use this endpoint

  • Retry the failed inputs from a batch after fixing a selector or parser, without recollecting the inputs that already succeeded
  • Recollect a full job on a schedule to refresh data that changes over time
  • Rerun after a target site incident that caused a burst of blocked or detect_block errors
To see which inputs failed and why before deciding between a full rerun and failed_only, use Get errors for a job.

Authorizations

Authorization
string
header
required

Use your Bright Data API Key as a Bearer token in the Authorization header.

How to authenticate:

  1. Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
  2. Include the API Key in the Authorization header of your requests
  3. Format: Authorization: Bearer YOUR_API_KEY

Example:

Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication

Path Parameters

job_id
string
required

ID of the job to rerun

Body

application/json

Omit the body to rerun the full job. Send failed_only: 1 to rerun only the failed steps.

failed_only
number

Set to 1 to rerun only the failed steps. Omit to rerun the full job.

Example:

1

Response

Rerun job started

collection_id
string

ID of the new rerun job

start_eta
string<date-time>

Estimated start time of the rerun job