Delete a Scraper Studio scraper
Manage scrapers & jobs
Delete a Scraper Studio scraper
DELETE /dca/collector/ removes a Scraper Studio scraper from your Bright Data account, taking it out of My Scrapers and preventing future runs.
DELETE
Delete a Scraper Studio scraper
Use
Use the returned
Omit
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.
How to find a scraper ID
Use the scrapers list endpoint to find the ID of the scraper you want to delete: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 optionalreason query parameter to record why the scraper was deleted, for tracking or audit purposes:
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
Related
- List Scraper Studio scrapers: find the
scraper_idbefore deleting - List Scraper Studio jobs: review the jobs a scraper has run
- Cancel a Scraper Studio job: stop a single job without deleting the scraper
Authorizations
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:
Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication
Path Parameters
ID of the Scraper Studio scraper to delete. In API parameters, this ID may also be referred to as collector_id.
Query Parameters
Reason for deleting the scraper. Used for tracking or audit purposes.
Response
Scraper deleted successfully
The response is of type string.