├── API.author_recommend.md ├── API.bangumi.md ├── API.comment.md ├── API.dynamic.md ├── API.favourite.md ├── API.feedback.md ├── API.friend.md ├── API.history.md ├── API.index.md ├── API.list.md ├── API.log.md ├── API.login.3rd.md ├── API.login.md ├── API.myinfo.md ├── API.notify.md ├── API.recommend.md ├── API.search.md ├── API.sp.md ├── API.spview.md ├── API.suggest.md ├── API.tags.md ├── API.userinfo.md ├── API.view.md ├── CONST.typeid.md └── README.md /API.author_recommend.md: -------------------------------------------------------------------------------- 1 | ## 读取作者推荐视频 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/author_recommend 6 | 7 | #### 参数 8 | 9 | |字段|必选|类型|说明| 10 | |----|----|----|----| 11 | |aid|true|int|视频ID| 12 | 13 | #### 返回 14 | 15 | |返回值字段|字段类型|字段说明| 16 | |----------|--------|--------| 17 | |list|array|返回数据| 18 | |code|int|状态代码| 19 | 20 | ##### 返回字段 "list" 子项 21 | 22 | |返回值字段|字段类型|字段说明| 23 | |----------|--------|--------| 24 | |aid|int|视频编号| 25 | |title|string|视频标题| 26 | |cover|string|封面图片地址| 27 | |click|int|点击| 28 | |review|int|评论| 29 | |favorites|int|收藏| 30 | |video_review|int|弹幕| 31 | -------------------------------------------------------------------------------- /API.bangumi.md: -------------------------------------------------------------------------------- 1 | ## 读取番剧专题信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/bangumi 6 | 7 | 需要 App Key 8 | 9 | #### 参数 10 | 11 | |字段|必选|类型|说明| 12 | |----|----|----|----| 13 | |btype|false|int|番剧类型 2:二次元新番 3:三次元新番 默认:所有| 14 | |weekday|false|int|周日:0 周一:1 周二:2 周三:3 依此类推| 15 | 16 | #### 返回 17 | 18 | |返回值字段|字段类型|字段说明| 19 | |----------|--------|--------| 20 | |results|int|返回的记录总数目| 21 | |list|array|返回数据| 22 | 23 | ##### 返回字段 "list" 子项 24 | 25 | |返回值字段|字段类型|字段说明| 26 | |----------|--------|--------| 27 | |title|string|标题| 28 | |cover|string|封面图片地址| 29 | |bgmcount|int|番剧当前总集数| 30 | |weekday|int|番剧周信息| 31 | |lastupdate|int|最后更新时间(UNIX Timestamp)| 32 | |lastupdate_at|date|最后更新时间| 33 | |new|boolean|是否最近有更新| 34 | -------------------------------------------------------------------------------- /API.comment.md: -------------------------------------------------------------------------------- 1 | ## 发布弹幕 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/comment/post 6 | 7 | 需要 App Key 并验证登录状态(Access key)；要求应用申请弹幕权限 8 | 9 | #### 参数 10 | 11 | |字段|必选|传递方式|类型|说明| 12 | |----|----|--------|----|----| 13 | |mid|true|POST|int|发布帐号(必须和 access_key 帐号一致)| 14 | |cid|true|POST|int|视频ID| 15 | |playTime|true|POST|float|弹幕时间| 16 | |color|true|POST|int|弹幕颜色| 17 | |msg|true|POST|string|发布的信息| 18 | |fontsize|true|POST|int|文字大小| 19 | |mode|true|POST|int|弹幕的模式 (1、普通；4、底端；5、顶端；6、逆向；7、特殊；9、高级)| 20 | |pool|false|POST|int|发布的弹幕池(0、普通；1、字幕；2、特殊)| 21 | 22 | #### 错误代码 23 | 24 | |代码|说明| 25 | |----|----| 26 | |-634|发送的数据为空| 27 | |-635|该视频不允许发布评论| 28 | |-636|发送的数据不合法| 29 | |-637|系统禁止的信息| 30 | |-638|发布者禁止的信息| 31 | |-639|沒有权限使用该弹幕模式| 32 | |-640|不允许适应期用户发送的信息| 33 | -------------------------------------------------------------------------------- /API.dynamic.md: -------------------------------------------------------------------------------- 1 | ## 读取用户动态信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/dynamic 6 | 7 | 需要 App Key 并验证登录状态(Access key) 8 | 9 | #### 参数 10 | 11 | |字段|必选|类型|说明| 12 | |----|----|----|----| 13 | |include_types|false|string|选择显示的类型 多个间以半角逗号分隔| 14 | |exclude_types|false|string|忽略特定的类型的动态| 15 | |page|false|int|结果分页选择 默认为第1页| 16 | |pagesize|false|int|单页返回的记录条数，最大不超过100，默认为10。| 17 | 18 | ##### types 类型常量 19 | 20 | |string|说明| 21 | |------|----| 22 | |VIDEO|视频| 23 | |REVIEW|评论| 24 | |NEWS_REVIEW|新闻评论| 25 | |SPECIAL_ADDSP|专题添加专题| 26 | |SPECIAL_ADDBANGUMI|专题添加新番| 27 | |SPECIAL_ADDVIDEO|专题添加视频| 28 | |SPECIAL_BOOK_BANGUMI|连载中的番剧类专题| 29 | |SPECIAL_BOOK_MARK|收藏并关注的专题| 30 | |SPECIAL_BOOK_UNMARK|收藏未关注的专题| 31 | |APP|应用自定义动态| 32 | 33 | #### 返回 34 | 35 | |返回值字段|字段类型|字段说明| 36 | |----------|--------|--------| 37 | |results|int|返回的记录总数目| 38 | |pages|int|返回的记录总页数| 39 | |list|array|返回数据| 40 | 41 | 42 | ## 添加应用动态 43 | 44 | #### 调用地址 45 | 46 | http://api.bilibili.cn/dynamic/post 47 | 48 | 需要 App Key 并验证登录状态(Access key)；应用需要申请应用自定义动态权限 49 | 50 | #### 参数 51 | 52 | 53 | |字段|必选|类型|说明| 54 | |----|----|----|----| 55 | |do|true|string|动态显示的操作（例如：发布了新的投稿）| 56 | |title|true|string|动态显示的标题（例如投稿标题）（不超过60字）| 57 | |link|true|string|动态跳转地址| 58 | |msg|true|string|动态显示的详细信息 （不超过200字）| 59 | |keywords|false|string|站內搜索关键字| 60 | |cover|false|string|显示的封面（不填则显示头像）| 61 | 62 | #### 错误代码 63 | 64 | |代码|说明| 65 | |----|----| 66 | |-403|应用沒有使用此功能的权限| 67 | -------------------------------------------------------------------------------- /API.favourite.md: -------------------------------------------------------------------------------- 1 | ## 读取用户收藏信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/favourite?ver=2 6 | 7 | 需要 App Key 并验证登录状态(Access key) 8 | 9 | #### 参数 10 | 11 | |字段|必选|类型|说明| 12 | |----|----|----|----| 13 | |ver|false|int|API版本 推荐使用2 以下文档基于版本2| 14 | |page|false|int|结果分页选择 默认为第1页| 15 | |pagesize|false|int|单页返回的记录条数，最大不超过300，默认为10。| 16 | 17 | #### 返回 18 | 19 | |返回值字段|字段类型|字段说明| 20 | |----------|--------|--------| 21 | |results|int|返回的记录总数目| 22 | |pages|int|返回的记录总页数| 23 | |list|array|返回数据| 24 | 25 | #### 返回字段 "list" 子项 26 | 27 | |返回值字段|字段类型|字段说明| 28 | |----------|--------|--------| 29 | |aid|int|视频编号| 30 | |typename|string|视频分类| 31 | |title|string|视频标题| 32 | |create_at|string|收藏日期| 33 | |pic|string|封面图片地址| 34 | 35 | 36 | ## 添加收藏 37 | 38 | #### 调用地址 39 | 40 | http://api.bilibili.cn/favourite/add 41 | 42 | 需要 App Key 并验证登录状态(Access key) 43 | 44 | #### 参数 45 | 46 | |字段|必选|类型|说明| 47 | |----|----|----|----| 48 | |id|true|int|添加的视频编号| 49 | 50 | #### 错误代码 51 | 52 | |代码|说明| 53 | |----|----| 54 | |-607|超过收藏上限| 55 | 56 | 57 | ## 删除收藏 58 | 59 | #### 调用地址 60 | 61 | http://api.bilibili.cn/favourite/del 62 | 63 | 需要 App Key 并验证登录状态(Access key) 64 | 65 | #### 参数 66 | 67 | |字段|必选|类型|说明| 68 | |----|----|----|----| 69 | |id|true|int|删除的视频编号| 70 | -------------------------------------------------------------------------------- /API.feedback.md: -------------------------------------------------------------------------------- 1 | ## 读取视频评论 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/feedback 6 | 7 | #### 参数 8 | 9 | | 字段 | 必选 | 类型 | 说明 | 10 | | -------- | ----- | ------ | ---------------------------------------- | 11 | | aid | true | int | AV号 | 12 | | page | true | int | 页码 | 13 | | pagesize | false | int | 单页返回的记录条数，最大不超过300，默认为10。 | 14 | | ver | false | int | API版本,最新是3 | 15 | | order | false | string | 排序方式 默认按发布时间倒序 可选：good 按点赞人数排序 hot 按热门回复排序 | 16 | 17 | #### 返回 18 | 19 | ###### ver1 返回 20 | 21 | | 返回值字段 | 字段类型 | 字段说明 | 22 | | ----------- | ------ | ------------------------------------- | 23 | | mid | int | 会员ID | 24 | | lv | int | 楼层 | 25 | | fbid | int | 评论ID | 26 | | msg | string | 评论信息 | 27 | | ad_check | int | 状态 (0: 正常 1: UP主隐藏 2: 管理员删除 3: 因举报删除) | 28 | | face | string | 发布人头像 | 29 | | rank | int | 发布人显示标识 | 30 | | nick | string | 发布人暱称 | 31 | | totalResult | int | 总评论数 | 32 | | pages | int | 总页数 | 33 | 34 | ###### ver 2/3 返回 35 | 36 | | 返回值字段 | 字段类型 | 字段说明 | 37 | | -------- | ------- | ---- | 38 | | results | int | 总评论数 | 39 | | page | int | 当前页数 | 40 | | pages | int | 总页数 | 41 | | isAdmin | int | 未知 | 42 | | needCode | boolean | 未知 | 43 | | owner | int | 未知 | 44 | | hotList | list | 热评列表 | 45 | | list | list | 评论表 | 46 | 47 | ###### hotlist/list内容 48 | 49 | | 返回值字段 | 字段类型 | 字段说明 | 50 | | ----------- | ------ | ------------------------------------- | 51 | | mid | int | 会员ID | 52 | | lv | int | 楼层 | 53 | | fbid | int | 评论ID | 54 | | msg | string | 评论信息 | 55 | | ad_check | int | 状态 (0: 正常 1: UP主隐藏 2: 管理员删除 3: 因举报删除) | 56 | | face | string | 发布人头像 | 57 | | rank | int | 发布人显示标识 | 58 | | nick | string | 发布人暱称 | 59 | | totalResult | int | 总评论数 | 60 | | pages | int | 总页数 | 61 | | good | int | 点赞数? | 62 | | isgood | int | 是否已点赞? | 63 | | device | 未知 | 未知 | 64 | | create | int | 创建评论的UNIX时间 | 65 | | create_at | String | 创建评论的可读时间(2016-01-20 15:52) | 66 | | reply_count | int | 回复数量 | 67 | | level_info | list | 用户的等级信息? | 68 | | sex | String | 用户的性别 | 69 | | reply | list | 对此评论的回复(仅限list) | 70 | 71 | ###### level_info 72 | 73 | | 返回值字段 | 字段类型 | 字段说明 | 74 | | ------------- | ---- | --------- | 75 | | current_level | int | 用户当前等级 | 76 | | current_min | int | 当前等级最低经验值 | 77 | | current_exp | int | 用户当前经验值 | 78 | | next_exp | int | 下一等级所需经验值 | 79 | 80 | ###### reply 81 | 82 | | 返回值字段 | 字段类型 | 字段说明 | 83 | | ----------- | ------ | ------------------------------------- | 84 | | mid | int | 会员ID | 85 | | lv | int | 楼层 | 86 | | fbid | int | 评论ID | 87 | | msg | string | 评论信息 | 88 | | ad_check | int | 状态 (0: 正常 1: UP主隐藏 2: 管理员删除 3: 因举报删除) | 89 | | face | string | 发布人头像 | 90 | | rank | int | 发布人显示标识 | 91 | | nick | string | 发布人暱称 | 92 | | totalResult | int | 总评论数 | 93 | | pages | int | 总页数 | 94 | | good | int | 点赞数? | 95 | | isgood | int | 是否已点赞? | 96 | | device | 未知 | 未知 | 97 | | create | int | 创建评论的UNIX时间 | 98 | | create_at | String | 创建评论的可读时间(2016-01-20 15:52) | 99 | | reply_count | int | 回复数量 | 100 | | level_info | list | 用户的等级信息? | 101 | | sex | String | 用户的性别 | 102 | 103 | ## 发布视频评论 104 | 105 | #### 调用地址 106 | 107 | http://api.bilibili.cn/feedback/post 108 | 109 | 需要 App Key 并验证登录状态(Access key)；要求应用申请评论权限 110 | 111 | #### 参数 112 | 113 | | 字段 | 必选 | 传递方式 | 类型 | 说明 | 114 | | ----------------- | ----- | ---- | ------ | ---------------------------------------- | 115 | | mid | true | POST | int | 发布帐号(必须与access_key帐号一致) | 116 | | msg | true | POST | int | 发布的信息 | 117 | | mode | false | GET | string | 发布的评论类型(topic 话题 news 新闻 arc 视频) | 118 | | aid/tp_id/news_id | true | GET | int | 要发布评论的投稿编号 (视发布的类型而定 topic使用tp_id news使用news_id 视频使用aid) | 119 | | quoteID | false | POST | int | 引用的评论ID | 120 | | captcha | false | POST | string | 当服务器返回错误代码-105时 需要要求用户输入验证码 | 121 | 122 | #### 错误代码 123 | 124 | | 代码 | 说明 | 125 | | ---- | --------- | 126 | | -632 | 单次AT的人数过多 | 127 | -------------------------------------------------------------------------------- /API.friend.md: -------------------------------------------------------------------------------- 1 | ## 读取粉丝信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/friend/fans 6 | 7 | 需要 App Key 并验证登录状态(Access key) 8 | 9 | #### 参数 10 | 11 | |字段|必选|类型|说明| 12 | |----|----|----|----| 13 | |page|false|int|结果分页选择 默认为第1页| 14 | |pagesize|false|int|单页返回的记录条数，最大不超过300，默认为10。| 15 | 16 | #### 返回 17 | 18 | |返回值字段|字段类型|字段说明| 19 | |----------|--------|--------| 20 | |results|int|返回的记录总数目| 21 | |pages|int|返回的记录总页数| 22 | |list|array|返回数据| 23 | 24 | ##### 返回字段 "list" 子项 25 | 26 | |返回值字段|字段类型|字段说明| 27 | |----------|--------|--------| 28 | |record_id|int|好友记录编号| 29 | |fid|int|好友帐号ID| 30 | |addtime|int|添加时间| 31 | |uname|string|好友暱称| 32 | |face|string|好友头像地址| 33 | 34 | 35 | ## 读取我的关注信息 36 | 37 | #### 调用地址 38 | 39 | http://api.bilibili.cn/friend/attention 40 | 41 | 需要 App Key 并验证登录状态(Access key) 42 | 43 | #### 参数 44 | 45 | |字段|必选|类型|说明| 46 | |----|----|----|----| 47 | |page|false|int|结果分页选择 默认为第1页| 48 | |pagesize|false|int|单页返回的记录条数，最大不超过300，默认为10。| 49 | 50 | #### 返回 51 | 52 | |返回值字段|字段类型|字段说明| 53 | |----------|--------|--------| 54 | |results|int|返回的记录总数目| 55 | |pages|int|返回的记录总页数| 56 | |list|array|返回数据| 57 | 58 | ##### 返回字段 "list" 子项 59 | 60 | |返回值字段|字段类型|字段说明| 61 | |----------|--------|--------| 62 | |record_id|int|好友记录编号| 63 | |fid|int|好友帐号ID| 64 | |addtime|int|添加时间| 65 | |uname|string|好友暱称| 66 | |face|string|好友头像地址| 67 | 68 | 69 | ## 读取我的悄悄关注信息 70 | 71 | #### 调用地址 72 | 73 | http://api.bilibili.cn/friend/whisper 74 | 75 | 需要 App Key 并验证登录状态(Access key) 76 | 77 | #### 参数 78 | 79 | |字段|必选|类型|说明| 80 | |----|----|----|----| 81 | |page|false|int|结果分页选择 默认为第1页| 82 | |pagesize|false|int|单页返回的记录条数，最大不超过300，默认为10。| 83 | 84 | #### 返回 85 | 86 | |返回值字段|字段类型|字段说明| 87 | |----------|--------|--------| 88 | |results|int|返回的记录总数目| 89 | |pages|int|返回的记录总页数| 90 | |list|array|返回数据| 91 | 92 | ##### 返回字段 "list" 子项 93 | 94 | |返回值字段|字段类型|字段说明| 95 | |----------|--------|--------| 96 | |record_id|int|好友记录编号| 97 | |fid|int|好友帐号ID| 98 | |addtime|int|添加时间| 99 | |uname|string|好友暱称| 100 | |face|string|好友头像地址| 101 | 102 | 103 | ## 读取我的互粉好友 104 | 105 | #### 调用地址 106 | 107 | http://api.bilibili.cn/friend/fans_eachother 108 | 109 | 需要 App Key 并验证登录状态(Access key) 110 | 111 | #### 参数 112 | 113 | |字段|必选|类型|说明| 114 | |----|----|----|----| 115 | |game_id|false|int|获取已安装/未安装游戏好友| 116 | |game_status|false|bool|获取已安装/未安装游戏好友 (true 已安装 false 未安装)| 117 | |page|false|int|结果分页选择 默认为第1页| 118 | |pagesize|false|int|单页返回的记录条数，最大不超过300，默认为10。| 119 | 120 | #### 返回 121 | 122 | |返回值字段|字段类型|字段说明| 123 | |----------|--------|--------| 124 | |results|int|返回的记录总数目| 125 | |pages|int|返回的记录总页数| 126 | |list|array|返回数据| 127 | 128 | ##### 返回字段 "list" 子项 129 | 130 | |返回值字段|字段类型|字段说明| 131 | |----------|--------|--------| 132 | |fid|int|好友帐号ID| 133 | |uname|string|好友暱称| 134 | |face|string|好友头像地址| 135 | 136 | 137 | ## 读取我的黑名单信息 138 | 139 | #### 调用地址 140 | 141 | http://api.bilibili.cn/friend/badlist 142 | 143 | 需要 App Key 并验证登录状态(Access key) 144 | 145 | #### 参数 146 | 147 | |字段|必选|类型|说明| 148 | |----|----|----|----| 149 | |page|false|int|结果分页选择 默认为第1页| 150 | |pagesize|false|int|单页返回的记录条数，最大不超过300，默认为10。| 151 | 152 | #### 返回 153 | 154 | |返回值字段|字段类型|字段说明| 155 | |----------|--------|--------| 156 | |results|int|返回的记录总数目| 157 | |pages|int|返回的记录总页数| 158 | |list|array|返回数据| 159 | 160 | ##### 返回字段 "list" 子项 161 | 162 | |返回值字段|字段类型|字段说明| 163 | |----------|--------|--------| 164 | |record_id|int|记录编号| 165 | |fid|int|黑名单帐号ID| 166 | |addtime|int|添加时间| 167 | |uname|string|黑名单暱称| 168 | |face|string|黑名单头像地址| 169 | 170 | 171 | ## 添加黑名单 172 | 173 | #### 调用地址 174 | 175 | http://api.bilibili.cn/friend/badlist/add 176 | 177 | 需要 App Key 并验证登录状态(Access key) 178 | 179 | #### 参数 180 | 181 | |字段|必选|类型|说明| 182 | |----|----|----|----| 183 | |mid|true|int|要添加的黑名单帐号| 184 | 185 | 186 | ## 取消黑名单 187 | 188 | #### 调用地址 189 | 190 | http://api.bilibili.cn/friend/badlist/del 191 | 192 | 需要 App Key 并验证登录状态(Access key) 193 | 194 | #### 参数 195 | 196 | |字段|必选|类型|说明| 197 | |----|----|----|----| 198 | |mid|true|int|要取消的黑名单帐号| 199 | 200 | 201 | ## 添加关注 202 | 203 | #### 调用地址 204 | 205 | http://api.bilibili.cn/friend/attention/add 206 | 207 | 需要 App Key 并验证登录状态(Access key) 208 | 209 | #### 参数 210 | 211 | |字段|必选|类型|说明| 212 | |----|----|----|----| 213 | |mid|true|int|要添加的关注帐号| 214 | 215 | 216 | ## 取消关注 217 | 218 | #### 调用地址 219 | 220 | http://api.bilibili.cn/friend/attention/del 221 | 222 | 需要 App Key 并验证登录状态(Access key) 223 | 224 | #### 参数 225 | 226 | |字段|必选|类型|说明| 227 | |----|----|----|----| 228 | |mid|true|int|要取消的关注帐号| 229 | 230 | 231 | ## 添加悄悄关注 232 | 233 | #### 调用地址 234 | 235 | http://api.bilibili.cn/friend/whisper/add 236 | 237 | 需要 App Key 并验证登录状态(Access key) 238 | 239 | #### 参数 240 | 241 | |字段|必选|类型|说明| 242 | |----|----|----|----| 243 | |mid|true|int|要添加的关注帐号| 244 | 245 | 246 | ## 取消悄悄关注 247 | 248 | #### 调用地址 249 | 250 | http://api.bilibili.cn/friend/whisper/del 251 | 252 | 需要 App Key 并验证登录状态(Access key) 253 | 254 | #### 参数 255 | 256 | |字段|必选|类型|说明| 257 | |----|----|----|----| 258 | |mid|true|int|要取消的关注帐号| 259 | -------------------------------------------------------------------------------- /API.history.md: -------------------------------------------------------------------------------- 1 | ## 读取播放历史信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/history 6 | 7 | #### 返回 8 | 9 | |返回值字段|字段类型|字段说明| 10 | |----------|--------|--------| 11 | |results|int|返回的记录总数目| 12 | |list|object|返回数据| 13 | 14 | ##### 返回字段 "list" 子项 15 | 16 | |返回值字段|字段类型|字段说明| 17 | |----------|--------|--------| 18 | |aid|int|视频编号| 19 | |typeid|int|视频分类ID| 20 | |typename|string|视频分类名称| 21 | |title|string|视频标题| 22 | |subtitle|string|视频副标题| 23 | |play|int|播放次数| 24 | |review|int|评论数| 25 | |video_review|int|弹幕数| 26 | |favorites|int|收藏数| 27 | |author|string|视频作者| 28 | |mid|int|视频作者ID| 29 | |create|string|视频创建日期| 30 | |description|string|视频简介| 31 | |pic|string|封面图片地址| 32 | |credit|int|评分数量| 33 | |coins|int|推荐数量| 34 | |duration|string|视频时长| 35 | -------------------------------------------------------------------------------- /API.index.md: -------------------------------------------------------------------------------- 1 | ## 批量读取排行信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/index 6 | 7 | #### 返回 8 | 9 | |返回值字段|字段类型|字段说明| 10 | |----------|--------|--------| 11 | |type{x}|object|返回数据请参见 [API.list](./API.list.md)| 12 | -------------------------------------------------------------------------------- /API.list.md: -------------------------------------------------------------------------------- 1 | ## 读取视频排行信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/list 6 | 7 | 需要 App Key 8 | 9 | #### 参数 10 | 11 | |字段|必选|类型|说明| 12 | |----|----|----|----| 13 | |tid|true|int|分类编号 new排序为必填 其他为可选| 14 | |exclude_tid|false|int|排除分类编号 不可与tid同时使用| 15 | |mid|false|int|只显示该帐号投稿| 16 | |begin|false|date|起始搜索日期 (格式：YYYY-mm-dd)| 17 | |end|false|date|结束搜索日期 (格式：YYYY-mm-dd)| 18 | |days|false|int|搜索最近天数 范围 1-90天 默认7天| 19 | |page|false|int|结果分页选择 默认为第1页| 20 | |pagesize|false|int|单页返回的记录条数，最大不超过100，默认为30。| 21 | |pinyin|true|string|在使用拼音排序时必填选项 拼音首字母| 22 | |click_detail|false|boolean|可选 返回详细点击信息| 23 | |original|false|boolean|只返回原创投稿| 24 | |mission_id|false|int|返回活动投稿| 25 | |exclude|false|array|排除exclude中的id 可用,分隔多个| 26 | |ver|false|int|API版本 建议使用2| 27 | |order|false|string|排序方式| 28 | 29 | ##### 排序方式 30 | 31 | |字段|说明| 32 | |----|----| 33 | |default|按新投稿排序| 34 | |new|按新评论排序| 35 | |review|按评论数从高至低排序| 36 | |hot|按点击从高至低排序| 37 | |damku|按弹幕数从高至低排序| 38 | |comment|按推荐数从高至低排序| 39 | |promote|按宣传数排序（硬币）| 40 | |pinyin|按标题拼音排序| 41 | 42 | #### 返回 43 | 44 | |返回值字段|字段类型|字段说明| 45 | |----------|--------|--------| 46 | |code|int|未知| 47 | |name|string|分类名称| 48 | |num|int|返回的记录总数目| 49 | |results|int|返回的记录总数目| 50 | |pages|int|返回的记录总页数| 51 | |list|array|返回数据| 52 | 53 | ##### 返回字段 "list" 子项 54 | 55 | |返回值字段|字段类型|字段说明| 56 | |----------|--------|--------| 57 | |aid|int|视频编号| 58 | |copyright|String|是否原创（Original/Copy）| 59 | |typeid|int|视频分类ID| 60 | |typename|string|视频分类名称| 61 | |title|string|视频标题| 62 | |subtitle|string|视频副标题| 63 | |play|int|播放次数| 64 | |review|int|评论数| 65 | |video_review|int|弹幕数| 66 | |favorites|int|收藏数| 67 | |author|string|视频作者| 68 | |mid|int|视频作者ID| 69 | |create|string|视频创建日期| 70 | |description|string|视频简介| 71 | |pic|string|封面图片地址| 72 | |credit|int|评分数量| 73 | |coins|int|推荐数量| 74 | |duration|string|视频时长| 75 | |comment|int|弹幕数(与video_review一致)| 76 | 77 | 注意结尾有孤立的 num,类型int，与返回值中的int相同 78 | 79 | #### 错误代码 80 | 81 | |代码|说明| 82 | |----|----| 83 | |-601|起始日期格式错误| 84 | |-602|结束日期格式错误| 85 | |-603|选择的时间跨度过大| 86 | |-604|沒有输入拼音| 87 | -------------------------------------------------------------------------------- /API.log.md: -------------------------------------------------------------------------------- 1 | ## 读取用户登陆信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/log/login 6 | 7 | 需要 App Key 并验证登录状态(Access key) 8 | 9 | #### 参数 10 | 11 | |字段|必选|类型|说明| 12 | |----|----|----|----| 13 | |page|false|int|结果分页选择 默认为第1页| 14 | |pagesize|false|int|单页返回的记录条数，最大不超过300，默认为10。| 15 | 16 | #### 返回 17 | 18 | |返回值字段|字段类型|字段说明| 19 | |----------|--------|--------| 20 | |results|int|返回的记录总数目| 21 | |pages|int|返回的记录总页数| 22 | |list|array|返回数据| 23 | 24 | ##### 返回字段 "list" 子项 25 | 26 | |返回值字段|字段类型|字段说明| 27 | |----------|--------|--------| 28 | |time|int|登陆时间| 29 | |time_at|string|登陆时间| 30 | |ip|string|登陆IP| 31 | |geo|string|登陆地理信息| 32 | -------------------------------------------------------------------------------- /API.login.3rd.md: -------------------------------------------------------------------------------- 1 | ## 读取用户登陆信息 2 | 3 | #### 调用地址 4 | 5 | https://secure.bilibili.tv/login 6 | 7 | #### 参数 8 | 9 | |字段|必选|类型|说明| 10 | |----|----|----|----| 11 | |api|true|string|申请时填入的API地址| 12 | |appkey|true|string|申请时系统提供的Key| 13 | |sign|true|string|校验密钥 md5("api=")| 14 | 15 | #### 回调 16 | 17 | 编码为UTF-8 18 | 19 | |返回值字段|字段类型|字段说明| 20 | |----------|--------|--------| 21 | |mid|int|会员编号| 22 | |uname|string|UTF-8编码 用户暱称| 23 | |face|string|用户头像| 24 | |rank|int|用户等级编码| 25 | |access_key|string|用户访问授权密钥| 26 | |sign|string|校验码 计算方法 见API说明页| 27 | 28 | ##### 示例 29 | 30 | PHP 版本： 31 | ``` 32 | $v) { 43 | $_data[] = $k . '=' . rawurlencode($v); 44 | } 45 | $_sign = implode('&', $_data); 46 | return array( 47 | 'sign' => strtolower(md5($_sign . $key)), 48 | 'params' => $_sign, 49 | ); 50 | } 51 | define("APP_SECRET","abcdef123456"); 52 | $params = $_GET; 53 | unset($params['sign']); 54 | $sign = get_sign($params,APP_SECRET); 55 | if ($sign['sign'] != $_GET['sign']) exit("Access denied"); 56 | session_start(); 57 | $_SESSION["access_key"] = $_GET['access_key']; 58 | header("Location: /favourite.php"); 59 | ?> 60 | ``` 61 | -------------------------------------------------------------------------------- /API.login.md: -------------------------------------------------------------------------------- 1 | ## 用户登录 2 | 3 | #### 调用地址 4 | 5 | https://api.bilibili.tv/login 6 | 7 | 需要 App Key；此API调用权限需要额外申请，具体请联系网站客服。 8 | 9 | #### 参数 10 | 11 | |字段|必选|类型|说明| 12 | |----|----|----|----| 13 | |userid/email|true|string|帐号名或邮箱| 14 | |pwd|true|string|明文密码| 15 | |captcha|true|string|验证码 (请访问 https://secure.bilibili.tv/captcha 获取，需启用COOKIE 并需要传递至此API)| 16 | 17 | #### 返回 18 | 19 | |返回值字段|字段类型|字段说明| 20 | |----------|--------|--------| 21 | |mid|int|会员ID| 22 | |access_key|string|用户授权密钥| 23 | |expires|int|用户授权密钥过期时间| 24 | 25 | #### 错误代码 26 | 27 | |代码|说明| 28 | |----|----| 29 | |-625|密码重试次数过多| 30 | |-626|帐号不存在| 31 | |-627|密码不正确| 32 | |-628|密码不安全| 33 | -------------------------------------------------------------------------------- /API.myinfo.md: -------------------------------------------------------------------------------- 1 | ## 读取用户信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/myinfo 6 | 7 | 需要 App Key 并验证登录状态(Access key) 8 | 9 | #### 返回 10 | 11 | |返回值字段|字段类型|字段说明| 12 | |----------|--------|--------| 13 | |mid|int|用户ID| 14 | |uname|string|用户名称| 15 | |face|string|头像图片地址| 16 | |rank|int|用户等级| 17 | |scores|int|积分| 18 | |coins|int|金币| 19 | |attentions|int|关注的用户列表| 20 | |sex|string|性别| 21 | |maxstow|int|最大收藏上限| 22 | 23 | ##### 用户等级数值解释 24 | 25 | |数字|等级名称| 26 | |----|--------| 27 | |0|普通会员| 28 | |5000|注册会员| 29 | |10000|正式会员| 30 | |20000|字幕君| 31 | |25000|VIP| 32 | |30000|真·职人| 33 | -------------------------------------------------------------------------------- /API.notify.md: -------------------------------------------------------------------------------- 1 | ## 读取通知信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/notify 6 | 7 | 需要 App Key 并验证登录状态(Access key) 8 | 9 | #### 返回 10 | 11 | |返回值字段|字段类型|字段说明| 12 | |----------|--------|--------| 13 | |num|int|总通知数目| 14 | |pages|int|返回的记录总页数| 15 | |result|array|返回数据| 16 | 17 | ##### 返回字段 "result" 子项 18 | 19 | |返回值字段|字段类型|字段说明| 20 | |----------|--------|--------| 21 | |nf_id|int|通知ID| 22 | |type|string|通知类型(sys 全体通知 / user 用户通知)| 23 | |title|string|通知标题| 24 | |msg|string|通知內容| 25 | |isread|int|通知读取状态 0为未读取 1为已读| 26 | 27 | 28 | ## 设置通知为已读 29 | 30 | #### 调用地址 31 | 32 | http://api.bilibili.cn/notify/setread 33 | 34 | 需要 App Key 并验证登录状态(Access key) 35 | 36 | #### 参数 37 | 38 | |字段|必选|类型|说明| 39 | |----|----|----|----| 40 | |nf_id|false|int|通知ID| 41 | |type|false|int|通知类型(sys 全体通知 / user 用户通知)| 42 | 43 | #### 错误代码 44 | 45 | |代码|说明| 46 | |----|----| 47 | |-1|类型错误| 48 | |-2|通知不存在| 49 | -------------------------------------------------------------------------------- /API.recommend.md: -------------------------------------------------------------------------------- 1 | ## 读取用户推荐信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/recommend 6 | 7 | #### 参数 8 | 9 | |字段|必选|类型|说明| 10 | |----|----|----|----| 11 | |tid|true|int|分类编号 new排序为必填 其他为可选| 12 | |page|false|int|结果分页选择 默认为第1页| 13 | |pagesize|false|int|单页返回的记录条数，最大不超过100，默认为30。| 14 | |order|false|string|排序方式| 15 | 16 | ##### 排序方式 17 | 18 | |字段|说明| 19 | |----|----| 20 | |default|按新投稿排序| 21 | |new|按新评论排序| 22 | |review|按评论数从高至低排序| 23 | |hot|按点击从高至低排序| 24 | |damku|按弹幕数从高至低排序| 25 | |comment|按推荐数从高至低排序| 26 | |promote|按宣传数排序（硬币）| 27 | 28 | #### 返回 29 | 30 | |返回值字段|字段类型|字段说明| 31 | |----------|--------|--------| 32 | |name|string|分类名称| 33 | |results|int|返回的记录总数目| 34 | |pages|int|返回的记录总页数| 35 | |list|object|返回数据| 36 | 37 | ##### 返回字段 "list" 子项 38 | 39 | |返回值字段|字段类型|字段说明| 40 | |----------|--------|--------| 41 | |aid|int|视频编号| 42 | |typeid|int|视频分类ID| 43 | |typename|string|视频分类名称| 44 | |title|string|视频标题| 45 | |subtitle|string|视频副标题| 46 | |play|int|播放次数| 47 | |review|int|评论数| 48 | |video_review|int|弹幕数| 49 | |favorites|int|收藏数| 50 | |author|string|视频作者| 51 | |mid|int|视频作者ID| 52 | |create|string|视频创建日期| 53 | |description|string|视频简介| 54 | |pic|string|封面图片地址| 55 | |credit|int|评分数量| 56 | |coins|int|推荐数量| 57 | |duration|string|视频时长| 58 | |last_recommend|object|最后推荐信息| 59 | 60 | ###### 返回字段 "last_recommend" 子项 61 | 62 | |返回值字段|字段类型|字段说明| 63 | |----------|--------|--------| 64 | |mid|int|推荐人ID| 65 | |uname|string|推荐人名字| 66 | |face|string|推荐人头像地址| 67 | |msg|string|推荐信息| 68 | |time|int|推荐时间| 69 | -------------------------------------------------------------------------------- /API.search.md: -------------------------------------------------------------------------------- 1 | ## 搜索 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/search 6 | 7 | 需要 App Key 8 | 9 | #### 参数 10 | 11 | |字段|必选|类型|说明| 12 | |----|----|----|----| 13 | |keyword|true|string|搜索的关键字，必须做URLencoding。| 14 | |page|false|int|搜索结果分页选择 默认为第1页| 15 | |pagesize|false|int|单页返回的记录条数，最大不超过100，默认为20。| 16 | |order|false|string|排序方式| 17 | 18 | ##### 排序方式 19 | 20 | |字段|说明| 21 | |----|----| 22 | |default|综合排序| 23 | |pubdate|按发布日期倒序排序| 24 | |senddate|按修改日期倒序排序| 25 | |id|按投稿ID倒序排序| 26 | |ranklevel|按相关度排序| 27 | |click|按点击从高至低排序| 28 | |scores|按评论数从高至低排序| 29 | |damku|按弹幕数从高至低排序| 30 | |stow|按收藏数从高至低排序| 31 | 32 | #### 返回 33 | 34 | |返回值字段|字段类型|字段说明| 35 | |----------|--------|--------| 36 | |type|string|mylist 我的列表 video 视频 special 专题| 37 | |lid|int|我的列表编号 当type为mylist时才会出现| 38 | |aid|int|视频编号 当type为video时才会出现| 39 | |spid|int|专题编号 当type为special时才会出现| 40 | |author|string|视频作者| 41 | |play|int|播放次数| 42 | |review|int|评论数| 43 | |video_review|int|弹幕数| 44 | |favorites|int|收藏数| 45 | |title|string|视频/mylist/专题标题| 46 | |description|string|视频/mylist/专题描述| 47 | |tag|string|视频/mylist/专题关键字| 48 | |pic|string|封面图片地址| 49 | 50 | #### 错误代码 51 | 52 | |代码|说明| 53 | |----|----| 54 | |-501|系统错误| 55 | |-502|搜索正在进行中| 56 | -------------------------------------------------------------------------------- /API.sp.md: -------------------------------------------------------------------------------- 1 | ## 读取专题信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/sp 6 | 7 | #### 参数 8 | 9 | |字段|必选|类型|说明| 10 | |----|----|----|----| 11 | |spid|false|int|专题编号| 12 | |title|false|string|专题名称| 13 | 14 | #### 返回 15 | 16 | |返回值字段|字段类型|字段说明| 17 | |----------|--------|--------| 18 | |spid|int|专题SPID| 19 | |title|string|专题名| 20 | |pubdate|int|发布日期 (UNIX Timestamp)| 21 | |create_at|date|发布日期| 22 | |lastupdate|int|最后更新日期 (UNIX Timestamp)| 23 | |lastupdate_at|date|最后更新日期| 24 | |alias|string|同义词| 25 | |cover|string|封面| 26 | |isbangumi|int|是否为新番 1=2次元新番 2=3次元新番| 27 | |isbangumi_end|int|是否已经播放结束| 28 | |bangumi_date|date|开播日期| 29 | |description|string|专题简介| 30 | |view|int|点击次数| 31 | |favourite|int|专题收藏次数| 32 | |attention|int|专题被关注次数| 33 | |count|int|专题视频数量| 34 | 35 | 36 | ## 读取用户专题收藏信息 37 | 38 | #### 调用地址 39 | 40 | http://api.bilibili.cn/sp/list 41 | 42 | 需要 App Key 并验证登录状态(Access key) 43 | 44 | #### 参数 45 | 46 | |字段|必选|类型|说明| 47 | |----|----|----|----| 48 | |page|false|int|结果分页选择 默认为第1页| 49 | |pagesize|false|int|单页返回的记录条数，最大不超过300，默认为10。| 50 | |attention|false|int|关注状态 不传递则返回所有 0：未关注专题 1：已关注专题| 51 | 52 | #### 返回 53 | 54 | |返回值字段|字段类型|字段说明| 55 | |----------|--------|--------| 56 | |results|int|返回的记录总数目| 57 | |pages|int|返回的记录总页数| 58 | |list|array|返回数据| 59 | 60 | ##### 返回字段 "list" 子项 61 | 62 | |返回值字段|字段类型|字段说明| 63 | |----------|--------|--------| 64 | |spid|int|专题编号| 65 | |title|string|专题标题| 66 | |create_at|string|收藏日期| 67 | |pic|string|封面图片地址| 68 | 69 | 70 | ## 添加专题收藏 71 | 72 | #### 调用地址 73 | 74 | http://api.bilibili.cn/sp/add 75 | 76 | 需要 App Key 并验证登录状态(Access key) 77 | 78 | #### 参数 79 | 80 | |字段|必选|类型|说明| 81 | |----|----|----|----| 82 | |id|true|int|添加的专题编号| 83 | 84 | #### 错误代码 85 | 86 | |代码|说明| 87 | |----|----| 88 | |-607|超过收藏上限| 89 | 90 | 91 | ## 删除专题收藏 92 | 93 | #### 调用地址 94 | 95 | http://api.bilibili.cn/sp/del 96 | 97 | 需要 App Key 并验证登录状态(Access key) 98 | 99 | #### 参数 100 | 101 | |字段|必选|类型|说明| 102 | |----|----|----|----| 103 | |id|true|int|删除的专题编号(同时取消关注)| 104 | 105 | 106 | ## 添加专题关注 107 | 108 | #### 调用地址 109 | 110 | http://api.bilibili.cn/sp/attention 111 | 112 | 需要 App Key 并验证登录状态(Access key) 113 | 114 | #### 参数 115 | 116 | |字段|必选|类型|说明| 117 | |----|----|----|----| 118 | |id|true|int|添加的专题编号(同时将收藏)| 119 | 120 | 121 | ## 删除专题收藏 122 | 123 | #### 调用地址 124 | 125 | http://api.bilibili.cn/sp/inattention 126 | 127 | 需要 App Key 并验证登录状态(Access key) 128 | 129 | #### 参数 130 | 131 | |字段|必选|类型|说明| 132 | |----|----|----|----| 133 | |id|true|int|取消关注的专题编号| 134 | -------------------------------------------------------------------------------- /API.spview.md: -------------------------------------------------------------------------------- 1 | ## 读取番剧专题信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/spview 6 | 7 | #### 参数 8 | 9 | |字段|必选|类型|说明| 10 | |----|----|----|----| 11 | |spid|true|int|专题SPID| 12 | |season_id|false|int|专题分季ID| 13 | |bangumi|false|int|设置为1时只返回番剧类视频 设置为0时只返回普通视频 不设置则返回所有视频| 14 | 15 | #### 返回 16 | 17 | |返回值字段|字段类型|字段说明| 18 | |----------|--------|--------| 19 | |result|int|返回的记录总数目| 20 | |list|array|返回数据| 21 | 22 | ##### 返回字段 "list" 子项 23 | 24 | |返回值字段|字段类型|字段说明| 25 | |----------|--------|--------| 26 | |title|string|标题| 27 | |cover|string|封面图片地址| 28 | |aid|int|视频ID| 29 | |click|int|点击数| 30 | -------------------------------------------------------------------------------- /API.suggest.md: -------------------------------------------------------------------------------- 1 | ## 搜索关键字推荐 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/suggest 6 | 7 | #### 参数 8 | 9 | |字段|必选|类型|说明| 10 | |----|----|----|----| 11 | |term|true|string|关键字| 12 | |sponly|false|int|只显示专题| 13 | 14 | #### 返回 15 | 16 | 这个返回非常奇葩，没有数组装数据，我就随便写一下，看不懂自己调用分析结果 17 | 18 | |返回值字段|字段类型|字段说明| 19 | |----------|--------|--------| 20 | |{x}|string|第 x 个关键词建议| 21 | -------------------------------------------------------------------------------- /API.tags.md: -------------------------------------------------------------------------------- 1 | ## 读取视频排行信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/tags 6 | 7 | 需要 App Key 8 | 9 | #### 参数 10 | 11 | |字段|必选|类型|说明| 12 | |----|----|----|----| 13 | |tid|true|int|分类编号 new排序为必填 其他为可选| 14 | |page|false|int|结果分页选择 默认为第1页| 15 | |pagesize|false|int|单页返回的记录条数，最大不超过100，默认为30。| 16 | |tags|true|string|需要搜索的TAG| 17 | |order|false|string|排序方式| 18 | 19 | ##### 排序方式 20 | 21 | |字段|说明| 22 | |----|----| 23 | |default|按新投稿排序| 24 | |new|按新评论排序| 25 | |review|按评论数从高至低排序| 26 | |hot|按点击从高至低排序| 27 | |damku|按弹幕数从高至低排序| 28 | |comment|按推荐数从高至低排序| 29 | |promote|按宣传数排序（硬币）| 30 | 31 | #### 返回 32 | 33 | |返回值字段|字段类型|字段说明| 34 | |----------|--------|--------| 35 | |name|string|分类名称| 36 | |results|int|返回的记录总数目| 37 | |pages|int|返回的记录总页数| 38 | |list|array|返回数据| 39 | 40 | ##### 返回字段 "list" 子项 41 | 42 | |返回值字段|字段类型|字段说明| 43 | |----------|--------|--------| 44 | |aid|int|视频编号| 45 | |typeid|int|视频分类ID| 46 | |typename|string|视频分类名称| 47 | |title|string|视频标题| 48 | |subtitle|string|视频副标题| 49 | |play|int|播放次数| 50 | |review|int|评论数| 51 | |video_review|int|弹幕数| 52 | |favorites|int|收藏数| 53 | |author|string|视频作者| 54 | |mid|int|视频作者ID| 55 | |create|string|视频创建日期| 56 | |description|string|视频简介| 57 | |pic|string|封面图片地址| 58 | |credit|int|评分数量| 59 | |coins|int|推荐数量| 60 | |duration|string|视频时长| 61 | -------------------------------------------------------------------------------- /API.userinfo.md: -------------------------------------------------------------------------------- 1 | ## 获取用户信息 2 | 3 | #### 调用地址 4 | 5 | http://api.bilibili.cn/userinfo 6 | 7 | #### 参数 8 | 9 | |字段|必选|类型|说明| 10 | |----|----|----|----| 11 | |user|false|string|要查询的昵称 (mid 或 user必须有其中之一)| 12 | |uid|false|int|要查询的帐号id (mid 或 user必须有其中之一)| 13 | 14 | #### 返回（坑爹的时刻来了！） 15 | 16 | 通过昵称获取和通过 uid 获取的数据格式是不一样的！！！！ 17 | 尼玛而且昵称获取到的信息比 uid 还要多！！！！ 18 | 19 | ##### 通过 user 获取的返回值 20 | 21 | |返回值字段|字段类型|字段说明| 22 | |----------|--------|--------| 23 | |mid|int|会员ID| 24 | |name|string|暱名| 25 | |approve|int|是否为认证帐号| 26 | |sex|string|性别 (男/女/不明)| 27 | |rank|int|帐号显示标识| 28 | |face|string|小头像| 29 | |attention|int|关注的好友人数| 30 | |fans|int|粉丝人数| 31 | |article|int|投稿数| 32 | |place|string|所在地| 33 | |description|string|认证用户为认证信息 普通用户为交友宣言| 34 | |attentions|array|关注的好友列表| 35 | 36 | ##### 通过 uid 获取的返回值 37 | 38 | |返回值字段|字段类型|字段说明| 39 | |----------|--------|--------| 40 | |mid|int|会员ID| 41 | |uname|string|暱名| 42 | |userid|string|用户名| 43 | |face|string|头像| 44 | |rank|int|帐号显示标识| 45 | |sex|string|性别 (男/女/不明)| 46 | |sign|string|认证用户为认证信息 普通用户为交友宣言| 47 | -------------------------------------------------------------------------------- /API.view.md: -------------------------------------------------------------------------------- 1 | ## 读取视频信息 2 | 3 | > 如需获取分P，需要以不同页码多次调用本接口 -- @fython 4 | 5 | #### 调用地址 6 | 7 | http://api.bilibili.cn/view 8 | 9 | 需要 App Key 10 | 11 | #### 参数 12 | 13 | |字段|必选|类型|说明| 14 | |----|----|----|----| 15 | |id|true|int|AV号| 16 | |page|true|int|页码| 17 | |fav|false|int|是否读取会员收藏状态 (默认 0)| 18 | 19 | #### 返回 20 | 21 | |返回值字段|字段类型|字段说明| 22 | |----------|--------|--------| 23 | |play|int|播放次数| 24 | |review|int|评论数| 25 | |video_review|int|弹幕数| 26 | |favorites|int|收藏数| 27 | |credit|int|评分数量| 28 | |coins|int|推荐数量(硬币数)| 29 | |title|string|标题| 30 | |description|string|简介| 31 | |tag|string|关键字| 32 | |pic|string|封面图片URL地址| 33 | |pages|string|返回记录的总页数| 34 | |author|string|投搞人| 35 | |mid|int|投搞人ID| 36 | |cid|int|视频源及弹幕编号 弹幕地址 http://comment.bilibili.cn/.xml| 37 | |offsite|string|Flash播放调用地址（如果沒有此项则此视频无法在站外播放）| 38 | |create_at|string|视频发布日期| 39 | |favorited|bool|当前帐号收藏状态| 40 | |spid|未知|未知| 41 | |tid|int|分区号| 42 | |allow_feed|int|未知| 43 | |allow_bp|int|未知| 44 | |partname|String|分P名| 45 | |src|String|未知| 46 | |face|String|投稿者头像| 47 | |typename|String|分类名| 48 | -------------------------------------------------------------------------------- /CONST.typeid.md: -------------------------------------------------------------------------------- 1 | ## 常用的视频分区分类编号 2 | 3 | 分区可能信息可能会有所变动，本表格于 2017/1/6 更新 4 | 建议通过 http://api.bilibili.cn/recommend?tid={tid}&pagesize=1 抓取最新分区信息 5 | 6 | |编号|对应的分区名称| 7 | |----|--------------| 8 | | 0 | 音乐选集 | 9 | | 1 | 短片·手书·配音 | 10 | | 3 | 音乐选集 | 11 | | 4 | GMV | 12 | | 5 | 综艺 | 13 | | 11 | 电视剧相关 | 14 | | 13 | 官方延伸 | 15 | | 17 | 实况解说 | 16 | | 19 | Mugen | 17 | | 20 | 宅舞 | 18 | | 21 | 日常 | 19 | | 22 | 鬼畜调教 | 20 | | 23 | 电影相关 | 21 | | 24 | MAD·AMV | 22 | | 25 | 剧情MMD | 23 | | 26 | 音MAD | 24 | | 27 | 其他（动画 > 综合） | 25 | | 29 | 三次元音乐 | 26 | | 30 | VOCALOID中文曲 | 27 | | 31 | 翻唱 | 28 | | 36 | 演讲•公开课 | 29 | | 39 | 公开课 | 30 | | 40 | 技术宅 | 31 | | 43 | 舞蹈MMD | 32 | | 44 | 剧情MMD | 33 | | 45 | 原创模型 | 34 | | 46 | 其他（动画 > MMD·3D） | 35 | | 47 | 手书 | 36 | | 48 | 原创动画 | 37 | | 49 | ACG配音 | 38 | | 50 | 手书 | 39 | | 51 | 资讯 | 40 | | 53 | 其他（动画 > 综合） | 41 | | 54 | OP/ED/OST | 42 | | 56 | VOCALOID | 43 | | 57 | UTAU | 44 | | 58 | VOCALOID中文曲 | 45 | | 59 | 演奏 | 46 | | 61 | 预告资讯 | 47 | | 63 | 实况解说 | 48 | | 64 | 游戏杂谈 | 49 | | 66 | 游戏集锦 | 50 | | 67 | 其他（游戏 > 单机联机） | 51 | | 72 | 运动 | 52 | | 73 | 影视剪影 | 53 | | 74 | 日常 | 54 | | 76 | 料理制作 | 55 | | 81 | 料理制作 | 56 | | 82 | 电影相关 | 57 | | 98 | 机械 | 58 | | 104 | 公开课 | 59 | | 105 | 演示 | 60 | | 107 | 科技人文 | 61 | | 108 | 趣味短片 | 62 | | 119 | 鬼畜调教 | 63 | | 121 | GMV | 64 | | 122 | 演示 | 65 | | 124 | 趣味短片 | 66 | | 126 | 人力VOCALOID | 67 | | 128 | 影视剪影 | 68 | | 129 | 宅舞 | 69 | | 130 | 音乐选集 | 70 | | 136 | 音游 | 71 | | 138 | 搞笑 | 72 | | 152 | 官方延伸 | 73 | | 153 | 国产动画 | 74 | | 154 | 三次元舞蹈 | 75 | | 160 | 美食圈 | 76 | | 162 | 绘画 | 77 | 78 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Bilibili API 第三方文档 2 | 绝大部分内容根据 http://docs.bilibili.cn/wiki 官方文档进行编写 3 | > 哔哩哔哩开放平台为第三方提供了简便的合作模式，满足了网站、手机和平板电脑用户随时随地观看哔哩哔哩的需求。哔哩哔哩开放平台提供相关接口，以实现第三方WAP站和客户端等多种应用的接入。 4 | 5 | ### API 分类 6 | 7 | [作者推荐](./API.author_recommend.md)； 8 | [番剧](./API.bangumi.md)； 9 | [弹幕](./API.comment.md)； 10 | [动态](./API.dynamic.md)； 11 | 12 | [视频/专题收藏、关注](./API.favourite.md)； 13 | [视频评论](./API.feedback.md)； 14 | [好友/悄悄关注/黑名单](./API.friend.md)； 15 | 16 | [历史记录](./API.history.md)； 17 | [批量获取排行信息(首页)](./API.index.md)； 18 | [获取视频排行信息](./API.list.md)； 19 | 20 | [登录行为记录](./API.log.md)； 21 | [第三方登录](./API.login.3rd.md)； 22 | [登录](./API.login.md)； 23 | 24 | [我的信息](./API.myinfo.md)； 25 | [通知](./API.notify.md)； 26 | [视频推荐](./API.recommend.md)； 27 | [搜索](./API.search.md)； 28 | [读取/创建专题](./API.sp.md)； 29 | 30 | [番剧专题](./API.spview.md)； 31 | [搜索关键词](./API.suggest.md)； 32 | [标签](./API.tags.md)； 33 | [用户信息](./API.userinfo.md)； 34 | [获取视频信息](./API.view.md)。 35 | 36 | 37 | ### 注意事项 38 | 39 | ##### 关于滥用 40 | 以下这些，但并不限于以下这些行为都被视为滥用： 41 | a.短时间内大量操作API用于采集。 42 | b.测试帐号及密码 43 | c.其它没有提到的，但会给系统带来压力的请求行为。 44 | 45 | ##### 禁止登录 46 | 47 | 如果账号尝试登录错误次数在 30 分钟内超过 5 次则会被禁止登录一个小时，写程序的时候特别是 客户端的时候必须判断是否登录成功，如果不成功必须马上停止尝试。 48 | 49 | ##### 关于封禁 50 | 51 | 由于滥用 API 将会导致 API 被封禁，但并不影响在官方网站上的使用，封禁一定的时间后会自动解除，一般需要一个小时后才会解封，所以请小心操作，不要拿 API 进行大量测试 52 | 53 | ##### 请求地址 54 | 55 | 请求的地址为 http://api.bilibili.com/ 开头的地址 56 | 57 | ##### 请求方法 58 | 59 | 只支持 GET 方法请求数据，用其它方法会提示相关错误。 60 | 61 | ##### 关于编码 62 | 63 | 请用 UTF-8 编码进行数据传输，返回的数据也是 UTF-8 编码的。 64 | 65 | ##### 关于 UserAgent 66 | 67 | 请求的时候必须设置 UserAgent，如果不设置或者设置为不合法的（比如设置为浏览器的）也会导致账号被封禁 API。 UserAgent 的格式必须为：程序英文名称/版本 (联系邮箱) 比如：BiLiBiLi WP Client/1.0.0 (orz@loli.my) 68 | 69 | 70 | ### 通用调用参数 71 | 72 | |字段|必选|类型|说明| 73 | |----|----|----|----| 74 | |type|false|string (json/xml/jsonp)|返回数据方式 默认json| 75 | |appkey|true|string|应用appkey| 76 | |ts|true|int|当前时间截 (UNIX TIMESTAMP)| 77 | |sign|true|string|应用校验密匙| 78 | |callback|false|string|JSONp调用方式时回调函数名称| 79 | |access_key|false|string|应用在用户申请登陆后获取到的access_key 可以此access_key访问需要用户权限的操作| 80 | |platform|false|string (android/ios)|客户端平台适配及统计用| 81 | 82 | ### 通用错误代码 83 | 84 | |代码|说明| 85 | |----|----| 86 | |-1|应用程序不存在或已被封禁| 87 | |-2|Access key错误| 88 | |-3|API校验密匙错误| 89 | |-101|帐号未登陆| 90 | |-102|帐号被封停| 91 | |-103|积分不足| 92 | |-104|硬币不足| 93 | |-105|验证码错误| 94 | |-106|帐号未激活| 95 | |-107|帐号非正式会员或在适应期| 96 | |-108|应用沒有存取相应功能的权限| 97 | |-400|请求有误| 98 | |-403|权限不足| 99 | |-404|文档不存在| 100 | |-500|服务器内部错误| 101 | |-503|调用速度过快| 102 | 103 | ### 签名(sign)生成方式 104 | 105 | 把接口所需所有参数拼接，如utk=xx&time=xx，按参数名称排序，最后再拼接上密钥App-Secret，做md5加密 (callback不需要参与sign校检) 106 | 107 | ##### 代码示例 108 | 109 | PHP 版本: 110 | 111 | ``` 112 | /** 113 | * @param $params array 参数列表 114 | * @param $key 加密密钥 115 | * @return array sign:加密校验串,params:参数拼接串 116 | */ 117 | function get_sign($params, $key) { 118 | $_data = array(); 119 | ksort($params); 120 | reset($params); 121 | foreach ($params as $k => $v) { 122 | // rawurlencode 返回的转义数字必须为大写( 如%2F ) 123 | $_data[] = $k . '=' . rawurlencode($v); 124 | } 125 | $_sign = implode('&', $_data); 126 | return array( 127 | 'sign' => strtolower(md5($_sign . $key)), 128 | 'params' => $_sign, 129 | ); 130 | } 131 | define("APP_SECRET","abcdef123456"); 132 | get_sign(array("type"=>"json"),APP_SECRET); 133 | ``` 134 | 135 | JS 版本: 136 | 137 | ``` 138 |