获取视频播放量排行

更新时间：2023-03-28

1. v3版本

接口描述

该接口用于获取视频播放量排行Top数据，该版本接口返回结果中增加了微信小程序终端相关的数据内容。

请求地址

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

请求方式

GET

请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

请求示例

https://spark.bokecc.com/api/stats/playcount/sorted/v3?end_date=2023-03-24&start_date=2023-03-01&top=50&userid=xxx&time=1679905471824&hash=51E21990FF63C5A183B7EF2344DE6ACA

返回数据

video_orders说明

video_order说明

total、flash、pc_h5、android、ios、mobile_h5、wechat说明

返回示例

{
    "video_orders": {
        "video_order": {
            "total": [{
                "videoid": "DCF31E34C1053175F3342D97BB1D6DF8",
                "play_count": 2300,
                "order": 2,
                "percentage": 16.57
            }],
            "flash": [{
                "videoid": "DCF31E34C1053175F3342D97BB1D6DF8",
                "play_count": 2300,
                "order": 3,
                "percentage": 16.57
            }],
            "android": [{
                "videoid": "DCF31E34C1053175F3342D97BB1D6DF8",
                "play_count": 2300,
                "order": 2,
                "percentage": 16.57
            }],
            "ios": [{
                "videoid": "DCF31E34C1053175F3342D97BB1D6DF8",
                "play_count": 2300,
                "order": 5,
                "percentage": 16.57
            }],
            "wechat": [{
                "videoid": "DCF31E34C1053175F3342D97BB1D6DF8",
                "play_count": 2300,
                "order": 10,
                "percentage": 16.57
            }],
            "pc_h5": [{
                "videoid": "DCF31E34C1053175F3342D97BB1D6DF8",
                "play_count": 2300,
                "order": 7,
                "percentage": 16.57
            }],
            "mobile_h5": [{
                "videoid": "DCF31E34C1053175F3342D97BB1D6DF8",
                "play_count": 2300,
                "order": 6,
                "percentage": 16.57
            }]
        }
    }
}

2. v2版本

接口描述

该接口用于获取视频播放量排行Top数据，该版本接口返回结果中详细区分了各播放器终端类型的数据。

请求地址

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

请求方式

GET

请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

请求示例

https://spark.bokecc.com/api/stats/playcount/sorted/v2?end_date=2016-10-19&top=100&time=1671544842258&userid=CC443A6686737xxx&hash=FF485D0514AA1629B291BBEEA79ADB85&start_date=2016-10-18

返回数据

video_orders说明

video_order说明

total、flash、pc_h5、android、ios、mobile_h5说明

返回示例

{
    "video_orders": {
        "video_order": {
            "total": [{
                "videoid": "12053A1BABB7F3199C33DC5901307461",
                "play_count": 10000,
                "order": 10,
                "percentage": 10.11
            }],
            "flash": [{
                "videoid": "77439FF2F24FA9909C33DC5901307461",
                "play_count": 9000,
                "order": 8,
                "percentage": 15.11
            }],
            "pc_h5": [{
                "videoid": "77439FF2F24FA9909C33DC5901307461",
                "play_count": 9000,
                "order": 3,
                "percentage": 15.11
            }],
            "android": [{
                "videoid": "77439FF2F24FA9909C33DC5901307461",
                "play_count": 9000,
                "order": 6,
                "percentage": 15.11
            }],
            "ios": [{
                "videoid": "77439FF2F24FA9909C33DC5901307461",
                "play_count": 9000,
                "order": 5,
                "percentage": 15.11
            }],
            "mobile_h5": [{
                "videoid": "79E1EAE99F64CCD59C33DC5901307461",
                "play_count": 2000,
                "order": 19,
                "percentage": 3.01
            }]
        }
    }
}

3. v1版本

接口描述

该接口用于获取视频播放量排行Top数据，该版本接口返回结果中只区分了PC端和移动端的数据。

请求地址

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

请求方式

GET

请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

请求示例

https://spark.bokecc.com/api/stats/playcount/sorted?end_date=2016-10-19&top=100&time=1671544842258&userid=CC443A6686737xxx&hash=FF485D0514AA1629B291BBEEA79ADB85&start_date=2016-10-18

返回数据

video_orders说明

video_order说明

total、pc、mobile说明

返回示例

{
    "video_orders": {
        "video_order": {
            "total": [{
                "videoid": "18F70B7D4F4683009C33DC5901307461",
                "play_count": 5000,
                "order": 7,
                "percentage": 5.5
            }],
            "pc": [{
                "videoid": "77439FF2F24FA9909C33DC5901307461",
                "play_count": 9000,
                "order": 3,
                "percentage": 15.11
            }],
            "mobile": [{
                "videoid": "79E1EAE99F64CCD59C33DC5901307461",
                "play_count": 2000,
                "order": 10,
                "percentage": 3.01
            }]
        }
    }
}