接口线路类型一[集群IP接口-免费]
[接口地址1]
：当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址2]
：当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址3]
：当前负载【
优】 接口通讯【
正常】
复制
测速
接口线路类型二[域名接口-免费]
[接口地址]
：[自动分发到集群接口服务器，但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]
复制
测速
接口线路类型三[超高稳定-最低24¥/月]
[彩钻接口]
：[专属集群+普通集群+备用集群，自动负载均衡，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！CC防火墙宽松。登录后购买。]
复制
测速
请求示例
[GET]请求示例：(以下为公共KEY，共享每分钟调用频次，请登录后使用自己的KEY独享频次)
复制全部
复制参数
[POST]请求示例(请根据开发语言自行POST)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。
提示：如发现接口有BUG，可加服务QQ群500700444，及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 |
参数 |
必填 |
说明 |
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 指定IP | ip | 否 | 欲查询的IP，支持IPV4和IPV6，如果不填则默认为请求接口IP。例：ip=49.234.56.78 |
| 查询通道 | td | 否 | 只支持IPV4选择通道，0-2，0=接口盒子官方加多通道查询，1=1号通道，2=2号通道，在查询信息有误的情况下可以选择其他通道修正，但并不是某个通道就会一直准确，每个查询通道都会在一定程度上出现信息误差。一般默认0采用综合通道查询。例：td=1 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。 |
返回参数说明
| 名称 |
参数 |
说明 |
| 状态码 | code | 200成功，400错误 |
| 消息内容 | msg | 如果状态码返回400则返回错误信息提示,200则返回位置描述。 |
| 大洲 | zhou | 大洲。 |
| 国家 | guo | 国家。 |
| 省 | sheng | 省级名称。 |
| 市 | shi | 市级名称。 |
| 区 | qu | 区级名称。 |
| 运营商 | isp | 运营商名称。 |
| 纬度 | lat | 纬度。 |
| 经度 | lon | 经度。 |
| 国家代码 | guocode | 国家代码。 |
| IP | ip | 被查询的IP。 |
| 内部参数 | td | 内部参数。 |
| 省级区划代码 | shengcode | 被ping方IP归属地省级区划代码。 |
| 市级区划代码 | shicode | 被ping方IP归属地市级区划代码。 |
| 区级区划代码 | qucode | 被ping方IP归属地区级区划代码。 |
返回数据示例
示例：{"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-10-10 12:20:36
