Whois 域名查询 API 接入文档whois

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

获取 API Key：登录 https://apizero.cn/account/keys

以下 5 种语言示例都是可直接运行的，只需把 YOUR_API_KEY 替换为实际 Key。

curl "https://v1.apizero.cn/api/whois?domain=baidu.com&with_raw=false&key=YOUR_API_KEY"

import requests

resp = requests.get(
    "https://v1.apizero.cn/api/whois",
    params={
    "domain": "baidu.com",
    "with_raw": "false",
    "key": "YOUR_API_KEY",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())

// Node.js 18+ / 浏览器原生 fetch
const params = new URLSearchParams({
  "domain": "baidu.com",
  "with_raw": "false",
  "key": "YOUR_API_KEY",
});

const res = await fetch(`https://v1.apizero.cn/api/whois?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://v1.apizero.cn/api/whois", nil)
	q := req.URL.Query()
	q.Set("domain", "baidu.com")
	q.Set("with_raw", "false")
	q.Set("key", "YOUR_API_KEY")
	req.URL.RawQuery = q.Encode()

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

<?php
$url = "https://v1.apizero.cn/api/whois?" . http_build_query([
    "domain" => "baidu.com",
    "with_raw" => "false",
    "key" => "YOUR_API_KEY",
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);

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

• 1.0.0(2026-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 整数）