接口线路类型一[集群IP接口-免费]
[接口地址1] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址2] :当前负载【】 接口通讯【正常

复制

测速 

[接口地址3] :当前负载【】 接口通讯【正常

复制

测速 

说明:直接访问https://api.apihz.cn/getapi.php获取当前最优接口地址,IP接口省去域名解析步骤,速度较快。集群IP接口并非永久有效,且容易遭受攻击,建议定期获取当前最优IP接口地址做容错处理,或直接使用域名接口或彩钻接口。IP直链接口CC防火墙严格。
接口线路类型二[域名接口-免费]
[接口地址] :[自动分发到集群接口均衡负载,但可能因网络运营商DNS缓存如果某个集群接口发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]

复制

测速 

接口线路类型三[超高稳定-最低24¥/月]
[彩钻接口] :[专属集群+普通集群+备用集群,自动负载均衡,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!CC防火墙宽松。]

复制

测速 

请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)

复制全部

复制参数 

[POST]请求示例(请根据开发语言自行POST)

请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。
名称 参数 必填 说明
用户IDid用户中心的数字ID,例:id=10000000
用户KEYkey用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2
指定IPip欲查询的IP,支持IPV4和IPV6,如果不填则默认为请求接口IP。例:ip=49.234.56.78
查询通道td只支持IPV4选择通道,0-2,0=接口盒子官方加多通道查询,1=1号通道,2=2号通道,在查询信息有误的情况下可以选择其他通道修正,但并不是某个通道就会一直准确,每个查询通道都会在一定程度上出现信息误差。一般默认0采用综合通道查询。例:td=1
用户IPV4uip接口调用者IPV4,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用中间件请求接口的方式使用。例:uip=123.123.123.123
返回参数说明
名称 参数 说明
状态码code200成功,400错误
消息内容msg如果状态码返回400则返回错误信息提示,200则返回位置描述。
大洲zhou大洲。
国家guo国家。
sheng省级名称。
shi市级名称。
qu区级名称。
运营商isp运营商名称。
纬度lat纬度。
经度lon经度。
国家代码guocode国家代码。
IPip被查询的IP。
内部参数td内部参数。
返回数据示例
示例:{"code":400,"msg":"查询失败,请重试。"}
示例:
{
    "code": 200,
    "zhou": "亚洲",
    "zhoucode": "AS",
    "guo": "中国",
    "guocode": "CN",
    "sheng": "四川省",
    "shengcode": "510000",
    "shi": "绵阳市",
    "shicode": "510700",
    "qu": "江油市",
    "qucode": "510781",
    "isp": "中国联通",
    "lat": "31.780729760241",
    "lon": "104.742802217388",
    "msg": "亚洲-中国-四川省-绵阳市-江油市-中国联通",
    "ip": "112.192.49.243",
    "td": "1-1"
}
更新记录
2025-04-24 14:42:18 - 全量更新接口盒子官方全球IP库,大大优化了查询逻辑,实现1毫秒级IP库查询速度,同时新增行政区划代码等返回参数。

2025-04-08 23:50:16 - 新增支持IPV6查询。

2025-04-07 19:48:30 - 新增请求参数【td】,可以选择查询通道。新增返回参数【guocode】,返回国家简称。

2025-04-05 22:21:54 - 优化接口查询通道,结合接口盒子官方库及大数据多通道查询,确保稳定性。新增返回参数【lat】纬度,【lon】经度。

2024-09-21 02:30:10 - 优化查询流程,修复某IP查询失败BUG。

2024-09-19 14:33:36 - 优化查询逻辑,提升查询速度。

2024-08-04 22:09:23 - 增加一个返回IP参数,返回被查询的IP。

2024-03-25 12:35:32 - 新增接口。

 位置坐标-查全球IP归属地-含经纬度-接口盒子官方版。-2025-04-24 14:42:18

支持IPV4和IPV6,查询归属地,包括经纬度,接口盒子官方IP库结合大数据多通道查询,稳定性高。

调用限制
单价/次 免费[无上限]
瞬时并发[单IP] 20
单日[所有用户之和] 999999999
1分钟并发[所有用户之和] 999999999
1小时并发[所有用户之和] 999999999
频次限制[注册用户] 10次/分钟|每日无上限
频次限制[钻石会员] 最高+1500次/分钟|每日无上限
调用方法
请求方式 GET/POST
返回格式 JSON
编码格式 UTF-8
调用信息
浏览量 2495
今日调用 6547
昨日调用 65996
总调用 19420643
今日排名 6
总排名 2
自检信息

自检日志

自检启用状态 已启用
自检节点 上海
自检线路 彩钻接口线路
自检时间 2025-05-08 05:20:09
自检耗时 203 毫秒
自检状态 正常
历史自检成功数 216642 次
历史自检失败数 124 次
历史自检成功率 99.94 %
今日自检成功数 84 次
今日自检失败数 0 次
今日自检成功率 100.00 %