> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Scraper Studio scrapers

> GET /dca/collectors_list returns the Scraper Studio scrapers in your account, with each scraper's ID, name, active status, delivery config and output schema.

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](./Trigger_a_scraper_for_batch_collection_method).

## Request

Send a `GET` request to `/dca/collectors_list`. Include your Bright Data API token in the `Authorization` header as a Bearer token.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/dca/collectors_list" \
    -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"
  ```

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

  ```js Node.js theme={null}
  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();
  ```
</CodeGroup>

### Search scrapers

Use the `search` query parameter to return only scrapers whose name matches a search term.

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.brightdata.com/dca/collectors_list?search=amazon" \
    -H "Authorization: Bearer $BRIGHT_DATA_API_TOKEN"
  ```

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

  ```js Node.js theme={null}
  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();
  ```
</CodeGroup>

### Query parameters

| Name     | Type   | Required | Description                                           |
| -------- | ------ | -------- | ----------------------------------------------------- |
| `search` | string | No       | Filters the scraper list by the provided search term. |

## Response

The endpoint returns a paginated list of scrapers.

```json theme={null}
{
  "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

| Field    | Type   | Description                                          |
| -------- | ------ | ---------------------------------------------------- |
| `total`  | number | Total number of scrapers matching the request.       |
| `offset` | number | Zero-based index of the first scraper returned.      |
| `limit`  | number | Maximum number of scrapers returned in the response. |
| `data`   | array  | List of scraper objects.                             |

### Scraper object

| Field           | Type           | Description                                                                                          |
| --------------- | -------------- | ---------------------------------------------------------------------------------------------------- |
| `id`            | string         | Scraper ID. Use this value as the `collector` parameter when triggering a scraper.                   |
| `name`          | string         | Scraper name shown in Scraper Studio.                                                                |
| `active`        | boolean        | Indicates whether the scraper is active and available for production runs.                           |
| `last_run`      | string         | Timestamp of the latest run, in ISO 8601 format. This field appears when the scraper has run before. |
| `deliver`       | object         | Delivery configuration for the scraper.                                                              |
| `deliver.type`  | string         | Delivery type, such as `api_pull`.                                                                   |
| `output_schema` | object or null | Output 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.

| Field                        | Type    | Description                                                                                   |
| ---------------------------- | ------- | --------------------------------------------------------------------------------------------- |
| `output_schema.type`         | string  | Schema root type. Usually `object`.                                                           |
| `output_schema.fields`       | object  | Field definitions returned by the scraper.                                                    |
| `fields.<field_name>.type`   | string  | Field type, such as `text`, `number`, `price`, `url`, `array`, `input`, `error` or `warning`. |
| `fields.<field_name>.active` | boolean | Indicates whether the field is active in the scraper output.                                  |
| `fields.<field_name>.items`  | object  | Item 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

| Status             | Cause                               | Fix                                                                             |
| ------------------ | ----------------------------------- | ------------------------------------------------------------------------------- |
| `401 Unauthorized` | Token missing, malformed or revoked | Re-copy from [Account Settings → API Tokens](https://brightdata.com/cp/setting) |
| `5xx`              | Transient Bright Data API error     | Retry with exponential backoff, for example 1s, 2s, 4s                          |

## Related

* [Trigger async batch collection](./Trigger_a_scraper_for_batch_collection_method): pass the scraper `id` as the `collector` parameter
* [Job data](./job-data): job-level metadata for a triggered scraper
* [Receive batch data](./Receive_batch_data): download the records a scraper produced