读取视频排行信息

调用地址

http://api.bilibili.cn/list

需要 App Key

参数

字段 必选 类型 说明
tid true int 分类编号 new排序为必填 其他为可选
exclude_tid false int 排除分类编号 不可与tid同时使用
mid false int 只显示该帐号投稿
begin false date 起始搜索日期 (格式：YYYY-mm-dd)
end false date 结束搜索日期 (格式：YYYY-mm-dd)
days false int 搜索最近天数 范围 1-90天 默认7天
page false int 结果分页选择 默认为第1页
pagesize false int 单页返回的记录条数，最大不超过100，默认为30。
pinyin true string 在使用拼音排序时必填选项 拼音首字母
click_detail false boolean 可选 返回详细点击信息
original false boolean 只返回原创投稿
mission_id false int 返回活动投稿
exclude false array 排除exclude中的id 可用,分隔多个
ver false int API版本 建议使用2
order false string 排序方式
排序方式
字段 说明
default 按新投稿排序
new 按新评论排序
review 按评论数从高至低排序
hot 按点击从高至低排序
damku 按弹幕数从高至低排序
comment 按推荐数从高至低排序
promote 按宣传数排序（硬币）
pinyin 按标题拼音排序

返回

返回值字段 字段类型 字段说明
code int 未知
name string 分类名称
num int 返回的记录总数目
results int 返回的记录总数目
pages int 返回的记录总页数
list array 返回数据
返回字段 “list” 子项
返回值字段 字段类型 字段说明
aid int 视频编号
copyright String 是否原创（Original/Copy）
typeid int 视频分类ID
typename string 视频分类名称
title string 视频标题
subtitle string 视频副标题
play int 播放次数
review int 评论数
video_review int 弹幕数
favorites int 收藏数
author string 视频作者
mid int 视频作者ID
create string 视频创建日期
description string 视频简介
pic string 封面图片地址
credit int 评分数量
coins int 推荐数量
duration string 视频时长
comment int 弹幕数(与video_review一致)

注意结尾有孤立的 num,类型int，与返回值中的int相同

错误代码

代码 说明
-601 起始日期格式错误
-602 结束日期格式错误
-603 选择的时间跨度过大
-604 沒有输入拼音