列出 Scraper Studio 作业
使用 GET /dca/collector/jobs 获取账户中的 Scraper Studio 作业。可按爬虫 ID 和日期范围过滤,并使用 offset 和 limit 分页。
GET /dca/collector/jobs 获取您账户中的 Bright Data Scraper Studio 作业。可按爬虫 ID 和日期范围过滤列表,并使用 offset 和 limit 控制分页。
from_date 和 to_date 为必填项。使用较窄的日期范围可获得更快的响应并更便于分页。
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发现需要处理的爬虫
错误
相关
授权
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
查询参数
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