WHOIS 查询 API

免费的 JSON 接口，返回与网页相同的结构化数据。无需注册，请合理控制频率。

请求

GET https://www.pywhois.com/api/v1/whois/{域名 | IP | CIDR | ASN}

`raw=0`	不返回原始 RDAP / WHOIS 数据（响应更小）。
`dns=1`	域名查询时同时返回 A / AAAA / CNAME / MX / NS / TXT / CAA 解析记录。

示例

curl 'https://www.pywhois.com/api/v1/whois/google.com?raw=0'

{
  "ok": true,
  "data": {
    "type": "domain",
    "domain": "google.com",
    "registered": true,
    "registrar": "MarkMonitor Inc.",
    "created": "1997-09-15T04:00:00Z",
    "expires": "2028-09-14T04:00:00Z",
    "expires_in_days": 684,
    "status": ["client delete prohibited", "..."],
    "status_info": [{"code": "client delete prohibited", "zh": "禁止删除（注册商锁）", "level": "lock"}],
    "nameservers": ["ns1.google.com", "ns2.google.com"],
    "dnssec": "unsigned",
    "source": {"method": "rdap", "server": "rdap.verisign.com", "registrar_server": "rdap.markmonitor.com"},
    "summary": "google.com 于 1997-09-15 注册，注册商为 MarkMonitor Inc.，……",
    "fetched_at": "2026-10-30T06:15:00Z"
  }
}

字段说明

`registered`	`true` 已注册，`false` 未注册；`reserved` 为保留域名；`unverified=true` 表示仅根据 DNS 推断。
时间字段	ISO 8601，UTC。
`source.method`	`rdap`、`whois`（43 端口）、`whois-http`（网页版 WHOIS）、`dns`（仅 DNS 推断）。
IP 结果	`network`、`cidr`、`org`、`asn`、`as_org`、`rir`、`geo.location` 等。

状态码与限制

200 成功；400 输入格式错误；429 请求过于频繁（见 Retry-After）；502 上游服务不可用。
每个 IP 每分钟约 30 次未命中缓存的查询；命中缓存的查询不计入。
每个结果页也可以加 ?format=json 或 ?format=md 获取 JSON / Markdown 版本。

交互式文档（OpenAPI）：/api/docs