跳转到主要内容
Bright Data 市场数据集 API(Marketplace Dataset API)提供两个端点,用于从 250+ 个市场数据集中提取记录:Search 用于实时查询,Filter 用于批量异步任务。两个端点共享同一套筛选 schema、同一种身份验证方式以及相同的 $2.5 CPM 定价。
将您的 API Key 粘贴到授权字段。要获取 API Key,请创建账户并了解如何生成 API Key

Dataset API 有哪两个端点?

市场数据集 API 提供两种提取记录的方式,可根据任务选择:
  • Search(同步) 基于 Elasticsearch,以亚秒级响应内联返回记录。适用于实时查询、线索增强和抽样。
  • Filter(异步) 基于快照,支持 CSV/JSON 文件上传和大体量负载。适用于批量导出和值列表筛选。

Search 数据集(同步)

Elasticsearch 查询,内联返回结果,亚秒级延迟。每次调用最多 1,000 条记录。

Filter 数据集(异步)

基于快照的任务,支持 CSV/JSON 上传,负载最大 200 MiB。覆盖全部 250+ 个数据集。

我该使用哪个端点?

低延迟、单次调用的查询使用 Search;批量或基于文件的任务使用 Filter。

两个端点有何区别?

Search 和 Filter 端点接受相同的 filter 对象,但在引擎、延迟和数据集覆盖范围上有所不同。 两个引擎之间的结果可能存在差异。Elasticsearch 对文本的分词方式与快照引擎不同。

如何进行身份验证?

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

Dataset API 的费用是多少?

两个端点的费用均为 $2.5 CPM(每返回 1,000 条记录),与市场价格相同。实时 Search 不收取额外费用,筛选返回 0 条记录时也不收费。

筛选语法在哪里查看?

两个端点都接受相同的 filter 对象,运算符和嵌套规则一致。筛选语法参考记录了运算符列表、筛选组、最多 3 层嵌套以及 CSV/JSON 文件引用。

相关文档