获取播放量排行
注:该接口提供一天或多天的数据查询,目前共二个版本,最新版本为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
},
…
]
}
}
}