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:
Dataset API 的费用是多少?
两个端点的费用均为 $2.5 CPM(每返回 1,000 条记录),与市场价格相同。实时 Search 不收取额外费用,筛选返回 0 条记录时也不收费。筛选语法在哪里查看?
两个端点都接受相同的filter 对象,运算符和嵌套规则一致。筛选语法参考记录了运算符列表、筛选组、最多 3 层嵌套以及 CSV/JSON 文件引用。
相关文档
- Search 数据集(同步)
- Filter 数据集(异步,文件上传)
- 筛选语法参考
- 获取数据集元数据
- 获取数据集列表
- 在查询前构建或刷新数据集,请参阅创建数据收集请求。