Skip to main content
POST
cURL
此端点用于按您选定的维度(products、zones、datasets、Web Scraper API、collectors、domains、dataset snapshots 或 WSA snapshots),以 JSON 或 CSV 格式导出每天每资源的费用明细,数据与控制面板 Cost Explorer 完全一致。
to 参数不包含结束日期。 指定的日期不会包含在结果中。要匹配控制面板或发票中显示的某个完整自然月,请将 to 设置为下一个月的第一天。例如,from=2026-04-01&to=2026-05-01 将返回 2026 年 4 月的全部数据。
将您的 API key 粘贴到授权字段中。要获取 API key,请创建账号,并查看如何生成新的 API key?

何时使用此端点

当 GET /zone/cost 无法满足需要时,请使用此端点。/zone/cost 端点仅作用于单个 zone,因此无法拆分 Web Scraper API 的费用(这些费用以 dataset_id 为键,而非 zone 名称),也无法回答诸如”我上月在数据中心代理和 Unlocker 上一共花了多少?“这类跨产品问题。 此端点通过 dimension 参数按 Cost Explorer 中相同的分组进行费用聚合。 各维度与控制面板 Cost Explorer 中看到的分组一致;了解每个维度返回什么的最简单方式,就是在控制面板中打开 Cost Explorer 并切换分组。

按某个维度复现您的月度发票

要获取 2026 年 4 月按 Web Scraper API dataset 拆分的完整月度费用:
响应结构(按天一条记录,每天再按资源 ID 对应计费美元金额):
如需以 CSV 获取相同数据,请以相同的请求体调用 POST /costs/export/csv。CSV 会将响应转置为每天一行,每个出现在该日期范围内的资源 ID 对应一列,因此列数会随数据而变化:

使用 filters 字段

filters 对象使用 Bright Data 内部的计费结构语法,与 Cost Explorer 所用语法相同。从零构造过滤条件需要了解该结构。大多数调用方将 filters 留空({}),仅依靠 dimension 参数对响应进行约束。 下面是一个可用示例,将结果限制为 datacenter 与 Web Unlocker 产品:
如果需要的过滤条件无法仅靠维度表达,请联系 Bright Data 技术支持,说明您要解答的问题。我们目前未公开完整的过滤语法;技术支持可帮您构建所需过滤条件,或确认无需过滤。

速率限制

  • 每分钟 1,000 个请求
  • 每小时 5,000 个请求
此端点接受任何具有费用数据访问权限的 API key,不需要单独的计费管理员权限。

与原始请求日志对账

此端点返回的值是计费的真实数据来源,与控制面板的 Cost Explorer 与”使用情况概览”匹配,并汇总进入您的发票。如果将这些值与您自行采集的原始请求日志(例如转发到 Logz 或 CloudWatch 的访问日志)进行比较,预计会有几个百分点的差异。原始日志可能记录到一些请求,但这些请求由于异步聚合时延或临时网络问题未被提交到计费数据库。您的发票始终反映此端点返回的值。

相关端点

授权

Authorization
string
header
必填

在 Authorization 头中使用您的 Bright Data API Key 作为 Bearer token。

认证方法:

  1. 从 Bright Data 账户设置获取您的 API Key: https://brightdata.com/cp/setting/users
  2. 在请求的 Authorization 头中包含 API Key
  3. 格式: Authorization: Bearer YOUR_API_KEY

示例:

了解如何获取 Bright Data API Key: https://docs.brightdata.com/cn/api-reference/authentication#如何生成新的-api-key?

请求体

application/json
dimension
enum<string>
必填

用于分组费用的维度。维度含义与控制面板 Cost Explorer 相同。

可用选项:
products,
types,
zones,
datasets,
web_apis,
collectors,
domains,
ws_api_snaps,
snapshots
from
string<date>
必填

开始日期(包含),格式为 YYYY-MM-DD,UTC 时间。

to
string<date>
必填

结束日期(不包含),格式为 YYYY-MM-DD,UTC 时间。指定的当天不计入结果。要与自然月保持一致,请将 to 设置为下个月的第一天(例如 from=2026-04-01&to=2026-05-01 返回 2026 年 4 月的全部数据)。

filters
object

可选的筛选对象。使用 Bright Data 内部的计费结构表示法,构造时需要了解该结构。如需帮助构建筛选条件,请联系 Bright Data 支持团队。

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

响应

200 - application/json

按天分组、再按资源 ID 分组的费用明细。资源 ID 的格式取决于请求的维度(例如 dimension=web_apis 时,资源 ID 为 gd_l1viktl72bvl7bjuj0 这样的数据集 ID)。金额为当天计费的美元金额。

{key}
object