Skip to main content
GET
List Scraper Studio jobs
Use 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.
Pass a scraper ID as the 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 collector parameter to return only that scraper’s jobs. Get IDs from List Scrapers.
  • Paginate. Use offset and limit to page through jobs. To retrieve the next page, increase offset by the previous limit, for example offset=0&limit=100, then offset=100&limit=100. limit must be between 0 and 500.
  • Sort. Use sort_asc=1 for ascending order or sort_asc=-1 for 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_lines and failed_pages
  • Look up job IDs, then fetch per-job metadata with Job data
  • Spot scrapers that need attention by watching failed_pages

Errors

StatusCauseFix
400 Bad RequestMissing or malformed from_date or to_dateSend both dates in YYYY-MM-DD format
401 UnauthorizedToken missing, malformed or revokedRe-copy from Account Settings → API Tokens
5xxTransient Bright Data API errorRetry with exponential backoff, for example 1s, 2s, 4s

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

Query Parameters

from_date
string<date>
required

Start date for the jobs list, in YYYY-MM-DD format.

Example:

"2026-06-01"

to_date
string<date>
required

End date for the jobs list, in YYYY-MM-DD format.

Example:

"2026-07-13"

collector
string

Scraper ID used to filter jobs for a specific scraper. Get IDs from the List Scrapers endpoint.

Example:

"c_example1234567890"

offset
integer
default:0

Number of jobs to skip before returning results. Used for pagination.

limit
integer
default:50

Maximum number of jobs to return. Must be between 0 and 500.

Required range: 0 <= x <= 500
sort_asc
enum<integer>
default:-1

Sort direction. Use 1 for ascending order or -1 for descending order.

Available options:
1,
-1

Response

200 - application/json

A paginated list of Scraper Studio jobs.

total
integer

Total number of jobs matching the request.

offset
integer

Zero-based index of the first job returned.

limit
integer

Maximum number of jobs returned in the response.

data
object[]

List of job objects.