Skip to main content
GET
cURL
此端点显示在最长 31 天的时间范围内,账户使用某个 Scraper API 采集器采集的快照中,每个输出字段有值的比例。
如需在购买前查看 Marketplace 数据集的填充率,请参阅 数据集市场填充率。

授权

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?

路径参数

dataset_id
string
必填

采集器的数据集 ID,例如 gd_l7q7dkf244hwjntr0(Amazon 商品)。可通过获取所有采集器查找数据集 ID。

示例:

"gd_l7q7dkf244hwjntr0"

查询参数

from_date
string<date-time>
必填

时间范围的开始,ISO 8601 格式。不带时间的日期(2026-11-01)按 UTC 零点处理。

示例:

"2026-11-01T00:00:00.000Z"

to_date
string<date-time>
必填

时间范围的结束,ISO 8601 格式。必须不早于 from_date,且与其相差不超过 31 天。

示例:

"2026-11-16T00:00:00.000Z"

响应

所请求采集器和时间范围的填充率

dataset_id
string

采集器的数据集 ID。

from_date
string<date-time>

所请求时间范围的开始,规范化为带毫秒的 ISO 8601 格式。

to_date
string<date-time>

所请求时间范围的结束,规范化为带毫秒的 ISO 8601 格式。

snapshots_count
integer

账户在该时间范围内使用此采集器采集的快照数量。

included_snapshots_count
integer

参与填充率计算的快照数量。当部分快照没有填充率统计时会低于 snapshots_count:包括未采集到任何成功记录的快照,以及未记录字段统计的较早快照。对这些快照调用获取快照填充率会返回 HTTP 409。

fields
object[]

每个输出字段一项。没有快照参与计算时为空。