WHOIS 域名信息查询,返回注册时间、到期时间、注册商、DNS、状态及原始数据。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| domain | string | 是 | 域名 | baidu.com |
[
{
"name": "domain",
"type": "string",
"required": true,
"description": "域名",
"example": "baidu.com"
}
]
{
"openapi": "3.1.1",
"info": {
"title": "whois查询",
"description": "WHOIS 域名信息查询,返回注册时间、到期时间、注册商、DNS、状态及原始数据。",
"version": "1.0.0"
},
"paths": {
"\/api\/network\/whois.php": {
"get": {
"summary": "whois查询",
"description": "WHOIS 域名信息查询,返回注册时间、到期时间、注册商、DNS、状态及原始数据。",
"parameters": [
{
"name": "domain",
"in": "query",
"required": true,
"schema": {
"type": "string",
"example": "baidu.com"
},
"description": "域名"
}
],
"responses": {
"200": {
"description": "成功",
"content": {
"application\/json": {
"schema": {
"type": "object"
}
}
}
}
}
}
}
},
"servers": [
{
"url": "https:\/\/api.vsaa.cn",
"description": "当前访问入口(https)"
}
]
}
{
"code": 0,
"status": true,
"msg": "查询成功",
"data": {
"address": [],
"city": "",
"country": "",
"creation_date": "1999-10-11 11:05:17",
"dnssec": "unsigned",
"domain_name": "baidu.com",
"emails": [
"abusecomplaints@markmonitor.com"
],
"expiration_date": "2028-10-11 11:05:17",
"name": "",
"name_servers": [
"NS1.BAIDU.COM",
"NS2.BAIDU.COM",
"NS3.BAIDU.COM",
"NS4.BAIDU.COM",
"NS7.BAIDU.COM"
],
"org": "Registry ID: 11181110_DOMAIN_COM-VRSN",
"phone": [
"+1.2083895740"
],
"referral_url": null,
"registrant_postal_code": "",
"registrar": "MarkMonitor Information Technology (Shanghai) Co., Ltd. (IANA ID: 3838)",
"registrar_url": "http://markmonitor.com",
"reseller": null,
"state": "",
"status": "clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited; clientTransferProhibited https://icann.org/epp#clientTransferProhibited; clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited; serverDeleteProhibited https://icann.org/epp#serverDeleteProhibited; serverTransferProhibited https://icann.org/epp#serverTransferProhibited; serverUpdateProhibited https://icann.org/epp#serverUpdateProhibited",
"updated_date": "2026-08-17 07:44:00",
"whois_server": "whois.markmonitor.com",
"rawData": "Domain Name: BAIDU.COM\r\n Registry Domain ID: 11181110_DOMAIN_COM-VRSN\r\n Registrar WHOIS Server: whois.markmonitor.com\r\n Registrar URL: http://markmonitor.com\r\n Updated Date: 2026-08-17T07:44:00Z\r\n Creation Date: 1999-10-11T11:05:17Z\r\n Registry Expiry Date: 2028-10-11T11:05:17Z\r\n Registrar: MarkMonitor Information Technology (Shanghai) Co., Ltd.\r\n Registrar IANA ID: 3838\r\n Registrar Abuse Contact Email: abusecomplaints@markmonitor.com\r\n Registrar Abuse Contact Phone: +1.2083895740\r\n Domain Status: clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited\r\n Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\r\n Domain Status: clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited\r\n Domain Status: serverDeleteProhibited https://icann.org/epp#serverDeleteProhibited\r\n Domain Status: serverTransferProhibited https://icann.org/epp#serverTransferProhibited\r\n Domain Status: serverUpdateProhibited https://icann.org/epp#serverUpdateProhibited\r\n Name Server: NS1.BAIDU.COM\r\n Name Server: NS2.BAIDU.COM\r\n Name Server: NS3.BAIDU.COM\r\n Name Server: NS4.BAIDU.COM\r\n Name Server: NS7.BAIDU.COM\r\n DNSSEC: unsigned\r\n URL of the ICANN Whois Inaccuracy Complaint Form: https://www.icann.org/wicf/\r\n\u003E\u003E\u003E Last update of whois database: 2026-09-03T06:02:12Z \u003C\u003C\u003C\r\n\r\nFor more information on Whois status codes, please visit https://icann.org/epp\r\n\r\nNOTICE: The expiration date displayed in this record is the date the\r\nregistrar's sponsorship of the domain name registration in the registry is\r\ncurrently set to expire. This date does not necessarily reflect the expiration\r\ndate of the domain name registrant's agreement with the sponsoring\r\nregistrar. Users may consult the sponsoring registrar's Whois database to\r\nview the registrar's reported date of expiration for this registration.\r\n\r\nTERMS OF USE: You are not authorized to access or query our Whois\r\ndatabase through the use of electronic processes that are high-volume and\r\nautomated except as reasonably necessary to register domain names or\r\nmodify existing registrations; the Data in VeriSign Global Registry\r\nServices' (\"VeriSign\") Whois database is provided by VeriSign for\r\ninformation purposes only, and to assist persons in obtaining information\r\nabout or related to a domain name registration record. VeriSign does not\r\nguarantee its accuracy. By submitting a Whois query, you agree to abide\r\nby the following terms of use: You agree that you may use this Data only\r\nfor lawful purposes and that under no circumstances will you use this Data\r\nto: (1) allow, enable, or otherwise support the transmission of mass\r\nunsolicited, commercial advertising or solicitations via e-mail, telephone,\r\nor facsimile; or (2) enable high volume, automated, electronic processes\r\nthat apply to VeriSign (or its computer systems). The compilation,\r\nrepackaging, dissemination or other use of this Data is expressly\r\nprohibited without the prior written consent of VeriSign. You agree not to\r\nuse electronic processes that are automated and high-volume to access or\r\nquery the Whois database except as reasonably necessary to register\r\ndomain names or modify existing registrations. VeriSign reserves the right\r\nto restrict your access to the Whois database in its sole discretion to ensure\r\noperational stability. VeriSign may restrict or terminate your access to the\r\nWhois database for failure to abide by these terms of use. VeriSign\r\nreserves the right to modify these terms at any time.\r\n\r\nThe Registry database contains ONLY .COM, .NET, .EDU domains and\r\nRegistrars."
}
}
本接口提供全面、准确的 WHOIS 域名信息查询服务,支持查询域名的注册时间、更新时间、到期时间、注册商、DNS 状态及原始 WHOIS 数据等详细信息。面向所有需要快速获取域名基础信息、检查域名状态或进行域名合规核查的开发者开放,无需鉴权且免费使用,限频约 120 次/分钟。
/api/network/whois.php
GET
该接口无需密钥鉴权。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| domain | string | 是 | 待查询的域名,例如 baidu.com |
{
"code": 0,
"status": true,
"msg": "查询成功",
"data": {
"address": [],
"city": "",
"country": "",
"creation_date": "1999-10-11 11:05:17",
"dnssec": "unsigned",
"domain_name": "baidu.com",
"emails": [
"abusecomplaints@markmonitor.com"
],
"expiration_date": "2028-10-11 11:05:17",
"name": "",
"name_servers": [
"NS1.BAIDU.COM",
"NS2.BAIDU.COM",
"NS3.BAIDU.COM",
"NS4.BAIDU.COM",
"NS7.BAIDU.COM"
],
"org": "Registry ID: 11181110_DOMAIN_COM-VRSN",
"phone": [
"+1.2083895740"
],
"referral_url": null,
"registrant_postal_code": "",
"registrar": "MarkMonitor Information Technology (Shanghai) Co., Ltd. (IANA ID: 3838)",
"registrar_url": "http://markmonitor.com",
"reseller": null,
"state": "",
"status": "clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited; clientTransferProhibited https://icann.org/epp#clientTransferProhibited; clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited; serverDeleteProhibited https://icann.org/epp#serverDeleteProhibited; serverTransferProhibited https://icann.org/epp#serverTransferProhibited; serverUpdateProhibited https://icann.org/epp#serverUpdateProhibited",
"updated_date": "2026-08-17 07:44:00",
"whois_server": "whois.markmonitor.com",
"rawData": "Domain Name: BAIDU.COM\r\n Registry Domain ID: 11181110_DOMAIN_COM-VRSN\r\n Registrar WHOIS Server: whois.markmonitor.com\r\n Registrar URL: http://markmonitor.com\r\n Updated Date: 2026-08-17T07:44:00Z\r\n Creation Date: 1999-10-11T11:05:17Z\r\n Registry Expiry Date: 2028-10-11T11:05:17Z\r\n Registrar: MarkMonitor Information Technology (Shanghai) Co., Ltd.\r\n Registrar IANA ID: 3838\r\n Registrar Abuse Contact Email: abusecomplaints@markmonitor.com\r\n Registrar Abuse Contact Phone: +1.2083895740\r\n Domain Status: clientDeleteProhibited https://icann.org/epp#clientDeleteProhibited\r\n Domain Status: clientTransferProhibited https://icann.org/epp#clientTransferProhibited\r\n Domain Status: clientUpdateProhibited https://icann.org/epp#clientUpdateProhibited\r\n Domain Status: serverDeleteProhibited https://icann.org/epp#serverDeleteProhibited\r\n Domain Status: serverTransferProhibited https://icann.org/epp#serverTransferProhibited\r\n Domain Status: serverUpdateProhibited https://icann.org/epp#serverUpdateProhibited\r\n Name Server: NS1.BAIDU.COM\r\n Name Server: NS2.BAIDU.COM\r\n Name Server: NS3.BAIDU.COM\r\n Name Server: NS4.BAIDU.COM\r\n Name Server: NS7.BAIDU.COM\r\n DNSSEC: unsigned\r\n URL of the ICANN Whois Inaccuracy Complaint Form: https://www.icann.org/wicf/\r\n>>> Last update of whois database: 2026-09-03T06:02:12Z
## 错误响应示例
```json
{
"code": -1,
"msg": "域名参数缺失",
"errcode": 11001
}
| 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 | 出口代理不可用 |
curl -X GET "/api/network/whois.php?domain=baidu.com"
## 注意事项
- 本接口无需密钥即可调用,但仍建议通过 HTTPS 协议访问,确保数据传输安全。
- 调用频率上限为每分钟约 120 次,超出限制将返回错误,请合理控制请求间隔。
- `domain` 参数为必填项,请输入符合规范的完整域名(如 `baidu.com`),不支持 IP 地址查询。
- WHOIS 数据受各注册局及使用条款约束,请勿将接口数据用于批量采集、自动化高并发查询或其他违规用途。
- 部分域名可能因隐私保护策略而无法获取完整注册信息,返回字段可能为空数组或空字符串,属正常现象。
- 接口返回的 `rawData` 为原始 WHOIS 文本,不同注册商的格式可能存在差异,结构化字段请以 JSON 输出为准。
- 免费接口暂不提供 SLA 保障,如遇注册局维护或数据源延迟,查询结果可能不及时,建议设置合理超时重试机制。curl "https://api.sxi.cn/api/network/whois.php?domain=baidu.com"
欢迎使用 万象数据API(以下简称“本平台”,域名为 api.vsaa.cn)。在使用本平台提供的任何接口、数据及相关服务之前,请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用,均视为您已阅读、理解并同意本声明的全部条款。
最后更新日期:2026年10月6日