Overview
Unlocker
SERP
Scraper
Marketplace Dataset API
Account Management API
- POSTAdd a Zone
- POSTAllow/Deny Domains
- POSTDenylist IP(s)
- POSTAllowlist IP(s)
- POSTAdd Static IP(s)
- POSTMigrate Static IPs
- POSTRefresh dedicated residential IPs
- POSTRefresh Static IPs (Datacenter/ISP)
- PUTChange Account Status
- GETAccount status
- GETActive Zones
- GETAvailable IPs/Zone
- GETAvailable Datacenter & ISP IPs count
- GETGet Countries
- GETGet Country Cities
- GETGet current service status
- GETList all available country's cities (static network)
- GETRecent IPs attempting to use your Zone
- GETAvailable Datacenter & ISP IPs/Zone
- GETBandwidth stats for a zone
- GETBandwidth stats for all your zones
- GETTotal cost & bandwidth for a zone
- GETList of denylisted IPs for a zone
- GETList of allowlisted IPs for a zone
- GETLive status of Static Zone
- GETTotal Balance
- GETZone info
- GETZone Password
- GETZone Permission
- GETZone Statistics
- GETZone status
- GETGet Proxies Pending Replacement
- DELRemove dedicated residential IPs
- DELRemove domain from Zone allowlist/denylist
- DELRemove IP from Zone denylist
- DELRemove IP from Zone allowlist
- DELRemove Static IPs (Datacenter/ISP)
- DELRemove a Zone
- POSTSwitch Automatic Failover
- POSTTurn on/off Zone
API Reference
- Proxy
- Proxy Manager
- Web Scraper IDE API
- Web Scraper API
- Scraping Shield
Native Access
- Proxy
- Unlocker & SERP API
Management APIs
Snapshot Data
Retrieve the logs for a specific dataset snapshot
GET
/
datasets
/
v3
/
log
{snapshot_id}
Copy
curl --request GET \
--url https://api.brightdata.com/datasets/v3/log{snapshot_id} \
--header 'Authorization: Bearer <token>'
Copy
{
"id": "s_mcd3rc6l2md984eoij",
"created": "2025-06-26T08:09:32.781Z",
"Status": "ready",
"dataset_name": "Apple App Store",
"scraper_name": "Apple App Store - collect by URL",
"Dataset_size": 2,
"Inputs_count": 2,
"Dataset_id": "gd_lsk9ki3u2iishmwrui",
"Discovery_collector_id": null,
"file_size": 65381,
"trigger": {
"type": "CP",
"user": "amite@brightdata.com",
"ip": "130.41.220.17",
"trigger_url": "/trigger?customer=hl_dacd97fb&type=url_collection&dataset_id=gd_lsk9ki3u2iishmwrui&include_errors=true&discover_only=false",
"ts": "2025-06-26T08:09:32.074Z"
},
"Duration": 6,
"Duration_per_input": 3,
"Success_rate": 1
}
Authorizations
Use your Bright Data API Key as a Bearer token in the Authorization header.
Get API Key from: https://brightdata.com/cp/setting/users.
Example:
Authorization: Bearer b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df
Path Parameters
Example:
"s_mcd3rc6l2md984eoij"
Response
200
application/json
OK
The response is of type object
.
Was this page helpful?
Copy
curl --request GET \
--url https://api.brightdata.com/datasets/v3/log{snapshot_id} \
--header 'Authorization: Bearer <token>'
Copy
{
"id": "s_mcd3rc6l2md984eoij",
"created": "2025-06-26T08:09:32.781Z",
"Status": "ready",
"dataset_name": "Apple App Store",
"scraper_name": "Apple App Store - collect by URL",
"Dataset_size": 2,
"Inputs_count": 2,
"Dataset_id": "gd_lsk9ki3u2iishmwrui",
"Discovery_collector_id": null,
"file_size": 65381,
"trigger": {
"type": "CP",
"user": "amite@brightdata.com",
"ip": "130.41.220.17",
"trigger_url": "/trigger?customer=hl_dacd97fb&type=url_collection&dataset_id=gd_lsk9ki3u2iishmwrui&include_errors=true&discover_only=false",
"ts": "2025-06-26T08:09:32.074Z"
},
"Duration": 6,
"Duration_per_input": 3,
"Success_rate": 1
}
Assistant
Responses are generated using AI and may contain mistakes.