List Scraper Studio jobs
GET /dca/collector/jobs returns the Scraper Studio jobs in your account. Filter by scraper ID and date range, and paginate with offset and limit.
GET /dca/collector/jobs to retrieve the Bright Data Scraper Studio jobs in your account. Filter the list by scraper ID and date range, and control pagination with offset and limit.
from_date and to_date are required. Use a narrower date range for faster responses and easier pagination.
collector parameter to return only that scraper’s jobs. Get scraper IDs from List Scrapers.Filter, paginate and sort
- Filter by scraper. Pass a scraper ID as the
collectorparameter to return only that scraper’s jobs. Get IDs from List Scrapers. - Paginate. Use
offsetandlimitto page through jobs. To retrieve the next page, increaseoffsetby the previouslimit, for exampleoffset=0&limit=100, thenoffset=100&limit=100.limitmust be between 0 and 500. - Sort. Use
sort_asc=1for ascending order orsort_asc=-1for descending order. The default is-1.
When to use this endpoint
- Build a dashboard that lists recent jobs for a scraper across a date range
- Audit job history and compute success rates from
inputs,data_linesandfailed_pages - Look up job IDs, then fetch per-job metadata with Job data
- Spot scrapers that need attention by watching
failed_pages
Errors
| Status | Cause | Fix |
|---|---|---|
400 Bad Request | Missing or malformed from_date or to_date | Send both dates in YYYY-MM-DD format |
401 Unauthorized | Token missing, malformed or revoked | Re-copy from Account Settings → API Tokens |
5xx | Transient Bright Data API error | Retry with exponential backoff, for example 1s, 2s, 4s |
Related
- List Scrapers: find the scraper
idto pass as thecollectorparameter - Job data: job-level metadata for a single job
- Receive batch data: download the records a job produced
- Trigger async batch collection: the endpoint that creates jobs
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
Query Parameters
Start date for the jobs list, in YYYY-MM-DD format.
"2026-06-01"
End date for the jobs list, in YYYY-MM-DD format.
"2026-07-13"
Scraper ID used to filter jobs for a specific scraper. Get IDs from the List Scrapers endpoint.
"c_example1234567890"
Number of jobs to skip before returning results. Used for pagination.
Maximum number of jobs to return. Must be between 0 and 500.
0 <= x <= 500Sort direction. Use 1 for ascending order or -1 for descending order.
1, -1