播放量排行统计

优质

小牛编辑

127浏览

2023-12-01

播放量排行统计

1、获取播放量排行，该接口提供一天或多天的数据查询，返回为汇总结果。地址为:

a. https://spark.bokecc.com/api/stats/playcount/sorted

需要传递以下参数：

参数	说明
userid	用户id，不可为空
top	排行榜单视频个数，即前top个。最大不超过100。
start_date	查询开始日期（含），格式为yyyy-MM-dd，不可为空
end_date	查询结束日期（含），日期不能大于今日，格式为yyyy-MM-dd，不可为空注：end_date与start_date之间的差值最多为30

返回数据video_orders包含如下字段：

字段名	说明
video_order	播放量排行信息

video_order包含如下字段：

字段名	说明
total	总播放量排行
pc	PC端播放量排行
mobile	移动端播放量排行

total,pc,mobile均包含如下字段：

字段名	说明
videoid	视频id
play_count	播放量
order	播放量排行序号
percentage	播放量占比，百分比

JSON格式的返回信息如下：

{
    "video_orders":{
        "video_order":{
            "total":[
                {
                    "videoid":"12053A1BABB7F3199C33DC5901307461",     
                    "play_count":10000,
                    "order":1,
                    "percentage":10.11
                },
                {
                    "videoid":"18F70B7D4F4683009C33DC5901307461",     
                    "play_count":5000,
                    "order":2,
                    "percentage":5.5
                },
                …
            ],
            "pc":[
                {
                    "videoid":"77439FF2F24FA9909C33DC5901307461",     
                    "play_count":9000,
                    "order":1
                    "percentage":15.11
                },
                …
            ],
            "mobile":[
                {
                    "videoid":"79E1EAE99F64CCD59C33DC5901307461",   
                    "play_count":2000,
                    "order":1
                    "percentage":3.01
                },
                …
            ]
        }
    }
}

b. https://spark.bokecc.com/api/stats/playcount/sorted/v2

需要传递以下参数：

参数	说明
userid	用户id，不可为空
top	排行榜单视频个数，即前top个。最大不超过100。
start_date	查询开始日期（含），格式为yyyy-MM-dd，不可为空
end_date	查询结束日期（含），日期不能大于今日，格式为yyyy-MM-dd，不可为空注：end_date与start_date之间的差值最多为30

返回数据video_orders包含如下字段：

字段名	说明
video_order	播放量排行信息

video_order包含如下字段：

字段名	说明
total	总播放量排行
flash	Flash端视频播放量排行数据列表
pc_h5	H5-PC端视频播放量排行数据列表
android	Android端视频播放量排行数据列表
ios	iOS端视频播放量排行数据列表
mobile_h5	H5-移动端视频播放量排行数据列表

total,flash,pc_h5,android,ios,mobile_h5均包含如下字段：

字段名	说明
videoid	视频id
play_count	播放量
order	播放量排行序号
percentage	播放量占比，百分比

JSON格式的返回信息如下：

{
    "video_orders":{
        "video_order":{
            "total":[
                {
                    "videoid":"12053A1BABB7F3199C33DC5901307461",     
                    "play_count":10000,
                    "order":1,
                    "percentage":10.11
                },
                {
                    "videoid":"18F70B7D4F4683009C33DC5901307461",     
                    "play_count":5000,
                    "order":2,
                    "percentage":5.5
                },
                …
            ],
            “flash":[
                {
                    "videoid":"77439FF2F24FA9909C33DC5901307461",     
                    "play_count":9000,
                    "order":1
                    "percentage":15.11
                },
                …
            ],
             “pc_h5":[
                {
                    "videoid":"77439FF2F24FA9909C33DC5901307461",     
                    "play_count":9000,
                    "order":1
                    "percentage":15.11
                },
                …
            ],
              “android":[
                {
                    "videoid":"77439FF2F24FA9909C33DC5901307461",     
                    "play_count":9000,
                    "order":1
                    "percentage":15.11
                },
                …
            ],
              “ios":[
                {
                    "videoid":"77439FF2F24FA9909C33DC5901307461",     
                    "play_count":9000,
                    "order":1
                    "percentage":15.11
                },
                …
            ],

            “mobile_h5”:[
                {
                    "videoid":"79E1EAE99F64CCD59C33DC5901307461",   
                    "play_count":2000,
                    "order":1
                    "percentage":3.01
                },
                …
            ]
        }
    }
}