Skip to main content
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.

​
Request

Send a GET request to /dca/collectors_list. Include your Bright Data API token in the Authorization header as a Bearer token. 
curl "https://api.brightdata.com/dca/collectors_list" \
  -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"

response = requests.get(
    "https://api.brightdata.com/dca/collectors_list",
    headers={"Authorization": f"Bearer {API_TOKEN}"},
)
scrapers = response.json()

const response = await fetch(
  "https://api.brightdata.com/dca/collectors_list",
  { headers: { Authorization: `Bearer ${process.env.BRIGHT_DATA_API_TOKEN}` } }
);
const scrapers = await response.json();

​
Search scrapers

Use the search query parameter to return only scrapers whose name matches a search term. 
curl "https://api.brightdata.com/dca/collectors_list?search=amazon" \
  -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"

response = requests.get(
    "https://api.brightdata.com/dca/collectors_list",
    headers={"Authorization": f"Bearer {API_TOKEN}"},
    params={"search": "amazon"},
)
scrapers = response.json()

const response = await fetch(
  "https://api.brightdata.com/dca/collectors_list?search=amazon",
  { headers: { Authorization: `Bearer ${process.env.BRIGHT_DATA_API_TOKEN}` } }
);
const scrapers = await response.json();

​
Query parameters

NameTypeRequiredDescription
searchstringNoFilters the scraper list by the provided search term.

​
Response

The endpoint returns a paginated list of scrapers. 
{
  "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
          }
        }
      }
    }
  ]
}

​
Response fields

FieldTypeDescription
totalnumberTotal number of scrapers matching the request.
offsetnumberZero-based index of the first scraper returned.
limitnumberMaximum number of scrapers returned in the response.
dataarrayList of scraper objects.

​
Scraper object

FieldTypeDescription
idstringScraper ID. Use this value as the collector parameter when triggering a scraper.
namestringScraper name shown in Scraper Studio.
activebooleanIndicates whether the scraper is active and available for production runs.
last_runstringTimestamp of the latest run, in ISO 8601 format. This field appears when the scraper has run before.
deliverobjectDelivery configuration for the scraper.
deliver.typestringDelivery type, such as api_pull.
output_schemaobject or nullOutput schema configured for the scraper. Can be null if no output schema is available.

​
Output schema object

When available, output_schema describes the structure of records returned by the scraper.
FieldTypeDescription
output_schema.typestringSchema root type. Usually object.
output_schema.fieldsobjectField definitions returned by the scraper.
fields.<field_name>.typestringField type, such as text, number, price, url, array, input, error or warning.
fields.<field_name>.activebooleanIndicates whether the field is active in the scraper output.
fields.<field_name>.itemsobjectItem definition for array fields.

​
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

StatusCauseFix
401 UnauthorizedToken missing, malformed or revokedRe-copy from Account Settings → API Tokens
5xxTransient Bright Data API errorRetry with exponential backoff, for example 1s, 2s, 4s