短链接

获取分组多维统计数据

吕遥
发布于 2024-12-04 00:02:20

接口功能

获取某个短链分组的多维度统计数据,对应数据报表中的24小时分布、地理位置分布、设备占比等数据。

接口地址

https://api.xiaomark.com/v2/sl/group/chart_stats/get

请求方法

POST

请求参数说明

参数名类型是否必传描述
apikeystring团队的API密钥
group_idstring分组id
start_datestring统计起始日期,不可早于365天前,按“yyyy-mm-dd”的格式传入
end_datestring统计截止日期,按“yyyy-mm-dd”的格式传入;起止日期跨度不可超过31天
exclude_botboolean是否排除机器访问,默认不排除

JSON请求示例

{
    "apikey": "5ac55544645cf99e40b14b4e78de5d90",
    "group_id": "81myhfrn",
    "start_date": "2024-11-01",
    "end_date": "2024-11-30"
}

返回数据说明

字段名类型描述
codeinteger返回码,0 代表请求成功,其他数值代表出错,详细见“返回码说明”页面
messagestring“请求成功”,或者相应的错误信息
dataobject请求成功返回的数据
    hour_statsarray<object>所选时段内的24小时分布数据
        hourinteger小时(取值范围0~23,例如,8表示8点整到9点整之间的时段)
        visit_countinteger访问次数
        visitor_countinteger访问人数
        ip_countinteger访问IP数
        visited_link_countinteger被访问短链数
        created_link_countinteger创建短链数
    top_ip_statsarray<object>所选时段内访问次数前5名的IP分布数据
        ipstringIP地址
        countinteger访问次数
    top_referer_statsarray<object>所选时段内访问次数前5名的Referer分布数据
        refererstringReferer(空字符串表示直接访问)
        countinteger访问次数
    world_statsarray<object>所选时段内各国家分布数据
        country_codestring国家代码
        countrystring国家名称
        countinteger访问次数
    china_statsarray<object>所选时段内中国各省份和地区分布数据
        regionstring省份或地区
        countinteger访问次数
    browser_statsarray<object>所选时段内浏览器分布数据
        browserstring浏览器类型("wechat" - 微信,"qq" - QQ,"tencent" - QQ浏览器,"sogou" - 搜狗浏览器,"uc" - UC浏览器,"ie" - IE,"edge" - Edge,"firefox" - Firefox,"safari" - Safari,"chrome" - Chrome,"other" - 其它)
        countinteger访问次数
    os_statsarray<object>所选时段内操作系统分布数据
        osstring操作系统类型("ios" - iOS,"android" - 安卓,"windows" - Windows,"macos" - MacOS,"linux" - Linux,"other" - 其它)
        countinteger访问次数
    device_statsarray<object>所选时段内设备分布数据
        devicestring设备类型("mobile" - 移动设备,"pc" - 电脑,"other" - 其它)
        countinteger访问次数
    network_statsarray<object>所选时段内网络分布数据
        networkstring网络类型("mobile" - 移动网络,"broadband" - 宽带网络)
        countinteger访问次数

JSON返回示例

{
    "code": 0,
    "message": "请求成功",
    "data": {
        "hour_stats": [
            {
                "hour": 0,
                "visit_count": 158,
                "visitor_count": 143,
                "ip_count": 142,
        		"visited_link_count": 3,
        		"created_link_count": 8
            },
            {
                "hour": 1,
                "visit_count": 140,
                "visitor_count": 137,
                "ip_count": 135,
        		"visited_link_count": 5,
        		"created_link_count": 12
            },
            // ... 其它小时时段
            {
                "hour": 23,
                "visit_count": 207,
                "visitor_count": 201,
                "ip_count": 200,
        		"visited_link_count": 5,
        		"created_link_count": 7
            }
        ],
        "top_ip_stats": [
            {
                "ip": "183.217.211.23",
                "count": 10
            },
            {
                "ip": "117.167.249.35",
                "count": 7
            },
            {
                "ip": "36.98.213.98",
                "count": 7
            },
            {
                "ip": "118.212.199.179",
                "count": 6
            },
            {
                "ip": "117.61.240.185",
                "count": 6
            }
        ],
        "top_referer_stats": [
            {
                "referer": "",
                "count": 1983
            },
            {
                "referer": "http://sourl.cn/PFbD3n",
                "count": 173
            },
            {
                "referer": "https://sourl.cn/TXY5nH",
                "count": 138
            },
            {
                "referer": "https://sourl.cn/BhEMSx",
                "count": 60
            },
            {
                "referer": "https://sourl.cn/AkurGq",
                "count": 46
            }
        ],
        "world_stats": [
            {
                "country_code": "CN",
                "country": "中国",
                "count": 2961
            },
            {
                "country_code": "UK",
                "country": "英国",
                "count": 19
            },
            // ... 其他国家
            {
                "country_code": "SG",
                "country": "新加坡",
                "count": 1
            }
        ],
        "china_stats": [
            {
                "region": "广东省",
                "count": 405
            },
            {
                "region": "江苏省",
                "count": 341
            },
            // ... 其他省份和地区
            {
                "region": "香港特别行政区",
                "count": 5
            }
        ],
        "browser_stats": [
            {
                "browser": "chrome",
                "count": 968
            },
            // ... 其他浏览器
            {
                "browser": "firefox",
                "count": 4
            }
        ],
        "os_stats": [
            {
                "os": "android",
                "count": 1576
            },
            // ... 其他操作系统
            {
                "os": "macos",
                "count": 33
            }
        ],
        "device_stats": [
            {
                "device": "mobile",
                "count": 2747
            },
            {
                "device": "pc",
                "count": 258
            }
        ],
        "network_stats": [
            {
                "network": "broadband",
                "count": 1542
            },
            {
                "network": "mobile",
                "count": 1463
            }
        ]
    }
}
小码至营logo