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

去工具站使用訪客資訊卡 →