名称	参数	必填	说明
用户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
用户IPV4	uip	否	接口调用者IPV4，用于后台统计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	内部参数。

返回数据示例

示例：{"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 %