加载接口文档…
1.5万
累计调用
762ms
平均响应
99.96%
服务可用性
1,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 300 次 · QPS 2
登录免费
当前方案每日 1,000 次 · QPS 5
黄金会员
每日 50,000 次 · QPS 60
企业会员
每日 1,000,000 次 · QPS 120
文档链接
复制文档地址
https://apizero.cn/aidocs/whois/raw.md接口请求地址
https://v1.apizero.cn/api/whois
接口请求方式
GET
请求参数格式
QUERY STRING
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/whois?domain=baidu.com&with_raw=false
接口信息备注
匿名每日 30 次、QPS 2；登录用户每日 100 次、QPS 5（全部免费）。命中 24h 缓存不计入服务配额。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| domain | string | 必填 · 待查询域名。自动剥离 http(s):// 前缀、路径、:port 后缀、子域名（如 www.baidu.com → baidu.com 由服务处理） · 示例：baidu.com |
| with_raw | bool | 可选 · 是否返回 raw_whois 原始 whois 文本（约 3KB），默认 false。建议仅调试时启用 · 示例：false |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 |
|---|---|---|
| domain | string | 归一化后的主域名（如 baidu.com） |
| suffix | string | 域名后缀（如 com / cn / org） |
| is_available | boolean | 域名是否可注册（true=未注册可抢注，false=已被注册） |
| is_expired | boolean | 域名是否已过期 |
| expiring_soon | boolean | 30 天内即将到期（true 时建议提示用户续费） |
| registrar | string | 注册商名称（如 阿里云 / GoDaddy / MarkMonitor） |
| registrant | string | 注册主体（个人/公司名，受隐私保护可能为空） |
| registrant_email | string | 注册联系邮箱（多数被脱敏） |
| creation_time | string | 注册时间（YYYY-MM-DD HH:MM:SS） |
| expiration_time | string | 到期时间（YYYY-MM-DD HH:MM:SS） |
| creation_days | number | 已注册天数（域龄） |
| creation_age_text | string | 域龄人类可读字符串（如 "28 年" / "3 个月"） |
| valid_days | number | 剩余有效天数 |
| domain_status | array | 域名状态数组（如 clientTransferProhibited） |
| name_servers | array | DNS 服务器数组（如 ["NS1.GOOGLE.COM","NS2.GOOGLE.COM"]） |
| whois_server | string | 权威 whois 服务器（如 whois.markmonitor.com） |
| dnssec | string | DNSSEC 状态（unsigned / signedDelegation） |
| registrar_url | string | 注册商官网 URL |
| registrar_abuse_email | string | 注册商滥用举报邮箱 |
| registrar_abuse_phone | string | 注册商滥用举报电话 |
| query_time | string | 服务查询时间戳 |
| raw_whois | string | 原始 whois 文本（仅在 with_raw=true 时返回） |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"domain": "baidu.com",
"suffix": "com",
"is_available": false,
"is_expired": false,
"expiring_soon": false,
"registrar": "MarkMonitor Information Technology (Shanghai) Co., Ltd.",
"registrant": "",
"registrant_email": "",
"creation_time": "1999-10-11 19:05:17",
"expiration_time": "2028-10-11 19:05:17",
"creation_days": 9704,
"creation_age_text": "26 年 7 个月",
"valid_days": 888,
"domain_status": [
"clientDeleteProhibited （注册商设置禁止删除）",
"clientTransferProhibited （注册商设置禁止转移）"
],
"name_servers": [
"NS1.BAIDU.COM",
"NS2.BAIDU.COM",
"NS3.BAIDU.COM"
],
"whois_server": "whois.markmonitor.com",
"dnssec": "unsigned",
"registrar_url": "http://markmonitor.com",
"registrar_abuse_email": "abusecomplaints@markmonitor.com",
"registrar_abuse_phone": "+1.2083895740",
"query_time": "2026-05-07 09:18:54"
},
"request_id": "abc123def456",
"tips": "极数本源 · https://apizero.cn"
}免责声明
Whois 数据由域名注册局返回，部分 TLD（如 .com）受 GDPR / 隐私保护政策影响，注册主体可能脱敏（显示 REDACTED FOR PRIVACY 或代理服务商信息）。raw_whois 字段为原始服务文本，仅作参考（默认不返回，需 with_raw=true）。本接口缓存 24 小时，刚转移注册商或刚续费的域名可能展示旧数据。