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次请求，无每日上限。