线路类型一[普通集群负载-IP接口]
线路类型二[普通集群负载-域名接口]
说明：域名接口会自动分发请求到普通集群服务器均衡负载，该域名TTL值为60秒，表示你的请求会每60秒实现自动轮换负载服务器，但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障，也可能会造成个别地区存在一定时间的故障期。
线路类型三[VIP集群负载-VIP线路接口]
说明：VIP专属大带宽服务器集群组，每次请求自动均衡负载，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！最低24¥/月，登录后购买。注：VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等，并非收费接口包月使用。
请求示例
[GET]请求示例：(以下为公共KEY，共享每分钟调用频次，请登录后使用自己的KEY独享频次)
复制全部
复制参数
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。参数内容较大的必须用POST，不能GET。
提示：如发现接口有BUG，可加服务QQ群500700444，及时向我们反馈。
提示：请求参数里的开发者ID与KEY，登录后台菜单【个人资料】里查看。
| 名称 |
参数 |
必填 |
说明 |
| 开发者ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 指定IP | ip | 否 | 欲查询的IP，如果不填则默认为请求接口IP。例：ip=49.234.56.78 |
| 国外通道 | type | 否 | 是否参考国外通道服务商数据，1=参考，2=不参考，默认2不参考速度更快，例：id=10000000 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 |
参数 |
说明 |
| 状态码 | code | 200成功，400错误 |
| 消息内容 | msg | 如果状态码返回400则返回错误信息提示,200则返回位置描述。 |
| 查询IP | ip | 查询IP |
| 通道数据 | tdnum | 本次查询结果总共参考了多少个通道服务商 |
| 首选结果集 | no1 | 首选可信度最高的查询结果集 |
| 国家 | no1.guo | 国家 |
| 省份 | no1.sheng | 省份 |
| 市级 | no1.shi | 市级 |
| 区级 | no1.qu | 区级 |
| 运营商 | no1.isp | 运营商 |
| 通道 | no1.td | 通道 |
| 备选结果集 | no2 | 备选结果。 |
返回数据示例
示例：{"code":400,"msg":"查询失败，请重试。"}
示例：
{
"code": 200,
"ip": "112.192.49.243",
"tdnum": 6,
"no1": {
"guo": "中国",
"sheng": "四川省",
"shi": "绵阳市",
"qu": "涪城区",
"isp": "联通",
"td": "2-1",
"msg": "中国-四川省-绵阳市-涪城区-联通"
},
"no2": {
"guo": "中国",
"sheng": "四川",
"shi": "绵阳",
"qu": "涪城",
"isp": "联通",
"td": "3-1",
"msg": "中国-四川-绵阳-涪城-联通"
}
}
更新记录
2026-03-24 16:37:57 - 重构了查询逻辑，采用多线程并行查询，速度较原来提升5-10倍以上。新增请求参数【type】是否参考国外通道服务商数据，1=参考，2=不参考，默认2不参考速度更快。新增返回参数【tdnum】为本次查询结果总共参考了多少个通道服务商。2026-02-28 15:32:12 - 新增接口。
位置坐标-查全球IP归属地-智能高准确版-2026-03-24 16:37:57
