Super Whois — API 文档

基础 URL

GEThttps://w.ppee.eu.org/api.php

认证

该 API 无需密钥即可公开访问。使用 API Key 的请求可绕过速率限制。

GEThttps://w.ppee.eu.org/api.php?q=google.com&key=YOUR_API_KEY

如需创建 API Key，请在相同目录下新建 api_keys.php 文件：

<?php $apiKeys = [ 'sk_live_your_secret_key_here', ];

速率限制

未认证请求每小时每个 IP 最多 60 次。

响应头	说明
`X-RateLimit-Limit`	每个时间窗口的最大请求数
`X-RateLimit-Remaining`	当前窗口剩余请求数
`X-RateLimit-Reset`	时间窗口重置的 Unix 时间戳

请求参数

参数	必填	说明
`q`	必填	查询目标。支持域名（如 `google.com`）、IPv4/IPv6 地址，或 ASN（如 `AS15169`）。
`key`	可选	API Key，有效时可绕过速率限制。
`dns`	可选	设为 `true` 时在域名查询结果中附加 DNS 记录（A、AAAA、MX、TXT、NS）
`lang`	可选	文档语言：`en`（默认）、`zh-cn`（简体）或 `zh-tw`（繁体）

接口与示例

域名查询

GEThttps://w.ppee.eu.org/api.php?q=google.com

IP 查询

GEThttps://w.ppee.eu.org/api.php?q=8.8.8.8

ASN 查询

GEThttps://w.ppee.eu.org/api.php?q=AS15169

域名 + DNS 记录查询

GEThttps://w.ppee.eu.org/api.php?q=google.com&dns=true

响应字段说明

字段	类型	说明
`query`	string	经过处理的查询输入
`query_type`	string	domain \| ipv4 \| ipv6 \| asn
`status`	string	registered \| available \| found \| unsupported_tld \| error
`whois_server`	string	实际提供数据的 WHOIS 服务器
`timestamp`	ISO 8601	本次 API 响应的 UTC 时间
`query_ms`	integer	查询耗时（毫秒）
`api_version`	string	API 版本号
`data`	object	结构化解析字段（仅域名查询且已注册时返回）
`data.creation_date`	ISO 8601	域名注册日期
`data.expiration_date`	ISO 8601	域名到期日期
`data.updated_date`	ISO 8601	最后更新日期
`data.registrar`	string	注册商名称
`data.registrar_iana_id`	string	注册商 IANA 编号
`data.nameservers`	array	域名服务器列表（小写，已排序）
`data.status`	array	域名 EPP 状态码
`data.dnssec`	string	signed（已签名）或 unsigned（未签名）
`subdomain_suggestion`	string?	若查询的是子域名，建议查询的顶级域名
`raw`	string	完整原始 WHOIS 响应（IP 已脱敏）

响应示例 — `api.php?q=google.com`

{ "query": "google.com", "query_type": "domain", "whois_server": "whois.markmonitor.com", "status": "registered", "timestamp": "2025-01-15T10:23:45Z", "query_ms": 320, "api_version": "2.0", "data": { "creation_date": "1997-09-15T04:00:00Z", "expiration_date": "2028-09-14T04:00:00Z", "updated_date": "2019-09-09T15:39:04Z", "registrar": "MarkMonitor Inc.", "registrar_iana_id": "292", "registrar_whois": "whois.markmonitor.com", "nameservers": ["ns1.google.com","ns2.google.com","ns3.google.com","ns4.google.com"], "status": ["clientDeleteProhibited","clientTransferProhibited"], "dnssec": "unsigned" }, "raw": "Domain Name: GOOGLE.COM\r\n..." }

错误码

HTTP	含义
`400`	请求错误 — `q` 参数无效或缺失
`401`	未授权 — 需要 API Key 但未提供或无效
`429`	请求过频 — 超出速率限制
`500`	服务器错误 — PHP 扩展缺失或配置错误

在线测试

代码示例

JavaScript (fetch)

fetch("https:\/\/w.ppee.eu.org\/api.php?q=google.com") .then(r => r.json()) .then(data => { console.log(data.status); // "registered" console.log(data.data.registrar); // "MarkMonitor Inc." console.log(data.data.expiration_date); // "2028-09-14T04:00:00Z" });

Python (requests)

import requests resp = requests.get("https:\/\/w.ppee.eu.org\/api.php", params={'q': 'google.com'}) data = resp.json() print(data['status']) print(data['data']['registrar'])

cURL

curl "https://w.ppee.eu.org/api.php?q=google.com" | python3 -m json.tool

Super Whois API