• 读取视频排行信息
    • 调用地址
    • 参数
      • 排序方式
    • 返回
      • 返回字段 “list” 子项
    • 错误代码

    读取视频排行信息

    调用地址

    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 沒有输入拼音