iP助手
首页 iP 查询接口 iP 数据库格式转换
在线试用
返回结果
结果将在这里显示…
查询接口按客户端 iP 限流：每分钟最多 … 次，超出返回 429。

接口说明

所有接口均为 GET 请求，返回 application/json，无需鉴权。查询接口按客户端 iP 限流：每分钟最多 … 次，超出返回 429。以下示例中的 HOST 请替换为实际部署地址。

GET/api/v1/ip

查询单个 iP 的归属地。省略 ip 参数时，返回调用方自己的 iP（即首页“我的 iP”使用的接口）。

参数必填说明
ip否IPv4 或 IPv6 地址；留空则使用请求来源 iP
 
curl "http://HOST/api/v1/ip?ip=114.114.114.114"

{
  "ip": "114.114.114.114",
  "net": "114.114.114.114/32",
  "data": { "country": "中国", "province": "", "city": "南京", "isp": "" }
}
GET/api/v1/query

从任意文本中解析出其中的 iP / 域名并批量查询，返回结果数组。域名会先做 DNS 解析再查询归属地。

参数必填说明
text是含一个或多个 iP / 域名的文本，支持换行、空格分隔
 
curl "http://HOST/api/v1/query?text=8.8.8.8%20github.com"

{
  "items": [
    { "ip": "8.8.8.8", "net": "8.8.8.0/24", "data": { "country": "美国" } }
  ]
}

返回字段

字段说明
ip被查询的 iP 地址
net该 iP 所属网段（CIDR）
data归属地字段对象，键随所用离线库不同而不同（如 country、province、city、isp 等）

数据来源声明

本站 iP 归属地查询数据基于 ip2region 格式数据库。 ip2region 由 @lionsoul2014 开源， 采用 Apache-2.0 协议，版权归原作者所有。 数据仅供参考，不对其准确性、完整性或适用性作任何担保。