跳转到主要内容
GET
List Scraper Studio jobs
使用 GET /dca/collector/jobs 获取您账户中的 Bright Data Scraper Studio 作业。可按爬虫 ID 和日期范围过滤列表,并使用 offsetlimit 控制分页。 from_dateto_date 为必填项。使用较窄的日期范围可获得更快的响应并更便于分页。
将爬虫 ID 作为 collector 参数传入,仅返回该爬虫的作业。爬虫 ID 可从列出爬虫获取。

过滤、分页和排序

  • 按爬虫过滤。 将爬虫 ID 作为 collector 参数传入,仅返回该爬虫的作业。ID 可从列出爬虫获取。
  • 分页。 使用 offsetlimit 分页浏览作业。要获取下一页,请将 offset 增加上一页的 limit 值,例如 offset=0&limit=100,然后 offset=100&limit=100limit 必须介于 0 和 500 之间。
  • 排序。 使用 sort_asc=1 表示升序,sort_asc=-1 表示降序。默认值为 -1

何时使用该端点

  • 构建一个按日期范围列出某个爬虫近期作业的仪表盘
  • 审计作业历史,并根据 inputsdata_linesfailed_pages 计算成功率
  • 查找作业 ID,然后通过作业数据获取每个作业的元数据
  • 通过关注 failed_pages 发现需要处理的爬虫

错误

相关

授权

Authorization
string
header
必填

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

查询参数

from_date
string<date>
必填

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

示例:

"2026-06-01"

to_date
string<date>
必填

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

示例:

"2026-07-13"

collector
string

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

示例:

"c_example1234567890"

offset
integer
默认值:0

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

limit
integer
默认值:50

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

必填范围: 0 <= x <= 500
sort_asc
enum<integer>
默认值:-1

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

可用选项:
1,
-1

响应

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.