接口调用地址
线路类型一 [普通集群负载-IP接口]
说明：直接访问 https://api.apihz.cn/getapi.php 获取当前最优IP接口地址。由普通负载集群服务器组成，通过IP接口地址调用，如果单个服务器过载可自行切换IP接口地址尝试其他负载服务器。IP并非永久固定且容易遭受攻击，平台可能不定期更换。
线路类型二 [普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三 [VIP集群负载-VIP线路接口]
说明：VIP专线在普通集群组的基础上额外增加独享大带宽集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低30¥/月，彩钻以上会员专属，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(请登录后使用自己的KEY独享频次)
复制参数
复制全部
[POST]请求示例：(请根据开发语言自行POST，参考【GET/POST教程】，或下载【超级客户端】调试。)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
提示：如发现接口有BUG，可加服务QQ群及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 | 参数 | 必填 | 说明 |
|---|---|---|---|
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 指定IP | ip | 否 | 欲查询的IP，默认为请求接口IP。例：ip=220.181.108.75 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 | 参数 | 说明 |
|---|---|---|
| 状态码 | code | 200成功，400错误 |
| 消息内容 | msg | 提示信息。 |
| 查询IP | ip | 查询IP。 |
| 反向DNS | reverse_dns | 反向DNS记录，如果未设置则查询不到，并非所有IP都会设置该记录。 |
| 是否存在反向DNS | reverse_dns_exists | 是否存在反向DNS。 |
| 是否蜘蛛 | is_bot | 是否蜘蛛，通过解析记录判断，并非所有IP都会设置反向，蜘蛛域名也可能变更，仅供参考。 |
| 双向验证结果 | verified | 双向验证，防止伪造记录。 |
| 查询耗时 | query_time | 查询耗时，单位毫秒。 |
| 查询时间 | timestamp | 缓存时间，查询记录会有1天的缓存期。 |
| 反向DNS数据集 | reverse_verification | 反向DNS数据集。 |
| 反向DNS匹配状态 | reverse_verification.match | 反向DNS匹配状态。 |
| 检测到蜘蛛 | reverse_verification.detected_bot | 检测到蜘蛛。 |
| 匹配域名 | reverse_verification.matched_pattern | 匹配域名。 |
| 蜘蛛标识符 | reverse_verification.bot_id | 蜘蛛标识符。 |
| 蜘蛛名称 | reverse_verification.bot_name | 蜘蛛名称。 |
| 正向DNS数据集 | forward_verification | 正向DNS数据集。 |
| 正向验证执行状态 | forward_verification.performed | 正向验证执行状态。 |
| 正向验证状态 | forward_verification.match | 正向验证状态。 |
| 解析IP地址 | forward_verification.forward_ips | 解析IP地址。 |
| 查询IP是否存在解析的IP | forward_verification.original_ip_in_forward_ips | 查询IP是否存在解析的IP里。 |
返回数据示例
示例：{"code":400,"msg":"查询失败，请重试。"}
示例：
{
"code": 200,
"msg": "查询成功",
"ip": "220.181.108.75",
"reverse_dns": "baiduspider-220-181-108-75.crawl.baidu.com",
"reverse_dns_exists": true,
"reverse_verification": {
"match": true,
"detected_bot": true,
"matched_pattern": ".baidu.com",
"bot_id": "baidu",
"bot_name": "Baidu"
},
"forward_verification": {
"performed": true,
"match": true,
"forward_ips": [
"220.181.108.75"],
"original_ip_in_forward_ips": true
},
"is_bot": true,
"verified": true,
"query_time": 4749.81,
"timestamp": "2025-12-08 13:29:52"
}
更新记录
