List Scraper Studio scrapers

curl --request GET \
  --url https://api.brightdata.com/dca/collectors_list \
  --header 'Authorization: Bearer <token>'

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))

}

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

List Scraper Studio scrapers

curl --request GET \
  --url https://api.brightdata.com/dca/collectors_list \
  --header 'Authorization: Bearer <token>'

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))

}

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
          }
        }
      }
    }
  ]
}

Use GET /dca/collectors_list to retrieve the Bright Data Scraper Studio scrapers available in your account. The response includes scraper IDs, names, active status, delivery configuration, last run time and the output schema when available.

Use this endpoint to discover the scraper id values in your account, then pass an id as the collector parameter when you trigger a scraper.

Search scrapers

Use the search query parameter to return only scrapers whose name matches a search term, for example ?search=amazon. Omit search to return every scraper in the account.

When to use this endpoint

Look up the id of a scraper before triggering a batch or real-time job
Build a picker that lists every scraper in your account
Audit which scrapers are active and which have run before (last_run)
Read the output_schema to map returned fields before parsing records

Errors

Status	Cause	Fix
`401 Unauthorized`	Token missing, malformed or revoked	Re-copy from Account Settings → API Tokens
`5xx`	Transient Bright Data API error	Retry with exponential backoff, for example 1s, 2s, 4s

List Jobs: list the jobs a scraper has run
Trigger async batch collection: pass the scraper id as the collector parameter
Job data: job-level metadata for a triggered scraper
Receive batch data: download the records a scraper produced

Authorizations

Authorization

string

header

required

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

Query Parameters

string

Filters the scraper list by the provided search term.

Example:

"amazon"

Response

200 - application/json

A paginated list of Scraper Studio scrapers.

total

integer

Total number of scrapers matching the request.

offset

integer

Zero-based index of the first scraper returned.

limit

integer

Maximum number of scrapers returned in the response.

data

object[]

List of scraper objects.

Show child attributes

Essentials

Data extraction

AI training data

Proxy

Administrative APIs

List Scraper Studio scrapers

Search scrapers

When to use this endpoint

Errors

Authorizations

Query Parameters

Response

​Search scrapers

​When to use this endpoint

​Errors

​Related

Authorizations

Query Parameters

Response

Search scrapers

When to use this endpoint

Errors

Related