Skip to main content
GET
获取每个域名的成功率统计
Bright Data Web Unlocker API 成功率端点返回针对某个域名的请求成功比例,取值为 0 到 1 之间的数字。默认统计窗口为过去 7 天。 传入单个域名(例如 example.com)可获取该域名的成功率。传入通配符(例如 example.*)可获取该名称下每个受监控顶级域名的成功率。

如何按日期范围或 URL 筛选成功率?

添加可选的查询参数 from_datetime、to_datetime 和 url_pattern。每个参数都可以单独使用,也可以组合使用:
  • from_datetime 和 to_datetime 设置统计窗口。两者均接受 ISO 8601 UTC 日期(例如 2026-09-20)或日期时间(例如 2026-09-20T00:00:00Z)。
  • url_pattern 仅保留 URL 包含该字符串的请求。匹配方式为不区分大小写的子字符串匹配,并支持通配符域名。
以下请求返回 2026 年 9 月 20 日至 9 月 24 日期间,URL 包含 /ip/ 的 example.com 请求的成功率:
当 from_datetime 晚于 to_datetime 或日期无法解析时,请求将失败。 相关指南:Web Unlocker API 功能

授权

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?

路径参数

domain
string
必填

要查询的域名。可使用单个域名(例如 example.com),或使用通配符(例如 example.*)返回所有受监控的顶级域名。

示例:

"example.com"

查询参数

from_datetime
string

统计窗口的开始时间,采用 ISO 8601 UTC 格式。可传入日期(例如 2026-09-20)或日期时间(例如 2026-09-20T00:00:00Z)。from_datetime 可以单独使用,也可以与 to_datetime 一起使用。当 from_datetime 晚于 to_datetime 或参数值无法解析时,请求将失败。

示例:

"2026-09-20T00:00:00Z"

to_datetime
string

统计窗口的结束时间,采用 ISO 8601 UTC 格式。可传入日期(例如 2026-09-24)或日期时间(例如 2026-09-24T00:00:00Z)。to_datetime 可以单独使用,也可以与 from_datetime 一起使用。

示例:

"2026-09-24"

url_pattern
string

仅返回 URL 包含该字符串的请求的统计数据。匹配方式为不区分大小写的子字符串匹配,因此 /ip/ 会匹配任何包含 /ip/ 或 /IP/ 的请求 URL。支持通配符域名,例如 example.*。

示例:

"/ip/"

响应

OK

统计窗口内域名到成功率的映射,取值为 0 到 1 之间的数字。

{key}
number