跳转到主要内容
POST
cURL
Bright Data 市场数据集 API 的 Filter 端点针对 250+ 个市场数据集中的任意一个运行大体量或基于文件的筛选任务,并返回一个 snapshot_id,您可在任务完成后下载。
将您的 API Key 粘贴到授权字段。要获取 API Key,请创建账户并了解如何生成 API Key

何时使用 Filter?

对于可接受异步处理的批量或基于文件的任务,使用 Filter:
  • 超过 1,000 条记录的批量导出。
  • 按 CSV 或 JSON 文件中的大型值列表筛选,例如排除 10 万以上的公司 ID。
  • Search 尚不支持的数据集。
  • 可接受异步的计划任务或后台管道。
如需对受支持数据集进行亚秒级实时查询,请改用 Search

Filter 如何工作?

  • 调用 Filter 端点会启动一个异步任务,并在您的账户中创建一份筛选数据的快照。
  • 任务最长运行时间为 5 分钟。运行超时的任务将被取消。
  • 按快照中的每条记录计费,采用标准市场费率 $2.5 CPM。
  • Filter 适用于全部 250+ 个市场数据集。
  • 筛选组的最大嵌套深度为 3 层。

如何进行身份验证?

Filter 使用 Bearer token 身份验证。在 Authorization 请求头中传入您的 API Key:
账户设置获取您的 Key。

限制

如何调用 Filter?

Filter 有两种模式:JSON 用于普通筛选,multipart 用于文件上传。

JSON 模式(无需上传文件)

将所有参数(dataset_idrecords_limitfilter)放在 JSON 请求体中。将 Content-Type 设为 application/json
Filter 返回一个 snapshot_id

Multipart 模式(文件上传)

dataset_idrecords_limit 作为查询参数发送,将 filter 和上传的文件放在 form-data 请求体中。将 Content-Type 设为 multipart/form-data
要排除 10 万以上的值,将它们拆分为每个最多 10,000 行的文件,并在一次请求中全部附加:
有关 CSV 和 JSON 文件格式规则、文件引用以及上传故障排除,请参阅使用 CSV/JSON 文件筛选数据集

Filter 返回什么?

Filter 返回一个 snapshot_id。在任务完成后,使用它通过快照 API 下载筛选后的记录:

Filter 的费用是多少?

Filter 的费用为 $2.5 CPM(每返回 1,000 条记录),与市场价格相同。筛选返回 0 条记录时不收费。

Filter 可能返回哪些错误?

筛选语法

filter 对象及其运算符、筛选组和嵌套规则与 Search 端点共享,并集中记录在一处。完整的运算符列表、筛选组、最多 3 层嵌套以及 CSV/JSON 文件引用,请参阅筛选语法参考

相关文档

授权

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(在 multipart/form-data 模式下为必填)

示例:

"gd_l1viktl72bvl7bjuj0"

records_limit
integer

限制快照中包含的记录数量

示例:

1000

请求体

dataset_id
string
必填

要过滤的数据集 ID

示例:

"gd_l1viktl72bvl7bjuj0"

filter
单字段过滤器 · object
必填
示例:
records_limit
integer

限制快照中包含的记录数量

示例:

1000

响应

快照创建任务已成功启动

snapshot_id
string

快照 ID