在服务器运维、网络监控、应用开发等场景中,查询设备或服务器的公网 IP 地址及关联地理信息是常见需求。通过 API 接口实现 IP 查询,不仅能提升效率,还可灵活集成到二次开发项目中,满足个性化业务需求。本文档系统整理了国内外多个免费 IP 查询 API 接口,涵盖接口地址、访问限制、返回格式等关键信息,为开发者提供清晰的参考依据。
一、使用说明
所有接口均支持两种基础访问方式,无需复杂配置即可快速测试:
- 浏览器直接访问:将接口 URL 复制到浏览器地址栏,回车后即可查看返回结果;
- 命令行请求:在终端或命令提示符中使用
curl
命令发起请求,例如:curl https://whois.pconline.com.cn/ipJson.jsp?json=true
。
二、国内 IP 查询接口
国内接口在查询国内 IP 的地理信息(如省份、城市、运营商)时准确性更高,部分接口支持指定 IP 查询,但多数存在跨域访问限制,需注意在后端服务中调用。
提供方 | 接口地址 | 核心限制 | 返回格式示例(关键字段) | ||
---|---|---|---|---|---|
太平洋电脑网 | https://whois.pconline.com.cn/ipJson.jsp?json=true | 不支持跨域 | {"ip":"223.70.0.2","pro":"北京市","city":"北京市","addr":"北京市 移动","err":""} |
||
咪咕 | https://effic.migufun.com:8443/user/queryProvince | 不支持跨域 | {"returnCode":"000000","resultData":{"ip":"222.0.0.1","ipProvince":"北京","ipGPS":"39.93157,116.41005"}} |
||
百度云盘 | https://d.pcs.baidu.com/rest/2.0/pcs/file?method=locateupload | 不支持跨域,仅返回 IP(无地理信息) | {"client_ip":"12.25.15.3","error_code":0,"server_time":1728100504} |
||
淘宝 | https://ip.taobao.com/outGetIpInfo?accessKey=alibaba-inc&ip=114.114.114.114 | 需指定 IP,不支持跨域 | {"data":{"ip":"114.114.114.114","country":"中国","region":"江苏","city":"南京","isp":"XX"}} |
||
美团 | https://apimobile.meituan.com/locate/v2/ip/loc?client_source=yourAppKey&rgeo=true&ip=1.1.11.1 | 需指定 IP 和 AppKey,不支持跨域 | {"data":{"ip":"1.1.11.1","rgeo":{"country":"中国","province":"广东省","city":"广州"},"lat":22.856135,"lng":113.424824}} |
||
腾讯地图 | https://apis.map.qq.com/ws/location/v1/ip?key=ACEBZ-FDXWP-WFRDV-VGS5Q-S2Q5K-HQBNA(多 Key 可选,见备注) | 不支持跨域,需 Key,可指定 IP | {"status":0,"result":{"ip":"1.1.1.1","location":{"lat":-35.2667,"lng":149.1333},"ad_info":{"nation":"澳大利亚"}}} |
||
百度地图 | https://api.map.baidu.com/location/ip?ak=NRjNKoTLotrpA6bH4hUanMUbTyID1upT&coor=bd09ll(多 AK 可选,见备注) | 不支持跨域,需 AK,可指定 IP | `{“address”:”CN | 广东省 | 广州市 “,”content”:{“address_detail”:{“province”:” 广东省 “,”city”:” 广州市 “},”point”:{“x”:”113.27143134″,”y”:”23.13533631″}}}` |
腾讯视频 | https://disp-qryapi.3g.qq.com/v1/dispatch | 不支持跨域,仅返回本机 IP 及地域 | {"code":0,"ipInfo":"中国#北京市#中国移动#","extra":{"ip":"120.211.1.13"}} |
||
网易邮箱大师 | https://dashi.163.com/fgw/mailsrv-ipdetail/detail | 不支持跨域,仅返回本机 IP 及详情 | {"code":200,"result":{"ip":"120.211.11.11","country":"中国","province":"北京市","isp":"移动","timezone":"Asia/Shanghai"}} |
||
高德地图 | https://restapi.amap.com/v3/ip?key=ba5f9b69f0541123a4dbe142da230b4d(多 Key 可选,见备注) | 支持跨域,可指定 IP,单 Key 每日有频率限制 | curl https://whois.pconline.com.cn/ipJson.jsp?json=true 0 |
||
百度 | https://opendata.baidu.com/api.php?co=&resource_id=6006&oe=utf8&query=1.1.1.1 | 需指定 IP,不支持跨域 | curl https://whois.pconline.com.cn/ipJson.jsp?json=true 1 |
||
360 地图 | https://api.map.so.com/local?apikey=3a141df397801104f2bf&ad=1 | 需添加 Referer(curl https://whois.pconline.com.cn/ipJson.jsp?json=true 2),仅查本机 |
curl https://whois.pconline.com.cn/ipJson.jsp?json=true 3 |
||
中国气象局 | https://weather.cma.cn/api/now/ | 仅返回当前地域(IP 关联)天气及基础信息 | curl https://whois.pconline.com.cn/ipJson.jsp?json=true 4 |
||
中央气象台 | http://www.nmc.cn/rest/position | 不支持跨域、不支持 HTTPS,仅返回地域 | curl https://whois.pconline.com.cn/ipJson.jsp?json=true 5 |
||
央视网 | https://ip.apps.cntv.cn/whereis?client=json | 不支持跨域,仅返回 IP 及地域缩写 | curl https://whois.pconline.com.cn/ipJson.jsp?json=true 6 |
||
美图设计室 | https://webapi.designkit.com/common/ip_location | 不支持跨域 | curl https://whois.pconline.com.cn/ipJson.jsp?json=true 7 |
||
12306 | https://exservice.12306.cn/excater/bonree/grip | 不支持跨域,仅返回本机 IP | curl https://whois.pconline.com.cn/ipJson.jsp?json=true 8 |
备注:多 Key/AK 接口补充
部分地图类接口提供多个可用 Key/AK,开发者可根据需求选择:
- 腾讯地图额外 Key:2J4BZ-PBHH2-VYGU4-CODCH-C4EA2-W4BAU、RMJBZ-2IP64-CSNUJ-DLU7O-O3DF7-MMB5E、4RYBZ-4TRHF-GDOJU-NS5TO-3PIX7-LRF5F 等(共 14 个,原文已列出,可直接使用);
- 百度地图额外 AK:M4eExM3AxIcxOdnFGciErtK3、edUWu66ddGavrmj9a6vcsa75、Gwb8qTDLXEYRQeeeFoSeBBvtL4CjG0oL 等(共 10 个,原文已列出,可直接使用);
- 高德地图额外 Key:ec8838f3bf4614c5627c4266b36cc813、0a2a27ba5e33705826293c630a22d445、407cd13370e3e36bcb96759e9b08d958 等(共 13 个,原文已列出,可直接使用)。
三、其他国内备用接口
以下接口功能与上述类似,部分仅返回基础 IP 信息,可作为备用选择,具体返回格式需自行测试:
- https://b.cloud.189.cn/getWebImUrl.action
- https://data.video.iqiyi.com/v.f4v
- https://https-play-g3proxy.lecloud.com/vod/v2/
- https://r.inews.qq.com/api/ip2city?otype=json
- https://ws.qunar.com/ips.jcp
- https://ipservice.ws.126.net/locate/api/getLocByIp
- https://mail.163.com/fgw/mailsrv-ipdetail/detail(与网易邮箱大师接口重复,可忽略)
- https://d.pcs.baidu.com/rest/2.0/pcs/file?method=locateupload(与百度云盘接口重复,可忽略)
- https://api.live.bilibili.com/client/v1/Ip/getInfoNew
- https://www.uc.cn/ip
- https://10000.gd.cn/getClientIP.php
- https://vv.video.qq.com/checktime?otype=ojson
- https://webapi-pc.meitu.com/common/ip_location(与美图设计室接口功能相似)
- https://info4.video.qq.com/report
- https://portal-portm.meituan.com/sully/v2/native/api/getSourceCityCdnList
- https://httpdns.meituan.com/fetch?dm=httpdnsvip.meituan.com&appid=1
- https://exservice.12306.cn/excater/bonree/grip(与 12306 接口重复,可忽略)
- https://httpdns.kg.qq.com/api/v1/d?host=wns.kg.qq.com&sign=09f1e75d0296fc07e4aabef21cd1cc57
四、国外 IP 查询接口
国外接口更适合查询海外 IP 的地理信息(如国家、城市、ASN),部分接口仅返回 IP 地址,无额外详情。
提供方 | 接口地址 | 核心限制 | 返回格式示例(关键字段) |
---|---|---|---|
Hsselite | https://www.hsselite.com/ipinfo | 不支持跨域 | curl https://whois.pconline.com.cn/ipJson.jsp?json=true 9 |
IPIP | https://v6r.ipip.net/ | 仅返回 IP 地址(无 JSON 格式) | {"ip":"223.70.0.2","pro":"北京市","city":"北京市","addr":"北京市 移动","err":""} 0(纯文本格式) |
jsonip | http://jsonip.com | 仅返回 IP,不支持 HTTPS | {"ip":"223.70.0.2","pro":"北京市","city":"北京市","addr":"北京市 移动","err":""} 1 |
httpbin | http://httpbin.org/ip | 仅返回 IP(origin 字段),不支持 HTTPS | {"ip":"223.70.0.2","pro":"北京市","city":"北京市","addr":"北京市 移动","err":""} 2 |
ipify | https://api.ipify.org/ | 已被拦截,不建议使用 | 纯文本 IP(如{"ip":"223.70.0.2","pro":"北京市","city":"北京市","addr":"北京市 移动","err":""} 3) |
五、注意事项
- 跨域问题:多数国内接口不支持跨域,若需在前端页面中调用,需通过后端服务转发请求(如 Node.js、Java 后端作为中间层);
- 频率限制:高德地图等接口存在每日调用频率限制,生产环境需提前评估用量,或申请官方正式 Key 以提升配额;
- HTTPS 支持:中央气象台、jsonip、httpbin 等接口仅支持 HTTP,需注意数据传输安全性,避免在敏感场景使用;
- 接口稳定性:免费接口可能因服务商调整而失效,建议在项目中添加备用接口逻辑,并定期测试接口可用性;
- 合规性:使用 IP 地理信息时,需遵守《个人信息保护法》等相关法规,不得非法收集、滥用用户 IP 关联数据。
查看更多心仪的内容 按Ctrl+D收藏我们
部分内容来自于网络 如有不妥联系站长删除
本站代码模板仅供学习交流使用请勿商业运营,严禁从事违法,侵权等任何非法活动,否则后果自负!
© 版权声明
THE END
暂无评论内容