Skip to main content
GET
/
webarchive
/
dumps
Get all data snapshot statuses
curl --request GET \
  --url https://api.brightdata.com/webarchive/dumps \
  --header 'Authorization: Bearer <token>'
[
  {
    "dump_id": "<string>",
    "id": "<string>",
    "status": "in_progress",
    "created": "2023-11-07T05:31:56Z",
    "search_id": "<string>",
    "readiness": "<string>",
    "batches_total": 123,
    "batches_uploaded": 123,
    "files_total": 123,
    "files_uploaded": 123,
    "filters": {}
  }
]

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:

Authorization: Bearer b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df

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

Response

List of data snapshot statuses

​
dump_id
string
required

Unique identifier for the dump

​
id
string
required

Same as dump_id (included for compatibility)

​
status
enum<string>
required
Available options:
in_progress
​
created
string<date-time>
required

Timestamp when the dump was created

​
search_id
string
required

ID of the search this dump is based on

​
readiness
string
required

Percentage of completion (e.g., "22.31%")

​
batches_total
integer
required
​
batches_uploaded
integer
required
​
files_total
integer
required
​
files_uploaded
integer
required
​
filters
object

Filters used to create the dump (present in list endpoint)