在线 API · 私有化

IP 风险画像

给一个 IP 地址，返回它此刻的风险判断与网络、地理归属。代理、VPN、秒拨、云手机、数据中心——这些是攻击者用来隐藏自己的基础设施，而它们留在网络上的痕迹是可以被捕获的。

与传统 IP 情报库最大的不同：我们给的是一个会过期的判断，不是一个长期有效的标签。 同一个 IP，上周是代理，今天还是不是，取决于证据距今多久。

试查一个 IP →

为什么「长期标签」会让你误伤

IP 不是固定资产，它在流动。一个今天被秒拨池占用的家庭宽带地址，下周可能已经回到某个真实用户手里；一台被拿来做代理的云主机，退租之后地址会被重新分配。把这类地址长期挂着「代理」的标签，拦住的就不再是攻击者，而是接手这个地址的普通用户。

所以我们的每一条判断都带着它最后一次被观测到是什么时候。证据越旧，分数越低；过了这类风险各自的时效窗，分数归零、判断作废。 让结论自己过期，是这个产品最核心的设计。

分数是什么，不是什么

本接口的响应不含中文。地名、场景、风险类型一律以标准码或稳定 slug 返回，贵方解析层不必处理中文编码；码表见下与首页字段说明。

字段	它表示什么
`risk.score`	0–100。可核验风险证据的新鲜度与强度，随证据变旧而衰减。它不是「这个 IP 是攻击者的概率」。本产品对同一个 IP 只有这一个分：`/pulse/v1/ip` 的 `score` 与它同源同值。
`risk.level`	high / medium / low / none，由 `risk.score` 推出。 none 的意思是「我方没有当前可核验的证据」，不等于安全。
`network` / `geo`	地址归属，与 `/pulse/v1/ip` 专业档同一套形状。`network.asn` + `usage_type` 场景码；`geo` 给洲码、ISO 3166-1 国家码、经纬度与时区。中国的地址另给 `subdivision`（ISO 3166-2）与 `admin_code`（GB/T 2260 六位，到区县）；其余国家给 `region` / `city` 拉丁名。运营商名不返回，机器身份是 `asn`。
`evidence_state`	active：仍在计分的新鲜证据。stale：见过，但证据已过时效窗、分数已归零—— 可作弱特征，不宜单独作为拦截依据。none：从未见过，可能是覆盖盲区。
`tag_details[].last_seen`	该类证据最近一次捕获的时刻，RFC3339 格式并带时区偏移（如 `2026-08-20T10:51:05+08:00`）。标签可能仍在而分数已衰减到 0—— 那表示证据已过期，不表示这个 IP 干净。判定时以 last_seen 距今多久为准。
`signals.*`	布尔信号。`hosting` / `mobile` 由网络场景派生，本身不是风险；其余与 `tags` 一一对应。

0 分不等于安全

0 分只说明我方没有当前可核验的证据——可能这个地址确实干净，也可能它只是没被我们捕获过。请把它当作「没有发现」，而不是「已经排除」。策略平台应该按 evidence_state 分流，而不是只看分数。

它用在哪里

注册与登录风控

批量注册、撞库、养号，几乎都要靠代理池换 IP。在注册与异常登录环节判一次，把明显来自攻击基础设施的请求挡在外面。

营销活动与投放

领券、砍价、拉新裂变的参与来源，以及广告投放的曝光与点击来源—— 数据中心与代理占比异常，通常意味着这一批量不是真人。

内容与接口防爬

爬虫会在代理池之间轮换出口。按 IP 的风险类型与共用度分流，比单纯按频率限速更少误伤真实用户。

事后复盘与对账

一笔交易当时该不该拦，要按当时的证据判。接口支持指定时刻回溯，不用拿今天的结论去追责昨天的决定。

两种交付形态

在线 API

注册即可用，按次计费，免费额度当天生效。适合流量在自己可控范围、不介意查询走公网的场景。接入见下方。

Pulse 私有化

我方把全量情报交到贵方机器上，查询全程在贵方内网完成—— 我方不知道贵方查了哪些 IP。接口与在线版一致。了解 Pulse 私有化 →

接入

同一份画像能力，供你的风控系统直接调用。无需注册即可试用，登录后创建 Key 提额。

GEThttps://ip99.com/v1/ip/{ip}

# 直接调用，无需 Key（未登录额度）
curl https://ip99.com/v1/ip/8.8.8.8

# 带上自助创建的 Key，额度按账户计
curl -H "X-API-Key: 你的KEY" https://ip99.com/v1/ip/8.8.8.8

要查历史某个时刻的风险状态（事后复盘、对账仲裁），用 Pulse 接口的 ?at=：GET /pulse/v1/ip/{ip}?at=2026-08-26T13:34:36Z （RFC3339 时刻，可回溯 30 天，返回的 computed_at 就是你指定的那一刻）。上面这个画像接口只答此刻，不支持回溯。Pulse 接口为专业版专属：没有专业版 Key 时返回 403 professional_required，免费的基础画像仍可直接调 /v1/ip；需要历史能力请联系销售。

响应字段、额度与错误格式、以及手机号能力的接入，都在 API 接口文档一节。

覆盖与更新

10 项风险信号

代理、VPN、秒拨、劫持代理、云手机、云服务、数据中心、爬虫、情报源、移动网络。地理定位到区县级，并给出 ASN 与运营商归属。

10 秒级更新

风险数据分钟内增量、秒级落地；地理库每日重建。每次响应都带数据版本号，引用结论时可以连同版本一起留档。

联系销售

需要更高额度、私有化部署，或想先拿自己的数据跑一遍，告诉我们场景与大致量级即可。

填写联系表单 →