一、接口简介
这个API接口的核心功能是批量获取指定后缀下可注册的3位短域名 。平台系统在后台实时轮询查询这些域名的注册状态，数据每日会进行约一次全量更新，确保信息的相对时效性。每个支持的域名后缀（如 .com, .cn等）下，共有 47,952 个三位组合供系统查询。
对于需要快速筛选和抢注优质域名的用户来说，这个接口是一个不可或缺的利器。
二、接口核心信息
-
• 请求地址：
https://cn.apihz.cn/api/wangzhan/domain3.php -
• 请求方式： POST 或 GET（根据开发习惯选择，GET方式在浏览器中测试更为方便）
-
• **每日调用上限：** 无上限
-
• 调用频次限制： 接口本身免费，但使用公共ID和KEY会有每分钟的共享频次限制。强烈建议注册并登录接口盒子平台，获取您自己独享的ID和KEY，以享有更高的调用频率。
三、请求参数说明
调用接口时，必须传递以下参数：
| 参数名称 | 参数 | 是否必填 | 说明与示例 |
|---|---|---|---|
| 用户ID | id |
是 | 用户中心的数字ID。例：id=10000000 |
| 用户KEY | key |
是 | 用户中心的通讯秘钥。例：key=15he5h15ty854j5sr152hs2 |
| 域名后缀 | hz |
是 | 要查询的域名后缀。支持：cn, com, net, xyz, vip, cc, top, club, shop, tv, fun。例：hz=cn |
| 页码 | page |
否 | 查询页码。每页最多返回50条记录，默认第1页，最大100页。例：page=1 |
四、返回参数说明
接口返回标准JSON格式数据，易于解析。
| 参数名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code |
200代表请求成功，400代表错误（如参数缺失、秘钥错误等）。 |
| 信息提示 | msg |
对当前状态的文字描述，例如"通讯秘钥错误"。 |
| 数据集 | domains |
包含未注册域名信息的数组。 |
| 未注册域名 | domains.domain |
具体的未被注册的域名字符串。 |
| 检测时间 | domains.time |
系统检测该域名还未被注册的时间。**数据按此时间倒序排列，越新的数据排在最前面。通常检测时间在1天内，可及时抢注。** |
五、调用示例
重要提示： 以下示例中的 id和 key为公共测试凭证，频次受限。请务必替换为您在 接口盒子官网用户中心获取的独享ID和KEY。
1. GET请求示例
直接在浏览器地址栏输入或使用任何支持GET请求的工具访问：
https://cn.apihz.cn/api/wangzhan/domain3.php?id=88888888&key=88888888&hz=cc&page=1
2. 返回数据示例
成功示例 (code: 200):
json
复制
{
"code": 200,
"domains": [
{
"domain": "0tz.cc",
"time": "2025-11-25 23:56:47"
},
{
"domain": "0tp.cc",
"time": "2025-11-25 23:56:22"
},
{
"domain": "0tn.cc",
"time": "2025-11-25 23:56:20"
},
// ... 更多数据
]
}失败示例 (code: 400):
json
复制
{
"code": 400,
"msg": "通讯秘钥错误。"
}六、程序代码调用示例
下面分别提供 PHP 和 Python 的调用代码。
PHP 调用示例
php
复制
<?php
// 配置您的独享ID和KEY
$your_id = "你的用户ID";
$your_key = "你的用户KEY";
$domain_suffix = "com"; // 想要查询的后缀
$page = 1; // 查询第几页
// 构建请求URL (GET方式)
$api_url = "https://cn.apihz.cn/api/wangzhan/domain3.php";
$request_url = $api_url . "?id=" . $your_id . "&key=" . $your_key . "&hz=" . $domain_suffix . "&page=" . $page;
// 发起GET请求
$response = file_get_contents($request_url);
// 检查请求是否成功
if ($response === FALSE) {
die("HTTP请求失败！");
}
// 解析JSON响应
$data = json_decode($response, true);
// 检查接口返回状态
if ($data['code'] == 200) {
echo "成功获取到 " . count($data['domains']) . " 个未注册域名：\n";
foreach ($data['domains'] as $domain_info) {
echo "域名: " . $domain_info['domain'] . " | 检测时间: " . $domain_info['time'] . "\n";
}
} else {
echo "接口调用错误: " . $data['msg'] . "\n";
}
?>Python 调用示例
python
下载
复制
运行
import requests
# 配置您的独享ID和KEY
your_id = "你的用户ID"
your_key = "你的用户KEY"
domain_suffix = "vip" # 想要查询的后缀
page = 1 # 查询第几页
# 构建请求参数
params = {
"id": your_id,
"key": your_key,
"hz": domain_suffix,
"page": page
}
# 请求地址
api_url = "https://cn.apihz.cn/api/wangzhan/domain3.php"
try:
# 发起GET请求
response = requests.get(api_url, params=params)
# 解析JSON响应
data = response.json()
# 检查接口返回状态
if data['code'] == 200:
domains = data['domains']
print(f"成功获取到 {len(domains)} 个未注册域名：")
for domain_info in domains:
print(f"域名: {domain_info['domain']} | 检测时间: {domain_info['time']}")
else:
print(f"接口调用错误: {data['msg']}")
except requests.exceptions.RequestException as e:
print(f"网络请求出错: {e}")
except ValueError as e:
print(f"JSON解析出错: {e}")七、总结与注意事项
-
• **数据时效性：** 接口返回的域名状态是"近实时"的，但域名注册是秒级竞争。获取列表后应尽快在正规域名注册商处尝试注册，以确认最终可用性。
-
• **安全第一：** 您的用户ID和KEY是调用凭证，请妥善保管，不要泄露或写入公开的代码仓库中。
-
• **遵守规则：** 使用独享KEY可以避免频次限制，享受更稳定的服务。请合理使用接口，避免对服务器造成不必要的压力。
-
• **官方文档：** 本文基于接口盒子官方文档编写，最新信息与更新请以 官方版权页面为准。
通过本免费API，您已经可以轻松地将这个强大的免费域名查询工具集成到您的脚本或应用中，开启高效、精准的短域名发掘之旅。祝您找到心仪的域名！