List Scraper Studio scrapers
curl --request GET \
--url https://api.brightdata.com/dca/collectors_list \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.brightdata.com/dca/collectors_list"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.brightdata.com/dca/collectors_list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.brightdata.com/dca/collectors_list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.brightdata.com/dca/collectors_list"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.brightdata.com/dca/collectors_list")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.brightdata.com/dca/collectors_list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"total": 5,
"offset": 0,
"limit": 50,
"data": [
{
"id": "c_example1234567890",
"name": "example.com",
"active": false,
"deliver": {
"type": "api_pull"
},
"output_schema": null
},
{
"id": "c_example0987654321",
"name": "example.com",
"active": true,
"last_run": "2026-06-22T11:41:56.660Z",
"deliver": {
"type": "api_pull"
},
"output_schema": {
"type": "object",
"fields": {
"product_title": {
"type": "text",
"active": true
},
"brand": {
"type": "text",
"active": true
},
"rating": {
"type": "number",
"active": true
},
"image_urls": {
"type": "array",
"active": true,
"items": {
"type": "url"
}
},
"input": {
"type": "input",
"active": true
},
"warning": {
"type": "warning",
"active": true
},
"error": {
"type": "error",
"active": true
}
}
}
}
]
}爬虫与作业管理
列出 Scraper Studio 爬虫
使用 GET /dca/collectors_list 获取账户中的 Scraper Studio 爬虫,包含每个爬虫的 ID、名称、活动状态、投递配置和输出模式。
GET
/
dca
/
collectors_list
List Scraper Studio scrapers
curl --request GET \
--url https://api.brightdata.com/dca/collectors_list \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.brightdata.com/dca/collectors_list"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.brightdata.com/dca/collectors_list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.brightdata.com/dca/collectors_list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.brightdata.com/dca/collectors_list"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.brightdata.com/dca/collectors_list")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.brightdata.com/dca/collectors_list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"total": 5,
"offset": 0,
"limit": 50,
"data": [
{
"id": "c_example1234567890",
"name": "example.com",
"active": false,
"deliver": {
"type": "api_pull"
},
"output_schema": null
},
{
"id": "c_example0987654321",
"name": "example.com",
"active": true,
"last_run": "2026-06-22T11:41:56.660Z",
"deliver": {
"type": "api_pull"
},
"output_schema": {
"type": "object",
"fields": {
"product_title": {
"type": "text",
"active": true
},
"brand": {
"type": "text",
"active": true
},
"rating": {
"type": "number",
"active": true
},
"image_urls": {
"type": "array",
"active": true,
"items": {
"type": "url"
}
},
"input": {
"type": "input",
"active": true
},
"warning": {
"type": "warning",
"active": true
},
"error": {
"type": "error",
"active": true
}
}
}
}
]
}使用
GET /dca/collectors_list 获取您账户中可用的 Bright Data Scraper Studio 爬虫。响应包含爬虫 ID、名称、活动状态、投递配置、最近运行时间,以及可用时的输出模式。
使用该端点发现账户中的爬虫
id 值,然后在触发爬虫时将某个 id 作为 collector 参数传入。搜索爬虫
使用search 查询参数,仅返回名称与搜索词匹配的爬虫,例如 ?search=amazon。省略 search 则返回账户中的所有爬虫。
何时使用该端点
- 在触发批量或实时作业前查找爬虫的
id - 构建一个列出账户中所有爬虫的选择器
- 审计哪些爬虫处于
active状态以及哪些已运行过(last_run) - 读取
output_schema,在解析记录前映射返回的字段
错误
| 状态 | 原因 | 修复方法 |
|---|---|---|
401 Unauthorized | 令牌缺失、格式错误或已吊销 | 从账户设置 → API 令牌重新复制 |
5xx | Bright Data API 临时错误 | 使用指数退避重试,例如 1s、2s、4s |
相关
授权
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:
Authorization: Bearer b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df
Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication
查询参数
Filters the scraper list by the provided search term.
示例:
"amazon"
响应
200 - application/json
A paginated list of Scraper Studio scrapers.
此页面对您有帮助吗?