在线 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 国家码、`region` / `city` / `district` 三个拉丁地名（键集合恒定，六个字符串键对任何地址都在：region / city 各国地址都有值，district 只有中国地址有值——英文地名库对中国收录到区县、对其它国家收录到城市；库里没有的名字给空串，不是 0）、经纬度与时区。运营商名不返回，机器身份是 `asn`。
`evidence_state`	active：仍在计分的新鲜证据。stale：见过，但证据已过时效窗、分数已归零——可作弱特征，不宜单独作为拦截依据。none：从未见过，可能是覆盖盲区。
`risk.signals`	命中的信号 slug 数组，只列命中的，按字典序；一个都没命中时这个键不出现（`risk` 只剩 `score` 与 `level`）。其中 `hosting` / `mobile` 由网络场景派生，本身不是风险；码表见接口文档；逐条证据与捕获时刻见 Pulse 接口。

0 分不等于安全

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

它用在哪里

注册与登录风控

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

营销活动与投放

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

内容与接口防爬

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

事后复盘与对账

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

两种交付形态

在线 API

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

Pulse 私有化

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

接入

同一份画像能力，供你的风控系统直接调用。无需注册即可试用，登录后创建 Key 提额。响应字段、额度与错误格式都在 API 接口文档一节；手机号风险画像见手机号风险画像。

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 天；带时区偏移时要把 + 转义成 %2B，裸写会被当成空格；返回的 computed_at 就是你指定的那一刻）。上面这个画像接口只答此刻，不支持回溯。Pulse 接口为专业版专属：没有专业版 Key 时返回 403 professional_required，免费的基础画像仍可直接调 /v1/ip；需要历史能力请联系销售。

覆盖与更新

10 项风险信号

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

10 秒级更新

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

联系销售

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

填写联系表单 →