Whois 域名查询

概述

查询域名注册信息（注册商 / 注册主体 / 创建时间 / 到期时间 / DNS 服务器 / 域名状态 / DNSSEC 等）。 • **支持所有主流 TLD**：.com / .cn / .net / .org / .io / .me / .top / .xyz 等几乎所有 ICANN 认证后缀 • **自动归一化**：传入 `https://www.baidu.com/abc` 会自动剥离为 `baidu.com` • **域名可用性检测**：未注册域名返回 is_available=true，可用于域名抢注前查询 • **到期告警**：30 天内到期返回 expiring_soon=true，便于前端高亮提示 • **域龄展示**：creation_age_text 返回「N 年 M 月」人类可读字符串 • **国内 .cn 主体中文**：whoiscx 服务对国内域名返回中文注册主体名（如「极数本源（福州）科技有限公司」） • **缓存 24h**：whois 数据年级变化，全天同一域名查询只调 1 次服务 • **修复源码 BUG**：错误响应字段是 `error` 不是 `message`，源码取错丢失了服务真实错误

鉴权

匿名每日 30 次、QPS 2；登录用户每日 100 次、QPS 5（全部免费）。命中 24h 缓存不计入服务配额。

获取 API Key：获取 API Key/account/keys

请求参数

GET · QUERY STRING · https://v1.apizero.cn/api/whois?domain=baidu.com&with_raw=false

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

返回示例

{
  "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"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/whois?domain=baidu.com&with_raw=false"

错误码

先看业务 code。HTTP 也可能不是 200。

调用限制

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

• 1.0.02026-05-07

  首次上线，对接 whoiscx.com whois 查询 修复源码 BUG：错误响应字段实际是 `error` 不是 `message`，源码取错导致永远显示默认错误吞掉服务真实错误信息 新增 expiring_soon 字段（30 天内到期），便于前端高亮提示 新增 creation_age_text 字段（如 "28 年 6 个月"），UX 友好 新增 with_raw 参数控制是否返回 3KB 原始 whois 文本（默认不返回节省传输） 错误细分：服务「域名不合法」映射为 4000 客户端错误，与服务故障 5xx 区分 Redis 24h 缓存（whois 数据年级变化，缓存命中提速 90%+） 域名格式校验加强：长度 ≤ 253、剥离 :port 后缀 is_available / is_expired / expiring_soon 改为 boolean 类型（源码用 0/1 整数）

免责声明