提出请求

必填。请在“我的产品”页面获取您的个人 API 密钥。

必填。待分类的 IPv4 地址。应作为请求 URL 的路径段进行指定，例如/api/v1/ip/185.220.101.1。

查询到的 IPv4 地址，已返回。

字符串或 null。该 IP 所属的 CIDR 范围（如已知）。

字符串。该 IP 的检测类型。

允许的值：vpn、corporate_vpn、proxy、hosting、cdn、tor、relay、residential_proxy、residential_proxy_likely、residential_proxy_mobile、datacenter_proxy、mobile_proxy、suspected_vpn、suspected_proxy、unknown。

字符串或 null。IP 的归因提供商（例如 VPN 品牌、住宅代理网络、主机服务商）。若无归因信息，则为 null。

取值范围在 [0, 1] 之间。表示分类结果的校准置信度。数值越高，表明证据越充分。

字符串。生成该记录的检测方法（例如：mslm、port_scan、proxy_enum、netflow_analysis、asn_classification）。

字符串。与源相同（旧字段，为保持向后兼容性而保留）。

字符串（ISO-8601）或空值。首次检测到该 IP 地址的时间。

字符串（ISO-8601）或空值。上次检测到该 IP 地址的时间。

整数。该 IP 地址被检测到的总次数（命中次数）。

浮点数或空值。持久性：在滚动90天观测窗口内，该IP被观测为活跃代理/VPN出口的天数占比（唯一观测天数 ÷ 90 × 100）。

High (>50) indicates a consistently active exit; low (<5) indicates sporadic or one-shot activity. Null when the result comes from a network-range detection with no per-IP observation history.

整数。该 IP 被观察到作为出口的各不同代理/VPN 网络的数量。值为 2 或更大表示该 IP 在多个商业网络中共享或被转售——这是强烈的代理信号。0表示没有按 IP 进行的枚举历史记录（仅进行范围级检测）。

取值范围在 [0, 1.5] 之间。综合证据强度得分：近期性因子 × 一致性 × 多来源加权。大于 1.0 的值表示来自多个来源且每日活跃的 IP 地址；0.0表示在点级别从未观察到。若需获得归一化的 0–1 得分，请使用min(confidence_decay, 1.0)。

字符串。基于last_seen 生成的观察过期桶，因此无需进行日期运算即可进行过滤。

允许的值：当前（过去一天内观测到的）、近期（上周）、过期（过去90天内）、冻结（超过90天前，或从未观测到）。

Boolean. True if the classification is in {vpn, vpn_concentrator, corporate_vpn, commercial_vpn, vpn_hosting} (confirmed VPN endpoints). Does not include tor, relay, suspected_vpn, or vpn_suspect — tor/relay have dedicated booleans; suspected_vpn/vpn_suspect are corroboration-only signals that do not set is_vpn. This asymmetry with is_proxy is deliberate: suspected_proxy does set is_proxy, but suspected_vpn/vpn_suspect never set is_vpn.

布尔值。如果分类属于 {proxy,datacenter_proxy,mobile_proxy,suspected_proxy} 之一，则返回 True。不包括住宅代理（参见is_residential_proxy）。若要匹配任何类型的代理，请将is_proxy 与 is_residential_proxy 结合使用（OR 运算）。

布尔值。如果该 IP 地址是 Tor 出口节点（分类为tor），则返回 true。

布尔值。如果分类为“中继”（即一种保护隐私的中继服务，例如 Apple Private Relay），则返回 true。这与is_vpn 不同：中继服务通过由提供商运营的出口路由用户流量，且用户无法选择端点。

布尔值。如果该 IP 属于某个数据中心/主机服务商，则返回 true。

布尔值。如果该 IP 地址属于内容分发网络，则返回 true。

Boolean. True if the classification is in {residential_proxy, residential_proxy_likely, residential_proxy_mobile}. Mutually exclusive with is_proxy; use the more specific booleans below to filter further.

布尔值。当分类结果等于residential_proxy时（即精度≥85%的等级）返回 true。是is_residential_proxy 的子集。

布尔值。当分类 ==residential_proxy_mobile时为真——检测到作为代理的移动运营商 IP 地址。是is_residential_proxy 的子集。

布尔值。当该 IP 地址出现在公共开放代理列表中时，返回 true。这与is_proxy 不同：每个开放代理都是代理，但大多数代理并未出现在公共列表中。

布尔值。如果该 IP 属于设备级 VPN（如 Fortinet、Pulse Secure、Cisco AnyConnect 等），则返回 true。这是is_vpn 的子标志。

[0, 100] 范围内的整数。计算方式为置信度 × 100，其中高风险分类类型会额外加10。

整数或空值。宣布该 IP 地址的自治系统编号。

字符串或 null。该 ASN 的注册组织名称。

字符串或空值。规范化的 CDN 运营商品牌（小写），例如akamai、fastly、cloudflare、aws_cloudfront。仅当分类 ==cdn 时才非空。

对象或空值。ASN 级别的滥用评分。所有套餐均可使用；高级套餐（Growth+）可获得完整细分数据：

abuse_score— 整数 0–100，表示该 ASN 的滥用级别（所有层级）。

abuse_level— 字符串：低、中、高、严重（所有级别）。

flagged_ratio— 浮点数 0.0–1.0，表示该 ASN 中被标记 IP 的比例（增长+）。

flagged_ip_count— 整数，已标记 IP 的数量（增长+）。

total_announced_ips— 整数，该 ASN 宣布的 IP 总数（包含增长部分）。

对象。附加检测信号和富集数据（所有键均为可选）：

raw_score— 数字，内部数值置信度（0–100）。

signals— 对象，检测信号（端口模式、协议等）。

dns_enrichment— 对象、DNS PTR 记录和 RDNS 历史记录。

tls_enrichment— 对象，TLS 证书分析。

对象或空值。地理数据，仅限高级套餐（Growth+）；若无观测位置数据，则为空值。键：

exit_country— 字符串或 null，表示出站 IP 的 ISO 3166-1 alpha-2 国家代码。

user_countries— 字符串数组或 null，表示观察到该 IP 地址用户所在的国家/地区。

user_country_count— 整数或空值，表示用户所在国家的不同国家数量。

observed_lat/observed_lon— 数值或空值，观测到的出口点的坐标。

observed_countries— 字符串数组，表示该汇聚点被观测到的国家。

observation_readings— 字符串或空值，关于观测数据的元数据。

2 次请求/分钟

30 次请求/分钟

100 次请求/分钟

250 次请求/分钟

500 次请求/分钟

定制服务——请联系我们。