Skip to main content
GET
cURL

Snapshot retention

Snapshot parts are available only while the snapshot is within the retention period. Dataset snapshots are available for 14 days after they are generated. After this period, the snapshot expires and its parts can no longer be retrieved. To access the data again, create a new snapshot for the same dataset.

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

id
string
required

A Snapshot ID is a unique identifier for a specific data snapshot, used to retrieve results from a data collection job triggered via the API. Read more about Snapshot ID.

Example:

"s_m4x7enmven8djfqak"

Query Parameters

format
enum<string>
default:json

Format of the response

Available options:
json,
ndjson,
jsonl,
csv
compress
boolean
default:false

Whether or not the response will be compressed in gzip format

batch_size
integer

Number of records that will be included in each response batch

Required range: x >= 1000

Response

OK

parts
number