IP归属地查询 在线试调 →

查询IP的归属地: 国家/省份/城市/运营商/ISO两字母码

门槛注册即用(免费版可用)

数据离线库 ip2region(月级更新); IPv4+IPv6, 中国地区中文/海外英文

限制单次=单IP, 计量1点/次

接口说明

IP归属地查询:输入IP → 国家/省份/城市/运营商/ISO两字母码,基于离线库 ip2region(月级更新),IPv4/IPv6 双栈,单次查询微秒级。

ip 不传=按调用方出口IP查询(风控留痕/渠道识别常用姿势)

中国地区全中文,海外英文;私网/保留地址 country=Reserved

归属地是"尽力而为"的参考信息,勿用于计费或合规级判断

快速调用

同一调用的三种等价写法,按接入习惯任选其一,复制即可运行。

查询指定IP
import top369 as gp

pro = gp.pro_api("sk-xxxxxxxxxxxx")   # 安装: pip install top369

df = pro.ip_location(ip="223.5.5.5")   # → 单行DataFrame: country/province/city/isp/iso2
查询调用方IP
import top369 as gp

pro = gp.pro_api("sk-xxxxxxxxxxxx")   # 安装: pip install top369

df = pro.ip_location()   # ip省略, 服务端按来源IP查询

输入参数

名称类型必填描述
ipstr可选要查询的IP(IPv4/IPv6); 省略=调用方来源IP

返回字段

名称类型描述
ipstr实际查询的IP
versionstrIPv4/IPv6
countrystr国家(中国=中文, 海外英文)
provincestr省份/州
citystr城市
ispstr运营商/机构
iso2strISO 3166-1 两字母码
rawstr原始region串(国家|省份|城市|ISP|iso2)

返回数据样例

{
  "ip": "223.5.5.5",
  "version": "IPv4",
  "country": "中国",
  "province": "浙江省",
  "city": "杭州市",
  "isp": "阿里",
  "iso2": "CN",
  "raw": "中国|浙江省|杭州市|阿里|CN"
}

最佳实践:ip不传=按调用方出口IP查询(风控留痕/渠道识别常用); 私网与保留地址返回 country=Reserved; 数据未覆盖(如回环地址)返回404 —— 归属地是"尽力而为"的参考信息, 不要拿它做计费或合规级判断。

认证方式、代码规范、错误码等通用约定见文档首页; 可在在线测试中直接调试本接口。