Skip to main content
GET
列出 Scraper Studio 作业
使用 GET /dca/collector/jobs 获取您账户中的 Bright Data Scraper Studio 作业。可按爬虫 ID 和日期范围过滤列表,并使用 offset 和 limit 控制分页。 from_date 和 to_date 为必填项。使用较窄的日期范围可获得更快的响应并更便于分页。
将爬虫 ID 作为 collector 参数传入,仅返回该爬虫的作业。爬虫 ID 可从列出爬虫获取。

过滤、分页和排序

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

何时使用该端点

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

错误

相关

授权

Authorization
string
header
必填

在 Authorization 头中使用您的 Bright Data API Key 作为 Bearer token。

认证方法:

  1. 从 Bright Data 账户设置获取您的 API Key: https://brightdata.com/cp/setting/users
  2. 在请求的 Authorization 头中包含 API Key
  3. 格式: Authorization: Bearer YOUR_API_KEY

示例:

了解如何获取 Bright Data API Key: https://docs.brightdata.com/cn/api-reference/authentication#如何生成新的-api-key?

查询参数

from_date
string<date>
必填

作业列表的开始日期,格式为 YYYY-MM-DD。

示例:

"2026-06-01"

to_date
string<date>
必填

作业列表的结束日期,格式为 YYYY-MM-DD。

示例:

"2026-07-13"

collector
string

用于筛选特定爬虫作业的爬虫 ID。可通过列出爬虫端点获取 ID。

示例:

"c_example1234567890"

offset
integer
默认值:0

返回结果前要跳过的作业数量,用于分页。

limit
integer
默认值:50

返回的最大作业数量,必须在 0 到 500 之间。

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

排序方向。1 表示升序,-1 表示降序。

可用选项:
1,
-1

响应

200 - application/json

Scraper Studio 作业的分页列表。

total
integer

符合请求条件的作业总数。

offset
integer

返回的第一个作业的索引(从 0 开始)。

limit
integer

响应中返回的最大作业数量。

data
object[]

作业对象列表。