开发者 API

IP 情报，一次 REST 调用即可获取

通过简洁的 JSON API 获取地理位置、DNS 记录和代理/VPN/Tor 检测。使用 Bearer 密钥认证，即刻上线。

获取 API 密钥查看价格

Bearer 认证

在 Authorization 请求头中传递您的密钥。

宽松的额度

免费版每天 100 次，Pro 版每天 10,000 次。

简洁的 JSON

统一的 { ok, data } 响应结构和错误码。

身份验证

在您的API 密钥页面创建密钥，并以 Bearer token 形式发送。密钥仅显示一次，请妥善保存。

Authorization: Bearer mip_your_api_key

速率限制

每个响应都包含 X-RateLimit-Limit 和 X-RateLimit-Remaining。超出每日配额将返回 429 状态码及 rate_limited 错误。

接口

GET/api/v1/ip/{ip}

针对某个 IP 的地理位置查询及代理/VPN/Tor 检测。

请求

curl https://myiplocation.org/api/v1/ip/8.8.8.8 \
  -H "Authorization: Bearer mip_your_api_key"

响应

{
  "ok": true,
  "data": {
    "ip": "8.8.8.8",
    "geo": {
      "city": "Mountain View",
      "region": "California",
      "country_code": "us",
      "country_name": "United States",
      "latitude": 37.4056,
      "longitude": -122.0775,
      "timezone": "America/Los_Angeles"
    },
    "privacy": {
      "is_proxy": false,
      "is_vpn": false,
      "is_tor": false,
      "is_datacenter": true,
      "risk_score": 20,
      "data_ready": true
    }
  }
}

GET/api/v1/dns?host={host}

A、AAAA、CNAME、MX、NS、TXT 和 SOA 记录。

请求

curl "https://myiplocation.org/api/v1/dns?host=example.com" \
  -H "Authorization: Bearer mip_your_api_key"

响应

{
  "ok": true,
  "data": {
    "host": "example.com",
    "records": {
      "A": ["93.184.216.34"],
      "AAAA": [],
      "MX": [],
      "NS": ["a.iana-servers.net", "b.iana-servers.net"],
      "TXT": ["v=spf1 -all"]
    }
  }
}

GET/api/v1/proxy-check?ip={ip}

代理/VPN/Tor/数据中心判定结果及风险评分。

请求

curl "https://myiplocation.org/api/v1/proxy-check?ip=1.2.3.4" \
  -H "Authorization: Bearer mip_your_api_key"

响应

{
  "ok": true,
  "data": {
    "ip": "1.2.3.4",
    "is_proxy": false,
    "is_vpn": false,
    "is_tor": false,
    "is_datacenter": true,
    "risk_score": 25,
    "signals": ["datacenter"],
    "data_ready": true
  }
}

POST/api/v1/bulk

最多 50 个 IP 的批量地理位置及代理检测（仅限 Pro 版）。

请求

curl -X POST https://myiplocation.org/api/v1/bulk \
  -H "Authorization: Bearer mip_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1"]}'

响应

{
  "ok": true,
  "data": {
    "count": 2,
    "results": [
      { "ip": "8.8.8.8", "geo": { "country_code": "us" }, "privacy": { "is_datacenter": true } }
    ]
  }
}

错误码

状态码	代码	含义
400	invalid_input	路径/查询参数校验失败。
401	missing_key	未提供 Authorization 请求头。
401	invalid_key	密钥无效或已被撤销。
429	rate_limited	已超出每日配额。
502	resolve_failed	上游查询失败，请稍后重试。