Skip to main content
GET
cURL
Bright Data Web Unlocker API 成功率端点返回针对某个域名的请求成功比例(取值为 0 到 1 之间的数字),以及 time_p90,即第 90 百分位响应时间(单位为毫秒)。默认统计窗口为过去 7 天。

可以查询哪些域名?

在 {domain} 路径段中传入单个域名或通配符:
  • example.com 返回该域名的统计数据。
  • example.* 返回所有以 example. 开头的受监控域名的统计数据,例如 example.org 和 example.de。
  • *.example.com 返回 example.com 下每个受监控子域名的统计数据,例如 api.example.com。

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

添加可选的查询参数 from_datetime、to_datetime 和 url_pattern。每个参数都可以单独使用,也可以组合使用:
  • from_datetime 和 to_datetime 设置统计窗口。两者均接受 ISO 8601 UTC 日期(例如 2026-10-12)或日期时间(例如 2026-10-12T00:00:00Z)。仅传入日期时表示该日 UTC 零点,因此 to_datetime=2026-10-19 统计截至 10 月 18 日结束的请求。
  • url_pattern 仅保留 URL 包含该字符串的请求。匹配不区分大小写,并支持通配符域名。
以下请求返回 2026 年 10 月 12 日至 10 月 19 日期间,URL 包含 /ip/ 的 example.com 请求的成功率和 p90 响应时间:
响应中每个域名对应一个键,另有一个 time_p90 键:

响应包含哪些内容?

响应是一个 JSON 对象,包含两类键:
  • 每个域名一个键。 值为统计窗口内的成功率,范围从 0(没有请求成功)到 1(所有请求都成功)。0.9639 表示 96.39% 的请求成功。
  • time_p90。 统计窗口内请求的第 90 百分位(p90)响应时间,单位为毫秒。响应中只有一个 time_p90 值,而不是每个域名一个,通配符查询也是如此。

什么是 p90 响应时间?

p90 响应时间是指 90% 的请求在该时间内完成。time_p90 为 3347.98 表示 90% 的请求在 3,348 毫秒(约 3.3 秒)内完成,最慢的 10% 请求耗时更长。 在设置超时时间时,p90 比平均值更有参考价值,因为少数极慢的请求会拉高或拉低平均值。请将客户端超时时间设置为高于 time_p90 的值,确保至少 90% 的请求能够完成。

没有匹配数据时会怎样?

当没有请求与查询匹配时,端点返回 HTTP 200 和空对象 {}。以下情况会出现这种结果:域名没有受监控的流量、url_pattern 未匹配任何请求 URL,或 from_datetime 等于或晚于 to_datetime。
对大型域名或较长时间窗口的查询可能需要 60 秒以上才能返回。请将 HTTP 客户端超时时间设置为至少 120 秒,并逐个发送查询。
相关指南: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. 开头的受监控域名,或使用 *.example.com 返回 example.com 下所有受监控子域名。

示例:

"example.com"

查询参数

from_datetime
string

统计窗口的开始时间,采用 ISO 8601 UTC 格式。可传入日期(例如 2026-10-12)或日期时间(例如 2026-10-12T00:00:00Z)。仅传入日期时表示该日 UTC 零点。from_datetime 可以单独使用,也可以与 to_datetime 一起使用。当 from_datetime 等于或晚于 to_datetime 时,响应为空对象 {}。

示例:

"2026-10-12"

to_datetime
string

统计窗口的结束时间,采用 ISO 8601 UTC 格式。可传入日期(例如 2026-10-19)或日期时间(例如 2026-10-19T00:00:00Z)。仅传入日期时表示该日 UTC 零点,因此 2026-10-19 统计截至 10 月 18 日结束的请求。to_datetime 可以单独使用,也可以与 from_datetime 一起使用。

示例:

"2026-10-19"

url_pattern
string

仅返回 URL 包含该字符串的请求的统计数据。匹配不区分大小写,因此 /ip/ 会匹配任何包含 /ip/ 或 /IP/ 的请求 URL。支持通配符域名,例如 example.*。没有匹配的请求 URL 时,响应为空对象 {}。

示例:

"/ip/"

响应

每个域名的成功率以及一个 time_p90 值。空对象 {} 表示没有请求与查询匹配。

JSON 对象,每个域名对应一个键,另有一个 time_p90 键。每个域名键的值为统计窗口内的成功率,取值为 0 到 1 之间的数字。time_p90 为第 90 百分位响应时间,单位为毫秒:统计窗口内 90% 的请求在该时间内完成。响应中只有一个 time_p90 值,而不是每个域名一个,通配符查询也是如此。

time_p90
number

统计窗口内请求的第 90 百分位(p90)响应时间,单位为毫秒。90% 的请求在该时间内完成,最慢的 10% 请求耗时更长。

示例:

3347.98323864866

{key}
number

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