跳转到主要内容
POST
cURL
Bright Data 市场数据集 API 的 Filter 端点可以按存储在 CSV 或 JSON 文件中的成千上万个值对数据集进行筛选。以 multipart 模式上传一个或多个文件,并在筛选中引用每个文件名。
将您的 API Key 粘贴到授权字段。要获取 API Key,请创建账户并了解如何生成 API Key

基于文件的筛选如何工作?

当您需要按大型值列表筛选时使用文件上传,例如包含或排除 10 万以上的公司 ID:
  • multipart/form-data 模式上传 CSV 或 JSON 文件,并在筛选中引用每个文件名。
  • 每个文件最多包含 10,000 行数据,整个请求最大为 200 MiB。
  • Filter 任务以异步方式运行,并返回一个 snapshot_id,可在任务完成后下载。
有关异步任务流程、限制、定价和错误码,请参阅 Filter 数据集(异步)

如何格式化 CSV 或 JSON 文件?

  • 第一行必须是与筛选字段名称匹配的表头。
  • 后续每行包含单个值。
Example: industries.csv

如何在筛选中引用文件?

使用文件上传时,将筛选的 value 字段设为文件名:
Example
文件引用仅可与 innot_inincludesnot_includesarray_includesnot_array_includes 运算符配合使用。完整的运算符表和字段类型,请参阅筛选语法参考

使用多个文件进行筛选

排查文件上传问题

相关文档

授权

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

请求体

multipart/form-data
filter
单字段筛选器 · object
必填
示例:

响应

创建快照的任务已成功启动

snapshot_id
string

快照 ID