Whois 域名信息查询

接口标识: whois 价格: 0.008 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

Whois 域名信息查询接口输入一个域名即可查得注册商、注册时间、到期时间、最近更新时间、域名状态、DNS 服务器与距到期天数等注册信息，注册人信息在公开时一并返回。查询以 RDAP 结构化数据为主、传统 Whois 协议自动兜底，覆盖主流国际后缀与部分国家后缀；输入可带协议头与路径，接口自动清洗校验。适合域名资产盘点、到期续费提醒、品牌保护监测与域名交易前核实等场景。

详细介绍

![Whois 域名信息查询接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_whois__1794363334_335745c3d856.png)

域名什么时候到期、在哪家注册商手里、处于什么状态，品牌保护与域名交易都离不开这些信息。Whois 域名信息查询接口一次调用全部返回。

## 接口概述
面向域名资产盘点、到期续费提醒、品牌保护监测与交易前核实等场景，输入一个域名，接口返回注册商、注册时间、到期时间、最近更新时间、域名状态、DNS 服务器与距到期天数等注册信息，注册人信息在公开时一并返回。查询以 RDAP 结构化数据为主，对缺少 RDAP 服务的后缀自动回退传统 Whois 协议查询，结果中回显数据来源便于核对。域名可整段粘贴，接口会自动去除协议头、路径与端口并完成格式校验。

## 核心能力
1. **信息全面**：注册商、三大时间、状态数组、DNS 服务器与距到期天数一次查齐。
2. **双源聚合**：RDAP 结构化查询为主、传统 Whois 协议兜底，覆盖主流国际后缀与部分国家后缀。
3. **到期倒计时**：直接返回距到期天数，续费提醒系统拿来即用无需自行计算。
4. **自动清洗**：输入可带协议头、路径与端口，接口自动提取合法域名并校验格式。
5. **来源可查**：结果回显数据来源（rdap 或 whois），方便与注册局信息核对。

## 产品优势
1. **接入简单**：单次 POST 传一个域名即得结构化结果，无需逐家对接注册局。
2. **响应迅速**：同步实时查询，快速返回注册局数据。
3. **结构化输出**：时间与状态均为解析好的字段，省去自写 Whois 文本解析规则。
4. **稳定可靠**：单一数据源缺失时自动回退另一协议查询，提升查询成功率。
5. **降本增效**：批量盘点域名资产时替代人工逐个到注册局网站查询。

## 效果展示
一句话理解：它就像查域名的「户籍档案」，谁注册的、什么时候到期、处于什么状态，一查便知。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| domain | example.com | 要查询的域名，直接传域名主体即可，协议头与路径会被自动去除 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 注册商 | Example Registrar, Inc. | `registrar` |
| 注册时间 | 1995-08-14 04:00:00 | `created_date` |
| 到期时间 | 2027-08-13 04:00:00 | `expires_date` |
| 域名状态 | client delete prohibited 等 3 项 | `status`，状态数组 |
| DNS 服务器 | a.iana-servers.net 等 2 项 | `name_servers`，DNS 服务器数组 |
| 距到期天数 | 276 | `days_to_expire`，续费提醒直接用 |
| 数据来源 | rdap | `source`，rdap 或 whois |

API请求示例：

```text
POST /api/whois
domain=example.com
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "domain": "example.com",
    "registrar": "Example Registrar, Inc.",
    "created_date": "1995-08-14 04:00:00",
    "expires_date": "2027-08-13 04:00:00",
    "updated_date": "2026-08-14 07:01:23",
    "status": ["client delete prohibited", "client transfer prohibited", "client update prohibited"],
    "name_servers": ["a.iana-servers.net", "b.iana-servers.net"],
    "registrant": "",
    "days_to_expire": 276,
    "source": "rdap"
  },
  "request_id": "whois-demo-example-0001"
}
```

注册人开启隐私保护时 `registrant` 为空字符串，其余字段照常返回；未注册的域名或暂不支持的后缀，接口返回带说明的参数错误。

## 应用场景
1. **资产盘点**：企业批量核查自有域名组合的注册信息与到期时间。
2. **续费提醒**：用距到期天数搭建倒计时提醒流程，防止域名失续被抢注。
3. **品牌保护**：监测品牌近似域名的注册动态，及时取证与异议。
4. **交易尽调**：域名买卖前核实注册历史、状态锁与 DNS 配置。
5. **安全排查**：结合 DNS 服务器与注册信息辅助判定域名归属。

## 应用案例
一家集团的信息技术部管理着数百个分散在多家注册商的域名，每年续费靠人工导出表格核对，曾因邮件被忽略导致业务域名险些过期；接入接口后每月自动盘点全部域名，距到期不足 60 天即告警，续费遗漏风险清零。

一家知识产权服务商要为客户监测品牌近似域名的新注册动态，原先逐个注册局网站查询一天只能覆盖几十个；接入接口后批量定时查询，注册信息与状态实时入库，可疑域名当天即可向客户预警。

一位域名经纪人报价前要核实受托域名的注册年限与转移锁状态，多站点来回查询效率很低；现在报价工具内嵌该查询，点开域名即可看到全部关键信息，成交沟通明显提速。

常见问题

Q：为什么 registrant 经常是空的？

A：多数注册商默认开启注册人隐私保护，注册人姓名或机构不会公开，此时 registrant 返回空字符串，注册商、时间与状态等其余字段照常返回。

Q：查询失败提示未查询到注册信息是怎么回事？

A：RDAP 与 Whois 两个来源都没有取到该域名的有效记录时，接口返回参数错误（code=40002），常见原因是域名尚未注册，或该后缀暂无可查询的公开注册数据。

Q：days_to_expire 是怎么计算的？

A：按到期时间与当前 UTC 日期的天数差计算，可直接用于续费提醒；若注册数据未公开到期时间，该字段返回空串而非数字。

域名 Whois 域名查询注册信息到期提醒域名资产

接口地址： https://www.phpwc.cn/api/whois

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`domain`	string	必填	-	域名，如 example.com（不带协议与路径）

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`domain`	string	查询域名
`registrar`	string	注册商
`created_date`	string	注册时间
`expires_date`	string	到期时间
`updated_date`	string	更新时间
`status`	array	域名状态数组
`name_servers`	array	DNS 服务器数组
`registrant`	string	注册人/机构（若公开）
`days_to_expire`	int	距到期天数
`source`	string	数据来源：rdap/whois
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试