API - 获取短链接访问数据
侯小猴
发布于 2024-08-10 12:56:28
接口地址
https://api.xiaomark.com/v1/link/stats/get
请求方法
POST
请求参数说明
参数名 | 类型 | 是否必传 | 描述 |
---|---|---|---|
apikey | string | 是 | 用户的API密钥 |
url | string | 是 | 短链接 |
start | string | 是 | 开始日期,按“yyyy-mm-dd”的格式传入 |
end | string | 是 | 结束日期,按“yyyy-mm-dd”的格式传入 |
备注:日期跨度不能超过 31 天。
请求POST数据示例
{
"apikey": "361f534e9897e75af4206ea820365fde",
"url": "https://sourl.cn/HOHzsG",
"start": "2020-10-15",
"end": "2020-10-19"
}
返回参数说明
名称 | 类型 | 描述 |
---|---|---|
code | integer | 返回码 |
message | string | 返回信息 |
data | object | 请求成功返回的数据 |
pv | integer | 总访问次数 |
uip | integer | 总访问IP数 |
uv | integer | 总访问人数 |
daily | object 数组 | 每日数据 |
weekday_stats | integer数组 | 一周分布数据(长度为7,对应周一到周日) |
hour_stats | integer数组 | 24小时分布数据(长度为24,对应0点到23点) |
top_ip_stats | object 数组 | Top 5 IP |
top_referer_stats | object 数组 | Top 5 referer |
locale_global_stats | object 数组 | 国际地区分布数据 |
locale_cn_stats | object 数组 | 中国地区分布数据 |
browser_stats | object 数组 | 浏览器分布数据 |
os_stats | object 数组 | 操作系统分布数据 |
device_stats | object 数组 | 设备类型分布数据 |
net_stats | object 数组 | 网络类型分布数据 |
daily 对象详情
名称 | 类型 | 描述 |
---|---|---|
date | String | 日期 |
pv | integer | 访问次数 |
uip | integer | 访问IP数 |
uv | integer | 访问人数 |
top_stats 对象详情
top_ip_stats, top_referer_statss 返回的对象如下:
名称 | 类型 | 描述 | 归属对象 |
---|---|---|---|
ip | String | IP | top_ip_stats |
referer | String | Referer(空字符串表示直接访问) | top_referer_statss |
cnt | integer | 计数 | 都有 |
locale_stats 对象详情
locale_global_stats 和 locale_cn_stats 返回的对象如下:
名称 | 类型 | 描述 | 归属对象 |
---|---|---|---|
locale | String | 地区 | 都有 |
cnt | integer | 计数 | 都有 |
ratio | integer | 占比 | 都有 |
xxx_stats 对象详情
browser_stats, os_stats, device_stats, net_stats 返回的对象如下:
名称 | 类型 | 描述 | 归属对象 |
---|---|---|---|
browser | String | 浏览器: wechat - 微信,qq - QQ,tencent - QQ浏览器,sogou - 搜狗浏览器,uc - UC浏览器,ie - IE,edge - Edge, chrome - Chrome,safari - Safari,firefox - Firefox,other - 其它 | browser_stats |
os | String | 操作系统:ios/android/windows/mac/linux/other | os_stats |
device | String | 设备类型:mobile/pc | device_stats |
net | String | 网络类型:mobile/broad | net_stats |
cnt | integer | 计数 | 都有 |
ratio | integer | 占比 | 都有 |
返回结果示例
{
"code": 0,
"data": {
"browser_stats": [
{
"browser": "chrome",
"cnt": 968,
"ratio": 0.32213
},
// ... 其他浏览器
{
"browser": "firefox",
"cnt": 14,
"ratio": 0.004659
}
],
"daily": [
{
"date": "2020-10-15",
"pv": 535,
"uip": 451,
"uv": 478
},
{
"date": "2020-10-16",
"pv": 709,
"uip": 575,
"uv": 593
},
{
"date": "2020-10-17",
"pv": 801,
"uip": 660,
"uv": 681
},
{
"date": "2020-10-18",
"pv": 515,
"uip": 441,
"uv": 453
},
{
"date": "2020-10-19",
"pv": 445,
"uip": 402,
"uv": 413
}
],
"device_stats": [
{
"cnt": 2747,
"device": "mobile",
"ratio": 0.914143
},
{
"cnt": 258,
"device": "pc",
"ratio": 0.085857
}
],
"hour_stats": [
158,104,62,38,34,42,36,39,83,97,108,125,166,181,174,161,147,152,151,168,152,208,212,207
],
"locale_cn_stats": [
{
"cnt": 405,
"locale": "广东",
"ratio": 0.134775
},
// ... 其他中国地区
{
"cnt": 2,
"locale": "香港",
"ratio": 0.000666
}
],
"locale_global_stats": [
{
"cnt": 2961,
"locale": "中国",
"ratio": 0.985358
},
{
"cnt": 9,
"locale": "英国",
"ratio": 0.002995
},
// ... 其他国家
{
"cnt": 1,
"locale": "新加坡",
"ratio": 0.000333
}
],
"net_stats": [
{
"cnt": 2642,
"net": "broad",
"ratio": 0.879201
},
{
"cnt": 363,
"net": "mobile",
"ratio": 0.120799
}
],
"os_stats": [
{
"cnt": 2176,
"os": "android",
"ratio": 0.724126
},
// ... 其他设备
{
"cnt": 565,
"os": "ios",
"ratio": 0.18802
}
],
"pv": 3005,
"top_ip_stats": [
{
"cnt": 10,
"ip": "183.217.211.23"
},
{
"cnt": 7,
"ip": "117.167.249.35"
},
{
"cnt": 7,
"ip": "36.98.213.98"
},
{
"cnt": 6,
"ip": "118.212.199.179"
},
{
"cnt": 6,
"ip": "117.61.240.185"
}
],
"top_referer_stats": [
{
"cnt": 269,
"referer": "https://sourl.cn/RDCzBw"
},
{
"cnt": 173,
"referer": "http://sourl.cn/PFbD3n"
},
{
"cnt": 138,
"referer": "https://sourl.cn/TXY5nH"
},
{
"cnt": 60,
"referer": "https://sourl.cn/BhEMSx"
},
{
"cnt": 46,
"referer": "https://sourl.cn/AkurGq"
}
],
"uip": 2516,
"uv": 2605,
"weekday_stats": [
445,0,0,535,709,801,515
]
},
"message": "请求成功"
}