Skip to main content
GET
Get search status
当成功时,它将检索:
  • 您查询的条目数量
  • 完整数据快照的估计大小和成本
定价和大小: estimate_batch_size 以字节为单位。dump_cost_usd 是基于 files_count 和您当前缓存/存档定价层的估计总成本。cost_breakdown 对象显示缓存和存档页面的单独成本。

授权

Authorization
string
header
必填

Use your Bright Data API Key as a Bearer token in the Authorization header.

How to authenticate:

  1. Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
  2. Include the API Key in the Authorization header of your requests
  3. Format: Authorization: Bearer YOUR_API_KEY

Example:

Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication

路径参数

search_id
string
必填

Unique identifier for the search

示例:

"ucd_abc123xyz"

响应

Search status response

search_id
string

Unique identifier for the search

status
enum<string>

Current status: in_progress, done, or failed

可用选项:
done
filters
object

The filters used for this search (echoed back)

files_count
integer

Total number of matching files found

estimate_batch_count
integer

Estimated number of batches for the dump

estimate_batch_size
integer

Estimated total size in bytes

dump_cost_usd
number<float>

Estimated total cost to create a dump

cost_breakdown
object

Breakdown of costs between cache and archive pages

estimate_dump_duration_sec
integer

Estimated time to complete the dump in seconds

duration
string

How long the search took to complete

error
string

Error message (only present when status is failed)