Javascript is required
API接入文档

1. 接口说明

对外提供 IP 地址查询的服务接口

2. 接口方式

接口地址:https://api.ipdatacloud.com
请求方式输出格式字符集
HTTPS GET/POSTJsonUTF-8

3. 请求说明

3.1 请求参数
字段名称字段类型是否必填字段描述备注
ipStringIP地址同时支持 IPV4 和 IPV6
keyString产品密钥根据所选产品分配,权限校验用
3.2请求实例
https://api.ipdatacloud.com/v2/query?ip=140.224.61.98&key=2ff42e7ea14811edb158

4. 输出说明

字段名称字段类型字段描述备注
codeString状态码参考附录 4.2 状态码
messageString状态信息请求成功时内容为success
dataJsonObject输出信息请求失败时内容为空,参考 4.1.1 data 输出参数
4.1 data 输出参数
4.1.1 IPv4 归属地返回字段
字段名称字段类型字段描述备注
versionStringIP 类型IPv4 或 IPv6
continentString所属七大洲
countryString国家
country_codeString国家英文简写
provinceString省份
cityString城市
districtString区县海外 IP 为空
streetString街道
multi_streetJsonObject历史街道位置详情参考multi_street说明
longitudeString经度
latitudeString纬度
area_codeString行政区码海外 IP 为空
ispString运营商
time_zoneString时区
elevationString海拔海外 IP 为空
weather_stationString气象站海外 IP 为空
zip_codeString邮编
city_codeString城市代码海外 IP 为空
4.1.2 multi_street说明
字段名称字段类型字段描述备注
lngString经度
latString纬度
provinceString省份
cityString城市
districtString区县
streetString街道
districtString区县
streetString街道
multi_streetJsonObject历史街道位置详情参考multi_street说明
longitudeString经度
latitudeString纬度
area_codeString行政代码
ispString运营商
time_zoneString时区
elevationString海拔海外 IP 为空
weather_stationString气象站海外 IP 为空
zip_codeString邮编
is_proxyString是否代理当无代理时为空
proxy_typeString代理类型详情参考proxy_type说明
city_codeString国际直拨电话和区号海外 IP 为空
asnStringasn
usage_typeString应用场景详情参考usage_type说明
risk_tagJsonObject风险标签详情参考risk_tag说明
4.1.3 IPv6 归属地返回字段
字段名称字段类型字段描述备注
versionStringIP 类型IPv4 或 IPv6
continentString所属七大洲
countryString国家
country_englishString国家英文国内 IP 为空
country_codeString国家英文简写国内 IP 为空
provinceString省份
cityString城市
districtString区县海外 IP 为空
longitudeString经度
latitudeString纬度
area_codeString行政区码海外 IP 为空
ispString运营商
time_zoneString时区
elevationString海拔海外 IP 为空
weather_stationString气象站海外 IP 为空
zip_codeString邮编
city_codeString城市代码海外 IP 为空
4.1.4 IP 应用场景返回字段
字段名称字段类型字段描述备注
ispString运营商
usage_typeString应用场景类型详情参考 usage_type 说 明
ASNStringASN号
4.1.4.1 usage_type 说明
返回参数描述备注
ANY任播网络属于数据中心的一部分,任播网络
CDN内容分发属于数据中心的一部分,内容分发网络
COM商业公司以盈利为目的的公司
DNS域名解析用户提供域名解析服务的IP
EDU教育机构学校/教育机构使用的IP
GTW企业专线固定IP,中大型公司专线上网的IP
GOV政府机构政府单位使用的IP
DYN动态IP家庭住宅用户使用的IP
IDC数据中心机房/云服务商使用的IP
IXP交换中心网络交换中心使用的IP
MOB移动网络基站出口IP(2G/3G/4G/5G)
NET基础设施网络设备骨干路由使用的IP
ORG组织机构非营利性组织机构
SAT卫星通信通过卫星上网的出口IP
BOGON保留 IP 用于确保在特定情况下,计算机或设备可以在局域网中保持相同的IP地址,而不会被分配给其他设备
AUR已分配-未路由 在网络设置中分配了IP地址,但这些IP地址不会被路由器或网络设备用于转发数据包
RNU已路由-未使用 在网络中分配了可以路由的IP地址,但目前尚未用于任何设备或通信
UND未分配 IP在特定网络中尚未被分配给任何设备或用途的IP地址
WLAWLAN 热点 无线局域网(WLAN)中的一个区域,其中提供无线网络连接,允许设备通过Wi-Fi连接到互联网或局域网
DDT专用出口 专门用于将数据从一个封闭的网络环境(如公司内部网络)安全地传输到外部网络
USE已使用在网络中已经分配给特定设备或用途的IP地址或资源
4.1.5 IP 风险画像返回字段
字段名称字段类型字段描述备注
proxyString代理类型详情参考 proxy 说 明
risk_tagJsonObject风险标签 采集 IP 在使用中疑似发 生风险行为, 详情参考risk_tag 说明
risk_scoreString风险评分 根据风险证据、风险标签、代理类型发生时间及风险类型综合评分(可根 据行业风控定制打分)
risk_levelString风险等级根据风险评分进行等级划分,(可根据行业要求定制评级)
mb_rateString秒拨概率 评估IP地址产生的网络访问是否具有秒速拨号等异常特征,提供0%至100%的数值,值越高,表明该IP地址越有可能存在秒速拨号行为
realString真人概率 判别IP流量是否由真实人类产生,0%至99%进行真人概率打分,接近0%意味着更趋近机器行为
4.1.5.1 proxy 输出参数
返回参数描述
tor代理节点快速动态变化的加密三重代理
vpn 通过使用专用线路或在现有网络上使用隧道协议创建一个虚 拟的点对点连接而形成。
proxy ⽹络代理,是⼀种特殊的⽹络服务,允许⼀个⽹络终端通过这 个服务与另⼀个⽹络终端进⾏⾮直接的连接。
relay 指示专用中继服务是否为存在于 IP 上(Apple Private Relay 等)
4.1.5.2 risk_tag输出参数
字段名称字段类型字段描述备注
labelString风险证据参考 label 说明
label_nameString风险标签名称参考 label 说明
last_timeString最近一次发生时间格式:yyyy-MM-dd HH:mm:ss
label 说明
返回参数描述备注
fraudulentSignup垃圾注册使用机器、脚本、虚假号码注册等符合风险注册特征的行为
SMSBombing短信轰炸申请短信验证码次数、频次过高
scalping黄牛使用机器、脚本、相似地址重复参与下单的行为
wool薅羊毛在营销实践中作弊、批量、重复领取优惠的行 为
spam垃圾信息 该 IP 对应的账号频繁发布垃圾信息(涉政、色情、广告等文本或图片)
abnormalNetworkDevice网络异常设备该 IP 曾被网络信息异常的设备持有使用过
tamperedDevice篡改设备 该 IP 曾被篡改设备(设备参数被篡改、改机工具等)持有使用过
fakeDevice虚假设备该 IP 曾被虚假设备(虚假设备、虚拟浏览器等)持有使用过
highRiskDevice高危设备该 IP 曾被高危设备(群控、检测绕过等)持有使用过
suspectFakeMobile疑似虚假号码该 IP 曾被疑似虚假号码持有使用过
suspectRiskStatusMobile疑似高危状态号码该 IP 曾被疑似高危状态号码持有使用过
highRiskMobile高风险手机号该 IP 曾被高风险手机号持有使用过
4.1.6 IP 代理识别返回字段
字段名称字段类型字段描述备注
is_proxyString是否代理当无代理时为空
proxyString代理类型详情参考 proxy 说明
proxy_timeString代理时间代理发生时间,无代理时为空
4.1.7 IP 真人识别
字段名称字段类型字段描述备注
mb_rateString秒拨概率 评估IP地址产生的网络访问是否具有秒速拨号等异常特征,提供0%至100%的数值,值越高,表明该IP地址越有可能存在秒速拨号行为
realString真人概率 判别IP流量是否由真实人类产生,0%至99%进行真人概率打分,接近0%意味着更趋近机器行为
asnStringASN号通过ASN号可以判断当前IP互联网提供商、IP所有者。
ispString互联网供应商 通过识别互联网提供商的IP分配情况,帮助识别用户的网络连接特征。
4.2 状态码
codemessage备注
200success请求调用成功
500失败信息请求失败原因(过期、次数不足、IP 类型错误等)
IP数据云

QQ扫一扫 免费测试

IP数据云

微信扫一扫 免费测试

19306238583(微信同号)