查一個 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、歸屬地、營運商和瀏覽器資訊。嵌入程式碼與五種樣式、三種尺寸的即時預覽都在工具站。