批量获取3位未注册短域名免费API接口每日更新

简介: 该API可批量查询指定后缀(如.com、.cn)下47,952个3位短域名的注册状态,数据每日更新,支持POST/GET请求。返回JSON格式,含未注册域名及检测时间,助力高效抢注。需使用个人ID/KEY调用。

一、接口简介

这个API接口的核心功能是批量获取指定后缀下可注册的3位短域名。平台系统在后台实时轮询查询这些域名的注册状态,数据每日会进行约一次全量更新,确保信息的相对时效性。每个支持的域名后缀(如 .com, .cn等)下,共有 47,952 个三位组合供系统查询。

对于需要快速筛选和抢注优质域名的用户来说,这个接口是一个不可或缺的利器。

二、接口核心信息

  • 请求地址: https://cn.apihz.cn/api/wangzhan/domain3.php
  • 请求方式: POSTGET(根据开发习惯选择,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天内,可及时抢注。

五、调用示例

重要提示: 以下示例中的 idkey为公共测试凭证,频次受限。请务必替换为您在 接口盒子官网用户中心获取的独享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可以避免频次限制,享受更稳定的服务。请合理使用接口,避免对服务器造成不必要的压力。
  • 官方文档: 本文基于接口盒子官方文档编写,最新信息与更新请以 官方版权页面为准。

通过本教程,您已经可以轻松地将这个强大的免费域名查询工具集成到您的脚本或应用中,开启高效、精准的短域名发掘之旅。祝您找到心仪的域名!

目录
相关文章
|
5月前
|
网络协议 API PHP
域名WHOIS信息查询免费API使用指南
本文介绍接口盒子提供的免费域名WHOIS查询API,支持获取域名注册信息、到期时间、DNS服务器等数据。开发者可通过GET或POST请求调用,需使用用户ID和通讯秘钥认证,适用于.com、.net等顶级域名。提供PHP和Python调用示例及注意事项。
466 0
|
12天前
|
存储 自然语言处理 测试技术
一行代码,让 Elasticsearch 集群瞬间雪崩——5000W 数据压测下的性能避坑全攻略
本文深入剖析 Elasticsearch 中模糊查询的三大陷阱及性能优化方案。通过5000 万级数据量下做了高压测试,用真实数据复刻事故现场,助力开发者规避“查询雪崩”,为您的业务保驾护航。
578 32
|
5月前
|
JSON API 网络安全
通用邮箱邮件获取API教程:支持IMAP/POP3协议
本文介绍如何通过接口盒子的免费API获取邮箱邮件,支持IMAP/POP3协议,适用于QQ邮箱、网易邮箱等主流服务。内容包括接口基本信息、请求参数、返回参数、调用示例及注意事项,帮助开发者快速实现邮件读取功能。
692 7
|
11天前
|
JSON API PHP
域名注册状态查询免费API接口详细教程
本文介绍“接口盒子”提供的免费域名注册状态查询API,支持批量检测.com/.cn域名是否被注册。提供PHP和Python调用示例,含完整代码与返回参数说明,助力开发者快速集成域名查询功能,适用于品牌保护、域名投资等场景。(239字)
222 0
|
5月前
|
JSON API PHP
万年历API接口详解:精准获取指定日期信息
本文介绍接口盒子提供的万年历API,支持获取农历、节气、宜忌、星座等信息,具备完整的请求与返回示例,适用于黄历、日程管理等应用开发。
1426 0
|
5月前
|
JSON API PHP
通用图片搜索API:百度源免费接口教程
本文介绍一款基于百度图片搜索的免费API接口,由接口盒子提供。支持关键词搜索,具备详细请求与返回参数说明,并提供PHP及Python调用示例。开发者可快速集成实现图片搜索功能,适用于内容聚合、素材库建设等场景。
711 0
|
5月前
|
JSON 自然语言处理 数据挖掘
分词提取免费API使用指南:轻松实现文本关键词提取
免费中文分词关键词提取API,支持舆情分析、内容标签生成及搜索引擎优化,通过智能算法快速拆分文本关键词,适用于多种场景。
212 1
|
5月前
|
JSON API PHP
天气预报免费API接口【地址查询版】使用教程
本文介绍了如何使用中国气象局官方数据提供的免费天气预报API接口,通过省份和地点查询指定地区当日天气信息。该接口由接口盒子支持,提供JSON格式数据、GET/POST请求方式,并需注册获取用户ID和KEY进行身份验证。
2781 2
|
5月前
|
API Python
免费网络北京时间API接口
本文介绍如何通过接口盒子的免费API获取当前北京时间,支持多种格式及POST/GET请求方式。需注册账号获取ID和KEY,适用于服务器时间同步、日志记录等场景。
2313 6
|
5月前
|
JSON API PHP
ICP备案查询免费API接口使用教程
本文介绍如何通过接口盒子提供的免费API接口查询域名ICP备案信息,包含请求地址、参数说明及PHP和Python调用示例,适用于开发者快速集成备案查询功能。
475 1