IP Detection
VPN 偵測 API
判斷 IP 是否屬於 VPN、Tor 或其他匿名網絡。
偵測 VPN
GET/v1/vpn/{ip}
API 金鑰
參數
- ipstring路徑必填
IPv4 或 IPv6 位址。
回應欄位
- ipstring
被偵測的 IP 位址。
- isVpnboolean
僅 vpn、residential_proxy 及 tor 為 true，hosting 及 relay 一律為 false。
- isTorboolean
Tor 出口節點為 true。
- networkClassstring
residential_clean、mobile、hosting、datacenter、vpn、residential_proxy、tor、relay 或 unknown。
- anonymizedboolean
網絡隱藏了背後的使用者時為 true。託管網絡亦計算在內，已知基礎設施除外。
- providerstring | null
已知時為網絡擁有者的名稱。
- vpnProviderstring | null
vpn 地址所屬的 VPN 服務（NordVPN、Mullvad 等），已知時返回。Starter 及以上方案提供，Free 方案為 null。
- riskScoreinteger
風險分數，0 至 100。
- evidencestring[]
可選。類別所依據的訊號，例如 vpn_server_list、relay_range 或 known_infra。
- purityobject | null
評分明細：score、grade、verdict 及 deductions。所有方案均提供。
- purity.scoreinteger
純淨度分數，0 至 100。
- purity.gradestring
S+、S、A、B 或 C。
- purity.verdictstring
clean、suspect 或 dirty。
- purity.deductionsarray
從分數中扣除的分值，各附原因。
- deductionCountinteger
僅出現於鎖定（Free）回應中：被隱藏的純淨度所含扣分項數目，不含其他細節。
- lockedstring[]
在目前方案下以 null 返回的欄位路徑（以點分隔）。Starter 及以上方案不返回此欄位。
- planRequiredstring
包含被鎖定欄位的方案。Starter 及以上方案不返回此欄位。
curl https://ipscanner.io/v1/vpn/185.220.101.1 \
-H "Authorization: Bearer YOUR_API_KEY"回應
{
"ip": "185.220.101.1",
"isVpn": true,
"isTor": true,
"networkClass": "tor",
"anonymized": true,
"provider": "Tor Exit Node",
"vpnProvider": null,
"riskScore": 100,
"evidence": [
"tor_exit_list"
]
}