获取播放量排行
注：该接口提供一天或多天的数据查询，目前共二个版本，最新版本为V2：
1. v1版本
请求地址
https://spark.bokecc.com/api/stats/playcount/sorted
请求参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| userid | String | 是 | 用户id |
| top | Integer | 是 | 排行榜单视频个数，即前top个。最大不超过100。 |
| start_date | String | 是 | 查询开始日期（含），格式为yyyy-MM-dd |
| end_date | String | 是 | 查询结束日期（含），日期不能大于今日，格式为yyyy-MM-dd。 注：end_date与start_date之间的差值最多为30 |
返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| video_orders | Object | 播放量排行 |
video_orders说明
| 名称 | 类型 | 说明 |
|---|---|---|
| video_order | Array | 播放量排行信息 |
video_order说明
| 名称 | 类型 | 说明 |
|---|---|---|
| total | Array | 总播放量排行 |
| pc | Array | PC端播放量排行 |
| mobile | Array | 移动端播放量排行 |
total、pc、mobile说明
| 名称 | 类型 | 说明 |
|---|---|---|
| videoid | String | 视频id |
| play_count | Integer | 播放量 |
| order | Integer | 播放量排行序号 |
| percentage | Double | 播放量占比，百分比 |
示例
{
"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
},
…
]
}
}
}
2. v2版本
请求地址
https://spark.bokecc.com/api/stats/playcount/sorted/v2
请求参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| userid | String | 是 | 用户id |
| top | Integer | 是 | 排行榜单视频个数，即前top个。最大不超过100 |
| start_date | String | 是 | 查询开始日期（含），格式为yyyy-MM-dd |
| end_date | String | 是 | 查询结束日期（含），日期不能大于今日，格式为yyyy-MM-dd。 注：end_date与start_date之间的差值最多为30 |
返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| video_orders | Object | 播放量排行 |
video_orders说明
| 名称 | 类型 | 说明 |
|---|---|---|
| video_order | Array | 播放量排行信息 |
video_order说明
| 名称 | 类型 | 说明 |
|---|---|---|
| total | Array | 总播放量排行 |
| flash | Array | Flash端视频播放量排行数据列表 |
| pc_h5 | Array | H5-PC端视频播放量排行数据列表 |
| android | Array | Android端视频播放量排行数据列表 |
| ios | Array | iOS端视频播放量排行数据列表 |
| mobile_h5 | Array | H5-移动端视频播放量排行数据列表 |
total、flash、pc_h5、android、ios、mobile_h5说明
| 名称 | 类型 | 说明 |
|---|---|---|
| videoid | String | 视频id |
| play_count | Integer | 播放量 |
| order | Integer | 播放量排行序号 |
| percentage | Double | 播放量占比，百分比 |
示例
{
"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
},
…
]
}
}
}
