IP 归属地查询

正常热门NEW

IP 归属地查询与风险分析服务，支持多语言、批量查询、CIDR 网段查询、风险画像。

协议：HTTP 格式：JSON 版本：v1.0.0日调用量：1739次

¥ 0.001 / 次

按次计费

购买次数包更优惠，低至 0.0008 元/次

100次调用包 100 次调用 ¥0.0010 /次

500次调用包 500 次调用 ¥0.00095 /次省 5%

1000次调用包 1,000 次调用 ¥0.0009 /次省 10%

推荐 5000次调用包 5,000 次调用 ¥0.00085 /次省 15%

热门 10000次调用包 10,000 次调用 ¥0.0008 /次省 20%

接口说明

查询单个 IP 的归属地信息

查询指定 IPv4 地址的归属地信息，可选返回风险画像。支持 296 种返回语言，不传 lang 时按 IP 归属国自动选择母语。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ip/query JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
ip	string	是	要查询的 IPv4 地址
lang	string	否	返回语言代码，不传则按 IP 归属国自动选择母语，支持的代码见 /langs
risk	string	否	是否附带风险信息，默认关闭；传 1 / true / yes / on 开启，开启后响应中增加 risk 字段（示例为开启时的完整结构）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.ip	string	查询的 IP 地址
data.start_ip	string	该 IP 所属网段的起始地址
data.end_ip	string	该 IP 所属网段的结束地址
data.continent	string	所属大洲
data.country	string	国家/地区名称
data.state	string	州/省
data.city	string	城市
data.local_name	string	本地语言名称
data.isp	string	网络服务提供商
data.adcode	string	中国行政区划代码，非中国 IP 为 null
data.country_en	string	国家/地区名称（英文）
data.code	string	国家/地区代码（如 US / CN）
data.lng	string	经度
data.lat	string	纬度
data.timezone	string	IANA 时区
data.utc_offset	string	UTC 时区偏移
data.ascii_name	string	地区名称的 ASCII 写法
data.population	integer	匹配城市的人口数，无数据时不返回该字段
data.distance_km	number	查询 IP 与匹配城市中心的直线距离（千米），几乎重合时不返回
data.district	string	区县
data.district_distance_km	number	查询 IP 与匹配区县中心的直线距离（千米），无数据时不返回
data.lang	string	返回内容使用的语言代码；仅在显式传 lang 且非 zh 时返回
data.district_en	string	区县（英文）；仅在 lang 为 en 等非 zh 语言且数据可用时返回
data.state_en	string	州/省（英文）；仅在 lang 为 en 等非 zh 语言且数据可用时返回
data.risk	object	风险信息，仅当 risk 参数未关闭时返回
data.risk.ip	string\|null	查询的 IP 地址；未命中风险库时为 null
data.risk.is_risky	boolean	是否命中风险库
data.risk.risk_score	integer	风险评分（0-100，越高风险越大）
data.risk.severity	string	风险等级：none 无 / low 低 / medium 中 / high 高
data.risk.severity_num	integer	风险等级数值：0 无 / 1 低 / 2 中 / 3 高
data.risk.grade	object	综合评级
data.risk.grade.grade	string	评级：A 可信 / B 低风险 / C 中等风险 / D 较高风险 / E 高风险 / F 极高风险
data.risk.grade.label	string	评级中文标签
data.risk.tags	array	命中的风险类型标签（英文标识）
data.risk.tags_zh	object	标签中文说明，键为英文标签、值为中文说明
data.risk.hit_count	integer	命中规则条数
data.risk.confidence	object	置信度
data.risk.confidence.level	string	置信等级：none / low / medium / high
data.risk.confidence.score	integer	置信评分（0-100）
data.risk.first_seen	string	最早命中时间，无记录时为 null
data.risk.last_seen	string	最近命中时间，无记录时为 null
data.risk.matched	array	命中的风险 IP 段明细（含 start_ip / end_ip / tags / severity / risk_score）
data.id	string	数据记录 ID（IP 段在库中的行标识）
data.country_xx	string	国家/地区名称的多语言字段（xx 为语言代码，如 country_ja）
data.state_xx	string	州/省名称的多语言字段（xx 为语言代码，如 state_ja）
data.city_xx	string	城市名称的多语言字段（xx 为语言代码，如 city_ja）
data.district_xx	string	区县名称的多语言字段（xx 为语言代码，如 district_ja）

请求示例

返回示例

{"msg":"success","code":200,"data":{"id":"12778922","ip":"8.8.8.8","isp":"Google LLC","lat":"37.4223","lng":"-122.085","city":"山景城","code":"US","lang":"en","risk":{"tags":[],"grade":{"grade":"A","label":"可信"},"matched":[],"tags_zh":[],"is_risky":false,"severity":"none","hit_count":0,"last_seen":null,"confidence":{"level":"none","score":0},"first_seen":null,"risk_score":0,"severity_num":0},"state":"加利福尼亚州","adcode":null,"end_ip":"8.8.8.255","country":"美国","district":"City of Palo Alto","start_ip":"8.8.8.0","state_en":"California","timezone":"America/Los_Angeles","continent":"北美洲","ascii_name":"Castro City","country_en":"United States","local_name":"California","utc_offset":"-07:00","distance_km":2.8,"district_en":"City of Palo Alto","district_distance_km":5.9}}

健康检查

服务存活探测

轻量健康检查端点，不查询数据库，可用于监控探针或调用前的连通性自检。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ip/ping JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.version	string	服务版本号
data.time	string	服务器当前时间（Y-m-d H:i:s）

请求示例

返回示例

{"msg":"success","code":200,"data":{"time":"2026-10-23 10:00:00","version":"1.0"}}

支持语言列表

返回支持的语言代码

返回服务支持的全部语言代码（共 296 种）。默认返回语言代码数组；传 detail=1 时返回含英文名与母语名的对象数组，并附带 fields 字段说明。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ip/langs JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
detail	string	否	传 1 / true / yes 时返回语言详情（代码、英文名、母语名）并附带字段说明；不传或传 0 时仅返回语言代码数组

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.count	integer	支持的语言数量
data.auto_mode	string	自动选择语言的规则说明
data.languages	array	语言列表；detail=1 时为对象数组，否则为语言代码字符串数组
data.languages[]	string	语言代码（未传 detail 时）
data.languages[].code	string	语言代码（传 detail=1 时）
data.languages[].english	string	英文语言名（传 detail=1 时）
data.languages[].native	string	母语语言名，空字符串表示暂无数据（传 detail=1 时）
data.fields	object	字段说明（仅 detail=1 时返回）
data.fields.code	string	字段说明：语言代码
data.fields.english	string	字段说明：英文语言名
data.fields.native	string	字段说明：母语语言名

请求示例

返回示例

{"msg":"success","code":200,"data":{"count":296,"auto_mode":"不传 lang 时按 IP 归属国返回该国母语 (例: 美国 IP -> 英语, 日本 IP -> 日语)","languages":["ab","ace","af"]}}

批量归属地查询

批量查询最多 10 个 IP 的归属地（超出自动截断）

批量查询多个 IPv4 地址的归属地信息，单次最多 10 个，超出直接报错（4002）。未查询到归属地的 IP 返回 found=false 且 data 为 null。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ip/batch JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
ips	string	是	多个 IPv4 地址，空格 / 逗号 / 换行分隔；缺失 → 400；去重后超过 10 个按顺序截断并返回 truncated=true（不报错）；非法项跳过并计入 invalid / invalid_count，重复项计入 duplicate_count；全部非法 → 400
lang	string	否	返回语言代码，不传则按每个 IP 归属国自动选择母语；非法值 → 400
risk	string	否	是否附带风险信息，默认关闭；传 1 / true / yes / on 开启，开启后每条记录增加 risk 字段（示例为开启时的完整结构）

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.list	array	查询结果列表
data.list[]	object	单个 IP 的查询结果
data.list[].ip	string	IP 地址
data.list[].found	boolean	是否查询到该 IP 的归属地数据
data.list[].data	object	归属地数据，found=false 时为 null
data.list[].data.start_ip	string	该 IP 所属网段的起始地址
data.list[].data.end_ip	string	该 IP 所属网段的结束地址
data.list[].data.continent	string	所属大洲
data.list[].data.country	string	国家/地区名称
data.list[].data.state	string	州/省
data.list[].data.city	string	城市
data.list[].data.local_name	string	本地语言名称
data.list[].data.isp	string	网络服务提供商
data.list[].data.adcode	string	中国行政区划代码，非中国 IP 为 null
data.list[].data.country_en	string	国家/地区名称（英文）
data.list[].data.code	string	国家/地区代码（如 US / CN）
data.list[].data.lng	string	经度
data.list[].data.lat	string	纬度
data.list[].data.timezone	string	IANA 时区
data.list[].data.utc_offset	string	UTC 时区偏移
data.list[].data.ascii_name	string	地区名称的 ASCII 写法
data.list[].data.population	integer	匹配城市的人口数，无数据时不返回该字段
data.list[].data.distance_km	number	查询 IP 与匹配城市中心的直线距离（千米），几乎重合时不返回
data.list[].data.district	string	区县
data.list[].data.district_distance_km	number	查询 IP 与匹配区县中心的直线距离（千米），无数据时不返回
data.list[].data.lang	string	返回内容使用的语言代码
data.list[].data.district_en	string	区县（英文）
data.list[].data.state_en	string	州/省（英文）
data.list[].data.risk	object	风险信息，仅当 risk 参数未关闭时返回
data.list[].data.risk.ip	string\|null	查询的 IP 地址；未命中风险库时为 null
data.list[].data.risk.is_risky	boolean	是否命中风险库
data.list[].data.risk.risk_score	integer	风险评分（0-100，越高风险越大）
data.list[].data.risk.severity	string	风险等级：none 无 / low 低 / medium 中 / high 高
data.list[].data.risk.severity_num	integer	风险等级数值：0 无 / 1 低 / 2 中 / 3 高
data.list[].data.risk.grade	object	综合评级
data.list[].data.risk.grade.grade	string	评级：A 可信 / B 低风险 / C 中等风险 / D 较高风险 / E 高风险 / F 极高风险
data.list[].data.risk.grade.label	string	评级中文标签
data.list[].data.risk.tags	array	命中的风险类型标签（英文标识）
data.list[].data.risk.tags_zh	object	标签中文说明，键为英文标签、值为中文说明
data.list[].data.risk.hit_count	integer	命中规则条数
data.list[].data.risk.confidence	object	置信度
data.list[].data.risk.confidence.level	string	置信等级：none / low / medium / high
data.list[].data.risk.confidence.score	integer	置信评分（0-100）
data.list[].data.risk.first_seen	string	最早命中时间，无记录时为 null
data.list[].data.risk.last_seen	string	最近命中时间，无记录时为 null
data.list[].data.risk.matched	array	命中的风险 IP 段明细（含 start_ip / end_ip / tags / severity / risk_score）
data.total	integer	提交的 IP 总数（去重前）
data.returned	integer	本次实际返回条数
data.found	integer	查询到归属地的 IP 数
data.max_limit	integer	单次允许查询的最大 IP 数
data.truncated	boolean	有效 IP 去重后超过 10 个时为 true，仅返回前 10 个（不报错）
data.unique	integer	去重后的有效 IPv4 数量
data.duplicate_count	integer	重复项数量
data.invalid_count	integer	非法项数量
data.invalid	array	被跳过的非法项列表

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"ip":"8.8.8.8","data":{"isp":"Google LLC","lat":"37.4223","lng":"-122.085","city":"山景城","code":"US","lang":"en","risk":{"tags":[],"grade":{"grade":"A","label":"可信"},"matched":[],"tags_zh":[],"is_risky":false,"severity":"none","hit_count":0,"last_seen":null,"confidence":{"level":"none","score":0},"first_seen":null,"risk_score":0,"severity_num":0},"state":"加利福尼亚州","adcode":null,"end_ip":"8.8.8.255","country":"美国","district":"City of Palo Alto","start_ip":"8.8.8.0","state_en":"California","timezone":"America/Los_Angeles","continent":"北美洲","ascii_name":"Castro City","country_en":"United States","local_name":"California","utc_offset":"-07:00","distance_km":2.8,"district_en":"City of Palo Alto","district_distance_km":5.9},"found":true},{"ip":"1.1.1.1","data":{"isp":"Spectrum","lat":"39.6167","lng":"-104.875","city":"格林伍德村","code":"US","lang":"en","risk":{"tags":[],"grade":{"grade":"A","label":"可信"},"matched":[],"tags_zh":[],"is_risky":false,"severity":"none","hit_count":0,"last_seen":null,"confidence":{"level":"none","score":0},"first_seen":null,"risk_score":0,"severity_num":0},"state":"科罗拉多州","adcode":null,"end_ip":"1.1.1.1","country":"美国","district":"City of Cherry Hills Village","start_ip":"1.1.1.0","state_en":"Colorado","timezone":"America/Denver","continent":"北美洲","ascii_name":"Centennial","country_en":"United States","local_name":"Colorado","population":109741,"utc_offset":"-06:00","distance_km":4.2,"district_en":"City of Cherry Hills Village","district_distance_km":6.7},"found":true}],"found":2,"total":2,"unique":2,"invalid":[],"returned":2,"max_limit":10,"truncated":false,"invalid_count":0,"duplicate_count":0}}

IP 风险画像

查询单个 IP 的风险评级

查询指定 IPv4 地址的风险画像，返回风险评分、综合评级、命中标签与置信度。未命中风险库时返回 is_risky=false、risk_score=0、grade=A（可信）。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ip/risk JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
ip	string	是	要检测的 IPv4 地址
type	string	否	按风险类型过滤：proxy 代理/匿名 / attack 攻击源 / spam 垃圾信息 / datadir 数据中心；不传则返回全部类型

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.ip	string\|null	查询的 IP 地址；未命中风险库时为 null
data.is_risky	boolean	是否命中风险库
data.risk_score	integer	风险评分（0-100，越高风险越大）
data.severity	string	风险等级：none 无 / low 低 / medium 中 / high 高
data.severity_num	integer	风险等级数值：0 无 / 1 低 / 2 中 / 3 高
data.grade	object	综合评级
data.grade.grade	string	评级：A 可信 / B 低风险 / C 中等风险 / D 较高风险 / E 高风险 / F 极高风险
data.grade.label	string	评级中文标签
data.tags	array	命中的风险类型标签（英文标识）
data.tags_zh	object	标签中文说明，键为英文标签、值为中文说明
data.hit_count	integer	命中规则条数
data.confidence	object	置信度
data.confidence.level	string	置信等级：none / low / medium / high
data.confidence.score	integer	置信评分（0-100）
data.first_seen	string	最早命中时间，无记录时为 null
data.last_seen	string	最近命中时间，无记录时为 null
data.matched	array	命中的风险 IP 段明细（含 start_ip / end_ip / tags / severity / risk_score）

请求示例

返回示例

{"msg":"success","code":200,"data":{"tags":[],"grade":{"grade":"A","label":"可信"},"matched":[],"tags_zh":[],"is_risky":false,"severity":"none","hit_count":0,"last_seen":null,"confidence":{"level":"none","score":0},"first_seen":null,"risk_score":0,"severity_num":0}}

批量风险检测

批量检测最多 10 个 IP 的风险（超出自动截断）

批量检测多个 IPv4 地址的风险画像，单次最多 10 个，超出直接报错（4002）。返回逐条结果与各评级的 IP 数量汇总。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ip/risk-batch JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
ips	string	是	多个 IPv4 地址，空格 / 逗号 / 换行分隔；缺失 → 400；去重后超过 10 个按顺序截断并返回 truncated=true（不报错）；非法项跳过并计入 invalid / invalid_count，重复项计入 duplicate_count；全部非法 → 400
type	string	否	按风险类型过滤：proxy 代理/匿名 / attack 攻击源 / spam 垃圾信息 / datadir 数据中心；不传则统计全部类型

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	提交的 IP 总数（去重前）
data.returned	integer	本次实际检测的 IP 数
data.risky	integer	命中风险库的 IP 数
data.safe	integer	未命中风险库的 IP 数
data.truncated	boolean	有效 IP 去重后超过 10 个时为 true，仅返回前 10 个（不报错）
data.max_limit	integer	单次允许检测的最大 IP 数
data.type	string	本次使用的风险类型过滤，未传时为 all
data.grade_summary	object	各评级的 IP 数量汇总
data.grade_summary.A	integer	评级 A（可信）的 IP 数
data.grade_summary.B	integer	评级 B（低风险）的 IP 数
data.grade_summary.C	integer	评级 C（中等风险）的 IP 数
data.grade_summary.D	integer	评级 D（较高风险）的 IP 数
data.grade_summary.E	integer	评级 E（高风险）的 IP 数
data.grade_summary.F	integer	评级 F（极高风险）的 IP 数
data.list	array	检测结果列表
data.list[]	object	单个 IP 的风险画像
data.list[].ip	string	查询的 IP 地址
data.list[].is_risky	boolean	是否命中风险库
data.list[].risk_score	integer	风险评分（0-100，越高风险越大）
data.list[].severity	string	风险等级：none 无 / low 低 / medium 中 / high 高
data.list[].severity_num	integer	风险等级数值：0 无 / 1 低 / 2 中 / 3 高
data.list[].grade	object	综合评级
data.list[].grade.grade	string	评级：A 可信 / B 低风险 / C 中等风险 / D 较高风险 / E 高风险 / F 极高风险
data.list[].grade.label	string	评级中文标签
data.list[].tags	array	命中的风险类型标签（英文标识）
data.list[].tags_zh	object	标签中文说明，键为英文标签、值为中文说明
data.list[].hit_count	integer	命中规则条数
data.list[].confidence	object	置信度
data.list[].confidence.level	string	置信等级：none / low / medium / high
data.list[].confidence.score	integer	置信评分（0-100）
data.list[].first_seen	string	最早命中时间，无记录时为 null
data.list[].last_seen	string	最近命中时间，无记录时为 null
data.list[].matched	array	命中的风险 IP 段明细（含 start_ip / end_ip / tags / severity / risk_score）
data.unique	integer	去重后的有效 IPv4 数量
data.duplicate_count	integer	重复项数量
data.invalid_count	integer	非法项数量
data.invalid	array	被跳过的非法项列表

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"tags":[],"grade":{"grade":"A","label":"可信"},"matched":[],"tags_zh":[],"is_risky":false,"severity":"none","hit_count":0,"last_seen":null,"confidence":{"level":"none","score":0},"first_seen":null,"risk_score":0,"severity_num":0},{"tags":[],"grade":{"grade":"A","label":"可信"},"matched":[],"tags_zh":[],"is_risky":false,"severity":"none","hit_count":0,"last_seen":null,"confidence":{"level":"none","score":0},"first_seen":null,"risk_score":0,"severity_num":0}],"safe":2,"type":"all","risky":0,"total":2,"unique":2,"invalid":[],"returned":2,"max_limit":10,"truncated":false,"grade_summary":{"A":2,"B":0,"C":0,"D":0,"E":0,"F":0},"invalid_count":0,"duplicate_count":0}}

CIDR 网段风险

查询 CIDR 网段的风险分布

查询指定 CIDR 网段的风险分布，返回网段内最高风险评分、综合评级、命中标签、风险 IP 数量与占比。单个 IPv4 按 /32 处理；风险明细段最多返回 50 条。网段内无风险时仅返回 cidr、is_risky、risk_score、grade、segments、total_risky_ips、cidr_ip_count 七个字段。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ip/risk-cidr JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
cidr	string	是	CIDR 网段（如 8.8.8.0/24，前缀 0-32）；也可直接传单个 IPv4，按 /32 处理

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.cidr	string	查询的 CIDR 网段；命中风险时单 IP 会补全为 /32
data.is_risky	boolean	网段内是否存在风险 IP
data.risk_score	integer	网段内最高风险评分（0-100）
data.severity	string	网段内最高风险等级：none / low / medium / high（无风险时不返回）
data.severity_num	integer	最高风险等级数值：0-3（无风险时不返回）
data.grade	object	综合评级
data.grade.grade	string	评级：A 可信 / B 低风险 / C 中等风险 / D 较高风险 / E 高风险 / F 极高风险
data.grade.label	string	评级中文标签
data.tags	array	网段内命中的风险类型标签（英文标识，无风险时不返回）
data.tags_zh	object	标签中文说明，键为英文标签、值为中文说明（无风险时不返回）
data.hit_count	integer	命中的风险标签数（无风险时不返回）
data.confidence	object	置信度（无风险时不返回）
data.confidence.level	string	置信等级：none / low / medium / high
data.confidence.score	integer	置信评分（0-100）
data.segments	array	命中的风险 IP 段明细，最多 50 条
data.segments[].start_ip	string	风险段起始 IP
data.segments[].end_ip	string	风险段结束 IP
data.segments[].tags	array	该风险段命中的标签
data.segments[].severity	integer	该风险段的等级数值：1 低 / 2 中 / 3 高
data.segments[].risk_score	integer	该风险段的风险评分
data.segments_total	integer	命中的风险段总数（无风险时不返回）
data.segments_shown	integer	本次返回的风险段条数，最多 50（无风险时不返回）
data.total_risky_ips	integer	网段内的风险 IP 数量（风险段与网段取交集后累加）
data.cidr_ip_count	integer	网段包含的 IP 总数
data.risky_ratio	number	风险 IP 占比（0-1，保留 4 位小数；无风险时不返回）

请求示例

返回示例

{"msg":"success","code":200,"data":{"cidr":"8.8.8.0/24","grade":{"grade":"A","label":"可信"},"is_risky":false,"segments":[],"risk_score":0,"cidr_ip_count":256,"total_risky_ips":0}}

产品说明

产品概述

IP 归属地查询与风险分析服务，支持多语言、批量查询、CIDR 网段查询、风险画像。

使用场景

数据查询：快速集成 IP 归属地查询到您的应用中

业务系统：将 IP 归属地查询数据嵌入业务流程

开发工具：通过 API 接口获取网络工具数据

数据分析：基于 IP 归属地查询数据进行分析和决策

费用计算

按次计费单价

¥0.001 / 次

每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣

扣费优先级

免费额度

次数包

余额扣费

计费方式详解

1 免费额度

· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。

2 次数包

预付费购买固定调用次数，最高可省 20%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。

3 余额扣费

按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：个人版9折专业版8折企业版7折
量折扣：月付费调用 ≥1000 次享 2%、月付费调用 ≥10000 次享 5%、月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。

次数包方案

方案名称	调用次数	价格	折算单价	比按次付费节省	有效期
100次调用包	100 次	¥0.1	¥0.0010/次	-	365 天
500次调用包	500 次	¥0.475	¥0.00095/次	省5%	365 天
1000次调用包	1000 次	¥0.9	¥0.0009/次	省10%	365 天
5000次调用包	5000 次	¥4.25	¥0.00085/次	省15%	365 天
10000次调用包	10000 次	¥8	¥0.0008/次	省20%	365 天

VIP 权益对比

等级	每月免费次数	本接口月免费上限	折扣	VIP 折后单价
免费版	按接口配置	—	-	¥0.001/次
个人版	5000 次	5000 次	10%	¥0.0009/次
专业版	30000 次	30000 次	20%	¥0.0008/次
企业版推荐	200000 次	200000 次	30%	¥0.0007/次

* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。

费用计算示例

* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。

示例1：普通用户按次付费

调用 1000 次，费用 = 0.001 × 1000 = ¥1.00

示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）

调用 1000 次，折扣约 10%，费用 = 0.001 × (1 - 10%) × 1000 ≈ ¥0.90

示例3：购买「500次调用包」次数包

支付 ¥0.475，获得 500 次调用，折算单价 ¥0.00095/次

同等次数按次付费需 ¥0.50，次数包可节省 ¥0.025

错误码说明

错误码	说明	解决方案
200	请求成功	-
400000	请求参数错误	检查参数名、格式与取值
401000	认证失败	检查 Authorization: Bearer 密钥是否正确、是否过期
401002	缺少 API 认证参数	请求未携带 key，通过 URL 参数 key 或请求头 Authorization 传递密钥
402000	账户余额不足	充值后重试
403000	无访问权限	确认密钥权限、接口范围与 IP 白名单是否满足要求
404000	接口或端点不存在	检查 API 与端点的请求路径
409000	请求冲突	请稍后重试
422000	参数校验失败	检查参数格式与取值
429001	请求频率超限（QPS）	降低请求频率，或升级套餐提升额度
429002	分钟级调用频率超限	降低调用频率，或升级套餐提升额度
429003	小时级调用额度已用完	升级套餐提升额度，或整点后重试
429004	今日调用额度已用完	升级套餐提升额度，或次日重试
500000	服务器内部错误	携带响应中的 request_id 联系技术支持
502000	服务暂时不可用	稍后重试
503000	服务暂时不可用	稍后重试
504000	请求超时	稍后重试

更新日志

暂无更新日志