开发者 API
免费、无需鉴权、支持跨域(CORS)。直接 GET 调用即可,返回 JSON。
接口列表
GET
/api/ip?ip={ip}IP 全量检测:归属地、ASN、纯净度/风险值、原生IP、适用场景、AI 可用性等
GET
/api/bgp?asn={asn}&ip={ip}BGP 路由关系:公告前缀、上游/下游 ASN(数据源 RIPEstat)
GET
/api/reverse-ip?ip={ip}IP 反查域名:同 IP 上托管的域名
调用示例
# IP 全量检测:归属地、ASN、纯净度/风险值、原生IP、适用场景、AI 可用性等
curl "https://ipok.io/api/ip?ip=1.1.1.1"
# BGP 路由关系:公告前缀、上游/下游 ASN(数据源 RIPEstat)
curl "https://ipok.io/api/bgp?asn=AS13335&ip=1.1.1.1"
# IP 反查域名:同 IP 上托管的域名
curl "https://ipok.io/api/reverse-ip?ip=1.1.1.1"主要响应字段
{
"geo": { "ip", "version", "country", "city", "asn", "asName", "isp", "lat", "lon" },
"ipType": "residential | hosting | mobile",
"risk": 0,
"signals": ["proxy", "hosting", ...],
"nativeType": "native | broadcast | unknown",
"scenarios": [{ "key": "tiktok", "stars": 3, "verdict": "try" }],
"services": [{ "key": "chatgpt", "status": "available" }],
"sources": [{ "source": "ip-api", "risk": 10, "flags": {} }],
"rdap?": { "registry", "country", "registered", "org" } // optional, omitted if RDAP unavailable
}状态码 / 错误
| 200 | 成功 |
| 400 | 请求参数错误:无效/私有 IP、缺少 ip/asn 等 |
| 502 | 上游数据源不可用或超时 |
限流与缓存
无硬性每-Key 限流;实际受上游免费数据源额度约束(部分接口已带边缘缓存)。高频或商用请自建缓存。错误响应为 { "error": "..." }。
请合理使用;高频或商用请自建缓存,避免对上游数据源造成压力。