Sign in

v1

latestOpenAPI 3.0.12026-07-1344998.2 KB

Export account cost data broken down by dimension (products, zones, datasets, Web Scraper APIs, and more) as JSON. This is the same data source the Control Panel's Cost Explorer uses.

Note: the to parameter is exclusive. The day specified is not included in the result. To match a calendar month shown in the Control Panel or on your invoice, set to to the first day of the following month (e.g., from=2026-04-01 and to=2026-05-01 returns all of April 2026).

post/costs/export/json

Request body

dimension'products' | 'types' | 'zones' | 'datasets' | 'web_apis' | 'collectors' | 'domains' | 'ws_api_snaps' | 'snapshots' required

The dimension to group costs by. Same dimension semantics as the Control Panel Cost Explorer.

filtersobject

Optional filter object. Uses Bright Data's internal charges-structure notation and requires knowledge of that structure to construct. Contact Bright Data support if you need help building a filter.

Example: { "props": { "product": { "whitelist": ["dc", "unblocker"] } } }

fromstring date required

Inclusive start date in YYYY-MM-DD format. UTC.

tostring date required

Exclusive end date in YYYY-MM-DD format. UTC. The day specified is NOT included in the result. To match a calendar month, set to to the first day of the following month (e.g., from=2026-04-01&to=2026-05-01 returns all of April 2026).

Response

Cost breakdown grouped by day, then by resource ID. The resource ID format depends on the requested dimension (e.g., for dimension=web_apis, resource IDs are dataset IDs like gd_l1viktl72bvl7bjuj0). Amounts are billed USD for the day.

object required

Example response

{
  "2026-04-01": {
    "gd_l1viktl72bvl7bjuj0": 45.2,
    "gd_l1vikfnt1wgvvqz95w": 12.8
  },
  "2026-04-02": {
    "gd_l1viktl72bvl7bjuj0": 38.1
  }
}