Rerun a Scraper Studio job
Manage jobs
Rerun a Scraper Studio job
POST /dca/jobs//rerun starts a new run from an existing Bright Data Scraper Studio job. Rerun everything, or send failed_only to retry failures.
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
Add
Use the returned
Use the returned
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.
Rerun behavior
Request
Send the request without a body to rerun everything:failed_only: 1 to retry only the failed steps:
Response
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: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
blockedordetect_blockerrors
failed_only, use Get errors for a job.
Related
- Get errors for a job: identify which inputs failed before rerunning
- Get job metadata: check the
expiredtimestamp and failure count of the original job - List Scraper Studio jobs: find the
job_idto pass to this endpoint - Cancel a Scraper Studio job: stop a rerun that was started by mistake
Authorizations
Use your Bright Data API Key as a Bearer token in the Authorization header.
How to authenticate:
- Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
- Include the API Key in the Authorization header of your requests
- 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
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.
Set to 1 to rerun only the failed steps. Omit to rerun the full job.
Example:
1