支持查询目标网站的 Whois 信息(注册人信息、域名 DNS、注册 / 过期时间等)、网站核心元信息(标题、关键词、描述、图标),同时对网站进行网络访问测速,返回 DNS 解析耗时、TCP 连接耗时、TLS 握手耗时、首字节响应耗时、总响应耗时、重定向次数 / 耗时等详细延迟数据。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| url | url | 是 | 需要查询的网站URL。 | https://baidu.com |
[
{
"name": "url",
"type": "url",
"required": true,
"description": "需要查询的网站URL。",
"example": "https://baidu.com"
}
]
{"openapi":"3.1.1","info":{"title":"网站Whois信息","description":"支持查询目标网站的 Whois 信息(注册人信息、域名 DNS、注册 / 过期时间等)、网站核心元信息(标题、关键词、描述、图标),同时对网站进行网络访问测速,返回 DNS 解析耗时、TCP 连接耗时、TLS 握手耗时、首字节响应耗时、总响应耗时、重定向次数 / 耗时等详细延迟数据。","version":"1.0.0"},"paths":{"/v1/whois.php":{"get":{"summary":"网站Whois信息","description":"支持查询目标网站的 Whois 信息(注册人信息、域名 DNS、注册 / 过期时间等)、网站核心元信息(标题、关键词、描述、图标),同时对网站进行网络访问测速,返回 DNS 解析耗时、TCP 连接耗时、TLS 握手耗时、首字节响应耗时、总响应耗时、重定向次数 / 耗时等详细延迟数据。","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","example":"https://baidu.com"},"description":"需要查询的网站URL。"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"网站Whois信息","description":"支持查询目标网站的 Whois 信息(注册人信息、域名 DNS、注册 / 过期时间等)、网站核心元信息(标题、关键词、描述、图标),同时对网站进行网络访问测速,返回 DNS 解析耗时、TCP 连接耗时、TLS 握手耗时、首字节响应耗时、总响应耗时、重定向次数 / 耗时等详细延迟数据。","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","example":"https://baidu.com"},"description":"需要查询的网站URL。"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"code": 200,
"website": {
"title": "百度一下,你就知道",
"keyword": "无",
"description": "全球领先的中文搜索引擎、致力于让网民更便捷地获取信息,找到所求。百度超过千亿的中文网页数据库,可以瞬间找到相关的搜索结果。",
"icon": "https://www.baidu.com/favicon.ico",
"delay": {
"测试网址": "https://baidu.com",
"HTTP状态码": 200,
"DNS解析耗时(秒)": 0.004681,
"TCP连接耗时(秒)": 0.059991,
"TLS握手耗时(秒)": -0.059991,
"首字节响应耗时(TTFB/秒)": 0.183704,
"总响应耗时(秒)": 0.243891,
"下载速度(字节/秒)": 0,
"上传速度(字节/秒)": 0,
"重定向次数": 1,
"重定向耗时(秒)": 0.218872
}
},
"whois": {
"Registrant_name": "请联系当前域名注册商获取",
"Registrant_email": [
"请联系当前域名注册商获取"
],
"Registrar": [
"MarkMonitor Information Technology (Shanghai) Co., Ltd."
],
"RegistrarRaw": "MarkMonitor Information Technology (Shanghai) Co., Ltd.",
"Domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited",
"serverTransferProhibited",
"serverUpdateProhibited"
],
"Domain_dns": [
"ns2.baidu.com",
"ns4.baidu.com",
"ns7.baidu.com",
"ns3.baidu.com",
"ns1.baidu.com"
],
"Register_time": "1999-10-11 19:05:17",
"Expired_time": "2028-10-11 19:05:17",
"Up_time": "2026-08-17 06:35:10",
"Refresh_time": "2026-09-07 10:08:41"
},
"tips": "慕名API:http://xiaoapi.cn"
}
查询指定域名的注册信息、DNS 服务器、注册及到期时间等 Whois 数据,同时获取网站标题、关键词、描述及图标等元信息,并对目标站点进行网络访问测速,返回 DNS 解析、TCP 连接、TLS 握手、首字节及总响应耗时等性能数据。适用于网站信息核查、域名管理与性能监控场景。
/v1/whois.php
GET、POST
无需密钥即可调用。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | url | 是 | 需要查询的网站 URL |
url:传入目标网站的完整地址,需包含协议头(如 https://baidu.com)。{
"code": 200,
"website": {
"title": "百度一下,你就知道",
"keyword": "无",
"description": "全球领先的中文搜索引擎、致力于让网民更便捷地获取信息,找到所求。百度超过千亿的中文网页数据库,可以瞬间找到相关的搜索结果。",
"icon": "https://www.baidu.com/favicon.ico",
"delay": {
"测试网址": "https://baidu.com",
"HTTP状态码": 200,
"DNS解析耗时(秒)": 0.004681,
"TCP连接耗时(秒)": 0.059991,
"TLS握手耗时(秒)": -0.059991,
"首字节响应耗时(TTFB/秒)": 0.183704,
"总响应耗时(秒)": 0.243891,
"下载速度(字节/秒)": 0,
"上传速度(字节/秒)": 0,
"重定向次数": 1,
"重定向耗时(秒)": 0.218872
}
},
"whois": {
"Registrant_name": "请联系当前域名注册商获取",
"Registrant_email": [
"请联系当前域名注册商获取"
],
"Registrar": [
"MarkMonitor Information Technology (Shanghai) Co., Ltd."
],
"RegistrarRaw": "MarkMonitor Information Technology (Shanghai) Co., Ltd.",
"Domain_status": [
"clientDeleteProhibited",
"clientTransferProhibited",
"clientUpdateProhibited",
"serverDeleteProhibited",
"serverTransferProhibited",
"serverUpdateProhibited"
],
"Domain_dns": [
"ns2.baidu.com",
"ns4.baidu.com",
"ns7.baidu.com",
"ns3.baidu.com",
"ns1.baidu.com"
],
"Register_time": "1999-10-11 19:05:17",
"Expired_time": "2028-10-11 19:05:17",
"Up_time": "2026-08-17 06:35:10",
"Refresh_time": "2026-09-07 10:08:41"
}
}
| 字段路径 | 类型 | 说明 |
|---|---|---|
| code | integer | 接口返回状态码,200 表示成功 |
| website | object | 网站核心元信息对象 |
| website.title | string | 网站页面标题 |
| website.keyword | string | 网站关键词,多个关键词以逗号分隔,无关键词时返回"无" |
| website.description | string | 网站描述信息 |
| website.icon | string | 网站图标(favicon)访问地址 |
| website.delay | object | 网络访问测速数据对象 |
| website.delay.测试网址 | string | 本次测速的实际请求地址 |
| website.delay.HTTP状态码 | integer | 目标服务器返回的 HTTP 状态码 |
| website.delay.DNS解析耗时(秒) | number | DNS 查询完成所消耗的时间 |
| website.delay.TCP连接耗时(秒) | number | TCP 三次握手建立连接所消耗的时间 |
| website.delay.TLS握手耗时(秒) | number | TLS/SSL 安全握手所消耗的时间,非 HTTPS 网站或未启用 TLS 时可能为负数或 0 |
| website.delay.首字节响应耗时(TTFB/秒) | number | 从发起请求到收到第一个字节数据的时间(Time To First Byte) |
| website.delay.总响应耗时(秒) | number | 从发起请求到完成全部内容下载的总耗时 |
| website.delay.下载速度(字节/秒) | number | 内容下载阶段的平均速度 |
| website.delay.上传速度(字节/秒) | number | 请求上传阶段的平均速度 |
| website.delay.重定向次数 | integer | 请求过程中的 HTTP 重定向跳转总次数 |
| website.delay.重定向耗时(秒) | number | 全部重定向跳转所消耗的总时间 |
| whois | object | Whois 注册信息对象 |
| whois.Registrant_name | string | 注册人姓名或公司名称,受隐私保护时返回"请联系当前域名注册商获取" |
| who |
{
"code": 0,
"msg": "请求过于频繁,请稍后重试",
"errcode": 11005
}
| errcode | 说明 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
POST 方式
curl -X POST "https://api.xiaoapi.cn/v1/whois.php" -d "url=https://baidu.com"
GET 方式
curl "https://api.xiaoapi.cn/v1/whois.php?url=https%3A%2F%2Fbaidu.com"
// PHP
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.xiaoapi.cn/v1/whois.php?url=" . urlencode("https://baidu.com"));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
url 参数必须包含完整协议头(http:// 或 https://),否则可能导致查询失败或结果不准确。建议直接使用 HTTPS 地址以获取更完整的数据。delay 中的 TLS 握手耗时可能出现负值,这是由 DNS 解析、TCP 连接等阶段耗时交叉计算所致,实际总响应时间应以「总响应耗时(秒)」字段为准。curl -s "https://xiaoapi.cn/v1/whois.php?url=https://baidu.com" | head -c 200
if [ $? -ne 0 ]; then echo "请求失败"; fi
// 结果将在此处显示