API 文档
欢迎使用 Whois查询网 提供的域名Whois信息查询API接口。本服务支持实时返回域名的注册信息、状态、DNS、注册商等内容。
Whois API为公益性质的免费接口,请勿恶意调用或高频请求。仅限开发测试使用,禁止用于生产环境,我们不承诺服务稳定性与持续可用性。
请求参数
参数名 | 类型 | 是否必填 | 说明 | 示例值 |
---|---|---|---|---|
domain | string | 是 | 要查询的完整域名(支持多种后缀) | example.com |
raw | int | 可选 | 是否返回原始 Whois 文本,1 为返回,0 为不返回 | 1 |
返回示例
{ "status": 1, "data": { "is_available": 0, "domain": "whoiscx.com", "domain_suffix": "com", "query_time": "2025-06-20 06:06:32", "info": { "domain": "whoiscx.com", "registrant_name": "", "registrant_email": "", "registrar_name": "Alibaba Cloud Computing Ltd. d/b/a HiChina (www.net.cn)", "creation_time": "2012-04-25 12:36:40", "expiration_time": "2026-04-25 12:36:40", "creation_days": 4803, "valid_days": 309, "is_expire": 0, "domain_status": [ "ok (正常)" ], "name_server": [ "DNS25.HICHINA.COM", "DNS26.HICHINA.COM" ], "whois_server": "grs-whois.hichina.com" }, "raw": "Domain Name: WHOISCX.COM\r\n Registry Domain ID: 1715893795_DOMAIN_COM-VRSN\r\n Registrar WHOIS Server: grs-whois.hichina.com\r\n Registrar URL: http://wanwang.aliyun.com\r\n Updated Date: 2025-04-11T12:59:33Z\r\n Creation Date: 2012-04-25T10:36:40Z\r\n Registry Expiry Date: 2026-04-25T10:36:40Z\r\n Registrar: Alibaba Cloud Computing Ltd. d/b/a HiChina (www.net.cn)\r\n Registrar IANA ID: 1599\r\n Registrar Abuse Contact Email: DomainAbuse@service.aliyun.com\r\n Registrar Abuse Contact Phone: +86.95187\r\n Domain Status: ok https://icann.org/epp#ok\r\n Name Server: DNS25.HICHINA.COM\r\n Name Server: DNS26.HICHINA.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: 2025-06-20T04:06:22Z <<<" } }
API字段说明
字段 | 含义 | 示例值 |
---|---|---|
status | 状态码,1 表示成功,0 表示失败 | 1 |
is_available | 域名是否可注册(1=可注册,0=已注册) | 0 |
domain | 完整域名 | whoiscx.com |
domain_suffix | 域名后缀 | com |
query_time | 查询时间 | 2025-06-20 06:06:32 |
registrant_name | 注册人姓名(如未公开则为空) | (空) |
registrant_email | 注册人邮箱(如未公开则为空) | (空) |
registrar_name | 注册商名称 | Alibaba Cloud Computing Ltd. d/b/a HiChina |
creation_time | 域名创建时间 | 2012-04-25 12:36:40 |
expiration_time | 域名到期时间 | 2026-04-25 12:36:40 |
creation_days | 域名已注册天数 | 4803 |
valid_days | 域名距离到期剩余天数 | 309 |
is_expire | 是否已过期(1=已过期,0=未过期) | 0 |
domain_status | 域名状态(如正常、锁定等) | ok(正常) |
name_server | 域名的 DNS 服务器 | DNS25.HICHINA.COM DNS26.HICHINA.COM |
whois_server | 提供 Whois 信息的服务器地址 | grs-whois.hichina.com |
raw | 原始 Whois 返回内容 | (完整原始文本,略) |
调用说明
- 请求方式:仅支持
GET
请求。 - 接口地址:
http(s)://api.whoiscx.com/whois/
- 支持频次: 每个 IP 默认限制为 2秒/次,超出后将返回限制提示。
- 响应格式:
application/json
- 支持后缀: 支持查询全球主流后缀(包含 .com、.cn、.org、.net 等 3000+ 类别域名)
- 字符编码: 响应统一采用
UTF-8
编码 - 使用须知: Whois API 为公益性质的免费接口,仅供开发与测试用途。请勿进行恶意调用或高频请求,禁止用于生产环境,我们不保证服务的持续可用性与稳定性。
- 私有部署: 如需在正式环境中使用,欢迎联系我们支持付费购买并私有部署以确保稳定性与安全性。