Skip to main content
GET
cURL
使用 GET /dca/dataset?id=<collection_id> 获取异步 Bright Data Scraper Studio 批量采集的结果。当采集仍在运行时,该端点返回一个状态对象。当采集就绪后,它会返回一个 JSON 记录数组。
请将 POST /dca/trigger 返回的 collection_id 用作本端点的 id 查询参数。
批量采集结果在采集后 16 天内可供下载。为了避免过期,请在 16 天内下载数据,或配置推送递送方式以将其自动发送到您的存储。

请求

响应

当采集仍在构建中时(HTTP 202):
当采集就绪后(HTTP 200):
具体的字段集取决于您在构建采集器时定义的输出模式。默认情况下,每个成功的输入对应一行。

获取结果

当采集仍在运行时,该端点返回 202 Accepted 以及一个状态对象。当采集就绪后,它返回 200 OK 以及一个 JSON 记录数组。 对于可能耗时数分钟或数小时的长时间采集,请避免频繁轮询。请改用以下方式之一:
  • 以较长的时间间隔定期检查采集状态。
  • 配置推送递送方式,例如 webhook、Amazon S3、Google Cloud Storage、Azure Blob Storage、SFTP/FTP 或电子邮件。
  • 使用控制面板监控运行进度。
批量采集结果保留 16 天。请在保留期内下载数据,或配置推送递送以自动存储结果。

错误

授权

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。

响应

数据集(已就绪)