解决方案

IP查询API接口开发指南:完整代码示例(PHP / Python / JavaScript)

发布于 2026-03-08作者 xiaoxiao

摘要

IP查询API接口可以帮助开发者快速获取IP归属地信息,包括国家、省份、城市、区县以及运营商。本文提供完整IP查询API开发指南,并附PHP、Python、JavaScript调用示例。

一、什么是IP查询API接口

IP查询API是一种通过HTTP请求查询IP地址归属地信息的接口服务。开发者只需要发送一个API请求,就可以获取IP地址对应的地理位置信息,例如:

  • 国家

  • 省份

  • 城市

  • 区县

  • 运营商

  • 经纬度

例如查询IP:

 
8.8.8.8
 

返回结果:

 
美国
加利福尼亚
Google
 

这种接口非常适合开发者快速集成IP定位功能。


二、IP查询API可以获取哪些信息

一般情况下,一个完整的IP查询接口会返回以下数据:

字段 说明
ip 查询IP
country 国家
province 省份
city 城市
district 区县
isp 运营商
latitude 纬度
longitude 经度

例如返回数据:

 
{
"country":"中国",
"province":"山东",
"city":"枣庄",
"district":"滕州",
"isp":"中国联通"
}
 

通过这些信息,开发者可以分析用户所在地区。


三、IP查询API应用场景

IP地址查询接口在互联网开发中用途非常广泛。


1 网站访问统计

通过IP查询API,可以统计用户来自哪个地区。

例如统计结果:

城市 访问人数
北京 1200
上海 900
深圳 700

这些数据可以帮助网站分析用户来源。


2 广告投放

广告平台通常会根据用户IP地址判断地区,然后投放本地广告。

例如:

北京用户 → 北京广告
上海用户 → 上海广告

这样可以提高广告效果。


3 网络安全监控

IP地址查询还可以用于安全系统。

例如:

用户昨天登录:

 
北京
 

今天登录:

 
国外
 

系统就可以判断为 异常登录


4 本地服务推荐

很多网站会根据IP地址推荐本地内容,例如:

  • 本地新闻

  • 本地商家

  • 本地活动


四、IP查询API接口介绍

如果你需要使用IP查询API,可以使用下面这个接口:

 
https://v2.xxapi.cn/api/ipv2
 

接口文档:

 
https://xxapi.cn/doc/ipv2
 

该接口支持:

  • IP归属地查询

  • 城市定位

  • 区县定位

  • 运营商信息

  • 经纬度数据


五、IP查询API请求方式

请求方式:

 
GET
 

请求地址:

 
https://v2.xxapi.cn/api/ipv2
 

请求参数

参数 必填 说明
ip 查询IP地址
key API密钥

请求示例

 
https://v2.xxapi.cn/api/ipv2?ip=27.215.220.207
 

Header:

 
key: 你的apikey
 

六、IP查询API返回数据示例

接口返回JSON格式数据:

 
{
"code":200,
"msg":"数据请求成功",
"data":{
"country":"中国",
"province":"山东",
"city":"枣庄",
"district":"滕州",
"isp":"中国联通"
}
}
 

开发者只需要解析JSON即可获取IP归属地。


七、IP查询API代码示例

下面提供几个常见开发语言示例。


1 Python调用示例

 
import requests

url="https://v2.xxapi.cn/api/ipv2?ip=8.8.8.8"

headers={
"key":"你的apikey"
}

res=requests.get(url,headers=headers)

print(res.json())
 

2 PHP调用示例

 
<?php

$url="https://v2.xxapi.cn/api/ipv2?ip=8.8.8.8";

$ch=curl_init();

curl_setopt($ch,CURLOPT_URL,$url);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);

$result=curl_exec($ch);

echo $result;

?>
 

3 JavaScript调用示例

 
fetch("https://v2.xxapi.cn/api/ipv2?ip=8.8.8.8",{
headers:{
"key":"你的apikey"
}
})
.then(res=>res.json())
.then(data=>{
console.log(data)
})
 

八、IP查询API性能优势

使用API方式查询IP有很多优势。


1 数据实时更新

IP数据库经常变化,API服务通常会实时更新数据。


2 开发简单

开发者只需要发送HTTP请求即可获取数据。


3 部署成本低

无需下载IP数据库,也不需要维护服务器。


4 查询速度快

很多IP查询API采用 本地数据库缓存技术,响应速度非常快。


九、IP定位精度说明

IP地址定位精度通常分为以下级别:

精度 说明
国家级 准确率接近100%
省级 很高
城市级 较高
区县级 部分

例如查询结果:

 
山东 枣庄 滕州
 

这种就是 区县级IP定位


十、总结

IP查询API是互联网开发中非常重要的工具。通过IP地址查询接口,开发者可以快速获取用户的地理位置信息,从而实现:

  • 网站访问统计

  • 广告精准投放

  • 网络安全监控

  • 本地内容推荐

如果你需要高精度IP查询API,可以使用:

 
https://v2.xxapi.cn/api/ipv2
 

查看完整接口文档:

 
https://xxapi.cn/doc/ipv2
 

即可快速实现IP地址定位功能。

版权声明:本文内容由xiaoxiao发布,版权归原作者所有。

免责声明:如涉及版权问题,请联系我们删除。