读取视频排行信息
调用地址
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 | 返回数据 |
| 返回值字段 | 字段类型 | 字段说明 |
|---|
| 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 | 沒有输入拼音 |