获取域名的注册信息,包括注册商、注册人、创建/到期时间、DNS服务器、域名年龄等。支持200+域名后缀。
获取域名的注册信息,包括注册商、注册人、创建/到期时间、DNS服务器、域名年龄等。支持200+域名后缀。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| domain | string | 是 | 查询域名 |
[
{
"name": "domain",
"type": "string",
"required": true,
"description": "查询域名",
"example": ""
}
]{"openapi":"3.1.1","info":{"title":"WHOIS域名查询","description":"获取域名的注册信息,包括注册商、注册人、创建/到期时间、DNS服务器、域名年龄等。支持200+域名后缀。","version":"1.0.0"},"paths":{"/apis/gateway?api=whois":{"get":{"summary":"WHOIS域名查询","description":"获取域名的注册信息,包括注册商、注册人、创建/到期时间、DNS服务器、域名年龄等。支持200+域名后缀。","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"description":"查询域名"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"WHOIS域名查询","description":"获取域名的注册信息,包括注册商、注册人、创建/到期时间、DNS服务器、域名年龄等。支持200+域名后缀。","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"},"description":"查询域名"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"https://api.souxiaocha.com","description":"当前访问入口(https)"}]}
{"success":true,"data":{"domain":"wengbi.com","registrar":"eName Technology Co., Ltd.","registrant":null,"registrant_email":null,"creation_date":"2012-07-05 13:37:02","expiry_date":"2027-07-05 13:37:02","updated_date":"2026-06-09 11:26:39","name_servers":["NS1.ENAME.NET","NS2.ENAME.NET"],"status":["clientDeleteProhibited https:\/\/icann.org\/epp#clientDeleteProhibited","clientTransferProhibited https:\/\/icann.org\/epp#clientTransferProhibited"],"dnssec":"unsigned","domain_age":{"years":14,"months":1,"days":20,"total_days":5150,"age_text":"14年1个月"}},"generated_at":"2026-08-11 16:24:15"}https://api.souxiaocha.com/apis/gateway?api=whoisGET https://api.souxiaocha.com/apis/gateway?api=whois apikey=你的API密钥&domain=请填写domain
GET 参数放在查询字符串中。参数值请替换为实际有效值。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
domain | string | 是 | 查询域名 |
{"success":true,"data":{"domain":"wengbi.com","registrar":"eName Technology Co., Ltd.","registrant":null,"registrant_email":null,"creation_date":"2012-07-05 13:37:02","expiry_date":"2027-07-05 13:37:02","updated_date":"2026-06-09 11:26:39","name_servers":["NS1.ENAME.NET","NS2.ENAME.NET"],"status":["clientDeleteProhibited https:\/\/icann.org\/epp#clientDeleteProhibited","clientTransferProhibited https:\/\/icann.org\/epp#clientTransferProhibited"],"dnssec":"unsigned","domain_age":{"years":14,"months":1,"days":20,"total_days":5150,"age_text":"14年1个月"}},"generated_at":"2026-08-11 16:24:15"}获取域名的注册信息,包括注册商、注册人、创建/到期时间、DNS服务器、域名年龄等。支持200+域名后缀。
https://api.souxiaocha.com/apis/gateway?api=whois
GET / POST(业务参数 GET 通过 URL 传递,POST 支持表单或 JSON)
调用需携带平台密钥(用户中心「令牌管理」获取,SK- 开头):
key=SK-你的密钥X-API-Key: SK-你的密钥| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| domain | string | 是 | 查询域名 |
[
{"name": "domain", "type": "string", "required": true, "description": "查询域名"}
]
成功返回示例:
{"success":true,"data":{"domain":"wengbi.com","registrar":"eName Technology Co., Ltd.","registrant":null,"registrant_email":null,"creation_date":"2012-07-05 13:37:02","expiry_date":"2027-07-05 13:37:02","updated_date":"2026-06-09 11:26:39","name_servers":["NS1.ENAME.NET","NS2.ENAME.NET"],"status":["clientDeleteProhibited https:\/\/icann.org\/epp#clientDeleteProhibited","clientTransferProhibited https:\/\/icann.org\/epp#clientTransferProhibited"],"dnssec":"unsigned","domain_age":{"years":14,"months":1,"days":20,"total_days":5150,"age_text":"14年1个月"}},"generated_at":"2026-08-11 16:24:15"}
失败返回示例:
{"success":false,"error":"missing_domain","message":"请提供域名参数(domain)"}
| 参数名 | 类型 | 说明 |
|---|---|---|
| data.domain | string | 查询域名 |
| data.registrar | string | 注册商 |
| data.registrant | string | 注册人/组织 |
| data.registrant_email | string | 注册邮箱(可能因隐私保护为空) |
| data.creation_date | string | 创建时间 |
| data.expiry_date | string | 到期时间 |
| data.updated_date | string | 更新时间 |
| data.name_servers | array | DNS服务器列表 |
| data.status | array | 域名状态列表 |
| data.dnssec | array | DNSSEC状态 |
| data.domain_age | object | 域名年龄信息 |
| data.domain_age.years | integer | 年 |
| data.domain_age.months | integer | 月 |
| data.domain_age.days | integer | 天 |
| data.domain_age.total_days | integer | 总天数 |
| data.domain_age.age_text | string | 年龄描述(如"26年10个月") |
curl "https://api.souxiaocha.com/apis/gateway?api=whois?key=SK-你的密钥&domain=douhao.com"
上游业务级错误:
| code | msg | 描述 |
|---|---|---|
| 400 | missing_domain | 缺少domain参数 |
| 400 | invalid_domain | 域名格式不正确 |
| 400 | unsupported_tld | 不支持的域名后缀 |
| 502 | whois_query_failed | WHOIS查询失败 |
| 502 | parse_failed | 数据解析失败 |
平台级错误(errcode):11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。
失败时请以响应体中的 code / errcode 与 msg 判断。
2026-09-24
curl "https://api.souxiaocha.com/apis/gateway?api=whois?key=SK-你的密钥&domain=douhao.com"
// 结果将在此处显示