← API.MAO.MS 首页EN · 繁體

IP 归属查询 试验性

查一个 IP 地址的归属地:国家、省市、运营商、AS 号,海外另有经纬度。

接口

方法与路径说明
GET /v1/ip不带参数时查调用方自己的 IP;带 ip 参数查指定地址。支持 IPv4 与 IPv6。
参数可选值说明
ipIPv4 / IPv6 地址可选;格式不正确返回 400
langzh / en / hant / tw / hk可选,默认 zh;影响报错语言与国家名语言(见下方口径)
返回字段说明
country / country_code国家名与 ISO 二位代码
province / city省/州与城市;库里没有时为 null
isp中国为运营商(如 电信 / 联通 / 移动,部分为机构名);海外为 ASN 组织名
asnAS 号,如 15169
latitude / longitude近似经纬度(城市参考点),仅海外(DB-IP)结果有
is_anycast是否命中本站内置的热门任播名单(名单制:命中才标,未命中不代表不是任播;任播地址全球多点服务,归属地只是登记或参考位置)
is_private是否为私有/保留地址;这类地址没有归属地,其余字段为 null
source本次结果的数据来源:ip2region / dbip / 自有(私有、保留等本站自有判定)

返回示例

中国地址(/v1/ip?ip=223.5.5.5):

{"code":0,"message":"ok","data":{"ip":"223.5.5.5","version":4,"country":"中国","country_code":"CN","province":"浙江省","city":"杭州市","isp":"阿里","asn":37963,"latitude":null,"longitude":null,"is_anycast":false,"is_private":false,"source":"ip2region"}}

海外地址(/v1/ip?ip=8.8.8.8,任播):

{"code":0,"message":"ok","data":{"ip":"8.8.8.8","version":4,"country":"美国","country_code":"US","province":"California","city":"Mountain View","isp":"Google LLC","asn":15169,"latitude":37.422,"longitude":-122.085,"is_anycast":true,"is_private":false,"source":"dbip"}}

国家名随 lang 出中文或英文;省/市名在 DB-IP Lite 里只有英文,中国地址则由 ip2region 给出中文。

数据来源与口径

本接口由两个免费离线数据库结合提供:中国地址以 ip2region 为准,海外以 DB-IP Lite 为准,互为兜底,source 字段标明出处,两库按月更新。IP Geolocation by DB-IP(CC BY 4.0)。

精度口径:IP 归属本质是查表推断,最好到城市级,且会受 VPN、代理、运营商出口调度影响。两套免费库均为非商用级精度,本接口仅供参考。

调用统计

本组接口累计被调用 29 次 · 今日 0 次 · 全部接口统计

接口路径今日累计
IP 归属/v1/ip029

在线测试

输入 IP 点查询,或直接点查询看你自己的 IP 归属

IP 签名图

论坛签名、博客侧栏用的动态图片:谁打开这张图,图上显示的就是谁自己的 IP 与归属地。生成器已经移到工具站——现成的图片地址、Markdown 与 BBCode 代码可以直接复制,图的大小、语言都能选。

去工具站使用 IP 签名图 →

访客信息卡

把一小段代码贴进任何网页,就能显示访客本人的 IP、归属地、运营商和浏览器信息。嵌入代码与五种样式、三种尺寸的实时预览都在工具站。

去工具站使用访客信息卡 →