短链接

API - 获取短链接访问数据

侯小猴
发布于 2024-08-10 12:56:28

接口地址

https://api.xiaomark.com/v1/link/stats/get

请求方法

POST

请求参数说明

参数名类型是否必传描述
apikeystring用户的API密钥
urlstring短链接
startstring开始日期,按“yyyy-mm-dd”的格式传入
endstring结束日期,按“yyyy-mm-dd”的格式传入

备注:日期跨度不能超过 31 天。

请求POST数据示例

{
            "apikey": "361f534e9897e75af4206ea820365fde",
            "url": "https://sourl.cn/HOHzsG",
            "start": "2020-10-15",
            "end": "2020-10-19"
        }

示例图

返回参数说明

名称类型描述
codeinteger返回码
messagestring返回信息
dataobject请求成功返回的数据
pvinteger总访问次数
uipinteger总访问IP数
uvinteger总访问人数
dailyobject 数组每日数据
weekday_statsinteger数组一周分布数据(长度为7,对应周一到周日)
hour_statsinteger数组24小时分布数据(长度为24,对应0点到23点)
top_ip_statsobject 数组Top 5 IP
top_referer_statsobject 数组Top 5 referer
locale_global_statsobject 数组国际地区分布数据
locale_cn_statsobject 数组中国地区分布数据
browser_statsobject 数组浏览器分布数据
os_statsobject 数组操作系统分布数据
device_statsobject 数组设备类型分布数据
net_statsobject 数组网络类型分布数据

daily 对象详情

名称类型描述
dateString日期
pvinteger访问次数
uipinteger访问IP数
uvinteger访问人数

top_stats 对象详情

top_ip_stats, top_referer_statss 返回的对象如下:

名称类型描述归属对象
ipStringIPtop_ip_stats
refererStringReferer(空字符串表示直接访问)top_referer_statss
cntinteger计数都有

locale_stats 对象详情

locale_global_stats 和 locale_cn_stats 返回的对象如下:

名称类型描述归属对象
localeString地区都有
cntinteger计数都有
ratiointeger占比都有

xxx_stats 对象详情

browser_stats, os_stats, device_stats, net_stats 返回的对象如下:

名称类型描述归属对象
browserString浏览器: wechat - 微信,qq - QQ,tencent - QQ浏览器,sogou - 搜狗浏览器,uc - UC浏览器,ie - IE,edge - Edge, chrome - Chrome,safari - Safari,firefox - Firefox,other - 其它browser_stats
osString操作系统:ios/android/windows/mac/linux/otheros_stats
deviceString设备类型:mobile/pcdevice_stats
netString网络类型:mobile/broadnet_stats
cntinteger计数都有
ratiointeger占比都有

返回结果示例

{
            "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": "请求成功"
        }
        
小码至营logo