查一个 IP 地址的归属地:国家、省市、运营商、AS 号,海外另有经纬度。
| 方法与路径 | 说明 |
|---|---|
GET /v1/ip | 不带参数时查调用方自己的 IP;带 ip 参数查指定地址。支持 IPv4 与 IPv6。 |
| 参数 | 可选值 | 说明 |
|---|---|---|
ip | IPv4 / IPv6 地址 | 可选;格式不正确返回 400 |
lang | zh / en / hant / tw / hk | 可选,默认 zh;影响报错语言与国家名语言(见下方口径) |
| 返回字段 | 说明 |
|---|---|
country / country_code | 国家名与 ISO 二位代码 |
province / city | 省/州与城市;库里没有时为 null |
isp | 中国为运营商(如 电信 / 联通 / 移动,部分为机构名);海外为 ASN 组织名 |
asn | AS 号,如 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/ip | 0 | 29 |
输入 IP 点查询,或直接点查询看你自己的 IP 归属
论坛签名、博客侧栏用的动态图片:谁打开这张图,图上显示的就是谁自己的 IP 与归属地。生成器已经移到工具站——现成的图片地址、Markdown 与 BBCode 代码可以直接复制,图的大小、语言都能选。
把一小段代码贴进任何网页,就能显示访客本人的 IP、归属地、运营商和浏览器信息。嵌入代码与五种样式、三种尺寸的实时预览都在工具站。