cURL
Marketplace Dataset API
筛选数据集 (BETA)
对 250+ 个 Bright Data 市场数据集运行异步筛选任务。返回可下载的 snapshot_id,支持最大 200 MiB 的 CSV/JSON 上传。
POST
cURL
Bright Data 市场数据集 API 的 Filter 端点针对 250+ 个市场数据集中的任意一个运行大体量或基于文件的筛选任务,并返回一个
从账户设置获取您的 Key。
Filter 返回一个
要排除 10 万以上的值,将它们拆分为每个最多 10,000 行的文件,并在一次请求中全部附加:
有关 CSV 和 JSON 文件格式规则、文件引用以及上传故障排除,请参阅使用 CSV/JSON 文件筛选数据集。
snapshot_id,您可在任务完成后下载。
何时使用 Filter?
对于可接受异步处理的批量或基于文件的任务,使用 Filter:- 超过 1,000 条记录的批量导出。
- 按 CSV 或 JSON 文件中的大型值列表筛选,例如排除 10 万以上的公司 ID。
- Search 尚不支持的数据集。
- 可接受异步的计划任务或后台管道。
Filter 如何工作?
- 调用 Filter 端点会启动一个异步任务,并在您的账户中创建一份筛选数据的快照。
- 任务最长运行时间为 5 分钟。运行超时的任务将被取消。
- 按快照中的每条记录计费,采用标准市场费率 $2.5 CPM。
- Filter 适用于全部 250+ 个市场数据集。
- 筛选组的最大嵌套深度为 3 层。
如何进行身份验证?
Filter 使用 Bearer token 身份验证。在Authorization 请求头中传入您的 API Key:
限制
如何调用 Filter?
Filter 有两种模式:JSON 用于普通筛选,multipart 用于文件上传。JSON 模式(无需上传文件)
将所有参数(dataset_id、records_limit 和 filter)放在 JSON 请求体中。将 Content-Type 设为 application/json:
snapshot_id:
Multipart 模式(文件上传)
将dataset_id 和 records_limit 作为查询参数发送,将 filter 和上传的文件放在 form-data 请求体中。将 Content-Type 设为 multipart/form-data:
Filter 返回什么?
Filter 返回一个snapshot_id。在任务完成后,使用它通过快照 API 下载筛选后的记录:
Filter 的费用是多少?
Filter 的费用为 $2.5 CPM(每返回 1,000 条记录),与市场价格相同。筛选返回 0 条记录时不收费。Filter 可能返回哪些错误?
筛选语法
filter 对象及其运算符、筛选组和嵌套规则与 Search 端点共享,并集中记录在一处。完整的运算符列表、筛选组、最多 3 层嵌套以及 CSV/JSON 文件引用,请参阅筛选语法参考。
相关文档
授权
在 Authorization 头中使用您的 Bright Data API Key 作为 Bearer token。
认证方法:
- 从 Bright Data 账户设置获取您的 API Key: https://brightdata.com/cp/setting/users
- 在请求的 Authorization 头中包含 API Key
- 格式:
Authorization: Bearer YOUR_API_KEY
示例:
了解如何获取 Bright Data API Key: https://docs.brightdata.com/cn/api-reference/authentication#如何生成新的-api-key?
查询参数
要过滤的数据集 ID(在 multipart/form-data 模式下为必填)
示例:
"gd_l1viktl72bvl7bjuj0"
限制快照中包含的记录数量
示例:
1000
请求体
响应
快照创建任务已成功启动
快照 ID