VPN偵測API

HackMyIP內建免費的VPN/代理/資料中心偵測API——無需API金鑰、無需註冊、已啟用CORS。它使用宣告該IP的網路（ASN、組織和託管標誌）進行分類，這與商業反詐欺評分服務的起點訊號相同。可用於標記可疑註冊、攔截濫用或豐富分析資料。完整參考見 API文件。

兩個端點，取決於查誰的IP

對呼叫方IP分類 — GET /api/score

為發起請求的IP回傳隱私評級和 VPN/資料中心/住宅 分類：

curl https://hackmyip.com/api/score

範例回應結構（worker回傳的欄位）：

{
  "success": true,
  "data": {
    "ip": "203.0.113.7",
    "location": { "city": "...", "country": "US", "timezone": "..." },
    "network": { "isp": "...", "asn": "AS...", "tls_version": "TLSv1.3" },
    "privacy": {
      "type": "datacenter",
      "score": 40,
      "grade": "C",
      "label": "...",
      "flags": ["..."],
      "is_vpn": false,
      "is_datacenter": true,
      "is_residential": false
    },
    "ipv6": false
  }
}

查詢任意IP — GET /api/lookup

對於任意IP，/api/lookup 回傳地理位置、ASN/ISP，以及 hosting/proxy/mobile 隱私標誌：

curl 'https://hackmyip.com/api/lookup?ip=8.8.8.8'

{
  "success": true,
  "data": {
    "ip": "8.8.8.8",
    "location": { "city": "...", "region": "...", "country": "US",
                  "country_name": "United States", "latitude": 0, "longitude": 0,
                  "timezone": "...", "postal_code": "..." },
    "network": { "asn": 15169, "isp": "Google LLC", "org": "..." },
    "privacy": { "hosting": true, "proxy": false, "mobile": false }
  }
}

hosting 標誌是關鍵的資料中心訊號；proxy 標記已知的匿名代理/VPN出口；mobile 標記行動電信業者IP。

程式碼範例

JavaScript (fetch)

const res = await fetch('https://hackmyip.com/api/lookup?ip=8.8.8.8');
const { data } = await res.json();
const isDatacenter = data.privacy.hosting;
const isProxy = data.privacy.proxy;
console.log(data.ip, { isDatacenter, isProxy });

Python (requests)

import requests

r = requests.get('https://hackmyip.com/api/lookup', params={'ip': '8.8.8.8'})
data = r.json()['data']
print(data['ip'], 'datacenter:', data['privacy']['hosting'],
      'proxy:', data['privacy']['proxy'])

誠實的局限

• 偵測基於網路（ASN/託管），而非深度流量檢測——架設在住宅IP上的自建VPN可能被判為住宅，而某些合法服務使用的雲端段可能被判為資料中心。請將其作為風險訊號使用。
• 標準端點的速率限制為每IP每分鐘60次請求。若一次查詢很多IP，請參見下方的批量查詢方法。

常見問題

有免費的VPN偵測API嗎？

有。HackMyIP透過其免費REST API提供VPN、代理和資料中心偵測，無需金鑰、無需註冊。GET /api/score 對呼叫方自身IP進行分類，GET /api/lookup?ip={ip} 回傳你傳入的任意IP的 hosting/proxy/mobile 標誌。

VPN/代理偵測如何運作？

分類基於宣告該IP的網路——其自治系統（ASN）、組織和託管標誌——而非即時流量分析。資料中心和託管段是VPN、代理和機器人的強訊號，而住宅ISP段表示普通使用者。這是一種啟發式判斷，因此應將其視為風險訊號而非絕對證據。

我需要API金鑰或註冊嗎？

不需要。HackMyIP的每個端點都無需金鑰、無需帳戶。已啟用CORS（Access-Control-Allow-Origin: *），可直接從瀏覽器呼叫，標準端點的速率限制為每IP每分鐘60次請求，無每日上限。