Skip to main content
DELETE
Delete a Scraper Studio scraper
Use DELETE /dca/collector/{scraper_id} to delete a Bright Data Scraper Studio scraper from your account. Deleting a scraper removes it from My Scrapers and prevents new manual, scheduled or API-triggered runs. This endpoint takes no request body and returns the plain text body OK on success, not JSON. Read the response as text rather than calling a JSON parser on it.
Deleting a scraper cannot be undone. Use this endpoint only when the scraper is no longer needed.

How to find a scraper ID

Use the scrapers list endpoint to find the ID of the scraper you want to delete:
Use the returned id value as the scraper_id path parameter. In API parameters, this ID may also be referred to as collector_id. See List Scraper Studio scrapers for the full parameter list.

Record a deletion reason

Pass the optional reason query parameter to record why the scraper was deleted, for tracking or audit purposes:
Omit reason to delete the scraper without recording one.

When to use this endpoint

  • Remove a scraper you no longer run, so it stops appearing in My Scrapers
  • Clean up test or duplicate scrapers created while developing in Scraper Studio
  • Decommission a scraper after migrating its workload to another scraper

Authorizations

Authorization
string
header
required

Use your Bright Data API Key as a Bearer token in the Authorization header.

How to authenticate:

  1. Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
  2. Include the API Key in the Authorization header of your requests
  3. Format: Authorization: Bearer YOUR_API_KEY

Example:

Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication

Path Parameters

scraper_id
string
required

ID of the Scraper Studio scraper to delete. In API parameters, this ID may also be referred to as collector_id.

Query Parameters

reason
string

Reason for deleting the scraper. Used for tracking or audit purposes.

Response

Scraper deleted successfully

The response is of type string.