返回提交历史
Modified
README.md
+18
-10
Added
video/tags.md
+273
-0
XFEstudio/bilibili-API-collect
添加视频TAG相关
b25a968
代码差异
2 个文件
+291
-10
@@ -15,7 +15,7 @@
15
15
计划整理分类&目录：（√代表已完成，x代表正在施工...）
16
16
17
17
- cookie
18
- [图片格式化](other/picture.md)
18
- [图片格式化](other/picture.md)√
19
19
- [登录](login)
20
20
- [二维码登录](login/QR.md)√
21
21
- 密码&短信登录
@@ -36,7 +36,7 @@
36
36
- [状态数](video/status_number.md)√
37
37
- [快照](video/snapshot.md)√
38
38
- [点赞&投币&收藏](video/like_coin_fav.md)√
39
- TAG
39
- [TAG](video/tags.md)x
40
40
- [视频推荐](video/recommend.md)√
41
41
- 播放&下载地址
42
42
- 互动视频
@@ -131,6 +131,20 @@ B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/rea
131
131
132
132
**相关项目**：
133
133
134
库及文档：
135
136
https://github.com/jingyuexing/bilibiliAPI
137
138
https://github.com/fython/BilibiliAPIDocs
139
140
https://github.com/czp3009/bilibili-api
141
142
https://github.com/Vespa314/bilibili-api
143
144
https://github.com/Hsury/Bilibili-Toolkit
145
146
成品：
147
134
148
https://github.com/zyzsdy/biliroku
135
149
136
150
https://github.com/bilibili-helper/bilibili-helper-o
@@ -143,15 +157,9 @@ https://github.com/Hsury/BiliDrive
143
157
144
158
https://github.com/Tsuk1ko/bilibili-live-chat
145
159
146
https://github.com/SocialSisterYi/bv2av_convert
147
148
https://github.com/fython/BilibiliAPIDocs
149
150
https://github.com/czp3009/bilibili-api
151
152
https://github.com/Vespa314/bilibili-api
160
其他：
153
161
154
162
https://github.com/Hsury/Geetest3-Crack
155
163
156
https://github.com/Hsury/Bilibili-Toolkit
164
https://github.com/SocialSisterYi/bv2av_convert
157
165
@@ -0,0 +1,273 @@
1
# 视频TAG
2
3
## 获取视频TAG信息
4
5
> http://https://api.bilibili.com/x/tag/archive/tags
6
7
*方式：GET*
8
9
**参数：**
10
11
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
12
| ------ | ---- | -------- | ------ | ------------------ |
13
| aid | url | 视频avID | 非必要 | avID与bvID任选一个 |
14
| bvid | url | 视频bvID | 非必要 | avID与bvID任选一个 |
15
16
**json回复：**
17
18
根对象：
19
20
| 字段 | 类型 | 内容 | 备注 |
21
| ------- | ------ | -------- | ---------------------------- |
22
| code | num | 返回值 | 0：成功 <br />-400：请求错误 |
23
| message | str | 错误信息 | 默认为0 |
24
| ttl | num | 1 | 作用尚不明确 |
25
| data | arrary | TAG列表 | 无TAG为空 |
26
27
`data`数组：
28
29
| 项 | 类型 | 内容 | 备注 |
30
| ---- | ---- | -------------- | ---- |
31
| 0 | obj | 第1个TAG | |
32
| n | obj | 第（n+1）个TAG | |
33
| …… | obj | …… | …… |
34
35
`data`数组中的对象：
36
37
| 字段 | 类型 | 内容 | 备注 |
38
| ------------- | ---- | -------------- | ------------------------------------------------------------ |
39
| tag_id | num | TAGID | |
40
| tag_name | str | TAG名称 | |
41
| cover | str | TAG图片url | |
42
| head_cover | str | TAG页面头图url | |
43
| content | str | TAG介绍 | |
44
| short_content | str | TAG简介 | |
45
| type | num | ？？？ | |
46
| state | num | 0 | |
47
| ctime | num | 创建时间 | 时间戳 |
48
| count | obj | 状态数 | |
49
| is_atten | num | 是否关注 | 0：未关注<br />1：已关注<br />需要登录(SESSDATA) <br />未登录为0 |
50
| likes | num | 0 | 作用尚不明确 |
51
| hates | num | 0 | 作用尚不明确 |
52
| attribute | num | 0 | 作用尚不明确 |
53
| liked | num | 是否已经点赞 | 0：未点赞<br />1：已点赞<br />需要登录(SESSDATA) <br />未登录为0 |
54
| hated | num | 是否已经点踩 | 0：未点踩<br />1：已点踩<br />需要登录(SESSDATA) <br />未登录为0 |
55
56
`data`数组中的对象中的`count`对象：
57
58
| 字段 | 类型 | 内容 | 备注 |
59
| ----- | ---- | ------------- | ------------ |
60
| view | num | 0 | 作用尚不明确 |
61
| use | num | 视频添加TAG数 | |
62
| atten | num | TAG关注 | |
63
64
**示例：**
65
66
查询视频`av89772773`/`BV1M741177Kg`的TAG
67
68
http://api.bilibili.com/x/tag/archive/tags?aid=89772773
69
70
同http://api.bilibili.com/x/tag/archive/tags?bvid=BV1M741177Kg
71
72
```json
73
{
74
"code": 0,
75
"message": "0",
76
"ttl": 1,
77
"data": [{
78
"tag_id": 12620189,
79
"tag_name": "异度侵入",
80
"cover": "",
81
"head_cover": "",
82
"content": "",
83
"short_content": "",
84
"type": 1,
85
"state": 0,
86
"ctime": 1576235749,
87
"count": {
88
"view": 0,
89
"use": 6392,
90
"atten": 8938
91
},
92
"is_atten": 1,
93
"likes": 1,
94
"hates": 0,
95
"attribute": 0,
96
"liked": 0,
97
"hated": 0
98
}, {
99
"tag_id": 7520816,
100
"tag_name": "bilibili新星计划",
101
"cover": "",
102
"head_cover": "",
103
"content": "",
104
"short_content": "",
105
"type": 4,
106
"state": 0,
107
"ctime": 1529717850,
108
"count": {
109
"view": 0,
110
"use": 1967314,
111
"atten": 65082
112
},
113
"is_atten": 0,
114
"likes": 0,
115
"hates": 0,
116
"attribute": 0,
117
"liked": 0,
118
"hated": 0
119
}, {
120
"tag_id": 707,
121
"tag_name": "ED",
122
"cover": "",
123
"head_cover": "",
124
"content": "",
125
"short_content": "",
126
"type": 3,
127
"state": 0,
128
"ctime": 1436866637,
129
"count": {
130
"view": 0,
131
"use": 62646,
132
"atten": 75642
133
},
134
"is_atten": 1,
135
"likes": 0,
136
"hates": 0,
137
"attribute": 0,
138
"liked": 0,
139
"hated": 0
140
}, {
141
"tag_id": 1394,
142
"tag_name": "动漫",
143
"cover": "http://i0.hdslb.com/bfs/tag/d08c5fe17ceb793e7ce95d9c67392743b33b46d0.jpg",
144
"head_cover": "",
145
"content": " “动漫”是动画和漫画的合称与缩写。在其他语言相当少用。随着现代传媒技术的发展，动画（animation或anime）和漫画（comics，manga；特别是故事性漫画）之间联系日趋紧密，两者常被合而为“动漫”。\n 由于漫画本身的发展形成了现代故事漫画的表现形式，将影视艺术融入漫画之中，使得漫画与动画更容易结合，影视艺术独特的地方在于它能通过镜头的推拉摇移和片段剪辑的蒙太奇技巧来表达想法和感受。漫画正是吸收了影视艺术的这两个特点。当讲述的故事越发复杂、人物越发丰富的时候，传统单线式叙事的方法就越行不通，蒙太奇的介入就成为一种需要了；当漫画家在传统表现手段中无法找到更合适的抒发感情的方法的时候，当读者需要作品有更强的冲击力和表现力的时候，各种镜头的灵活运用就成为一种必需了。一部现代故事漫画往往集远、中、近、特四种镜头于一身，漫画家往往能熟练地运用镜头的移动和各种蒙太奇剪接，对故事特定部分的情绪和氛围进行渲染。这就是现代故事漫画容易和动画结合的一个原因，因为它天生就像动画的分镜头剧本，读者在看漫画时如同在看一部电影。正是有着这样的相似性所以如今将动画和漫画合称为“动漫”。",
146
"short_content": "",
147
"type": 3,
148
"state": 0,
149
"ctime": 1436866637,
150
"count": {
151
"view": 0,
152
"use": 1134143,
153
"atten": 113030
154
},
155
"is_atten": 0,
156
"likes": 0,
157
"hates": 0,
158
"attribute": 0,
159
"liked": 0,
160
"hated": 0
161
}, {
162
"tag_id": 13289329,
163
"tag_name": "异度侵入ed原图",
164
"cover": "",
165
"head_cover": "",
166
"content": "",
167
"short_content": "",
168
"type": 1,
169
"state": 0,
170
"ctime": 1581948411,
171
"count": {
172
"view": 0,
173
"use": 3,
174
"atten": 0
175
},
176
"is_atten": 0,
177
"likes": 0,
178
"hates": 0,
179
"attribute": 0,
180
"liked": 0,
181
"hated": 0
182
}]
183
}
184
```
185
186
187
188
## 点赞&取消点赞视频TAG（暂不支持bvID）
189
190
> http://api.bilibili.com/x/tag/archive/like2
191
192
*方式：POST*
193
194
需要登录(SESSDATA)
195
196
重复访问为取消
197
198
**参数（ application/x-www-form-urlencoded ）：**
199
200
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
201
| ------ | ---- | ------------------- | ------ | ---- |
202
| aid | data | 视频avID | 必要 | |
203
| tag_id | data | TAGID | 必要 | |
204
| csrf | data | cookies中的bili_jct | 必要 | |
205
206
**json回复：**
207
208
根对象：
209
210
| 字段 | 类型 | 内容 | 备注 |
211
| ------- | ---- | -------- | ---------------------------- |
212
| code | num | 返回值 | 0：成功 <br />-400：请求错误 |
213
| message | str | 错误信息 | 默认为0 |
214
| ttl | num | 1 | 作用尚不明确 |
215
216
**示例：**
217
218
为视频`av89772773`的TAG`TAGID=12620189`点赞
219
220
curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=89772773&tag_id=12620189" "http://api.bilibili.com/x/tag/archive/like2"
221
222
```json
223
{
224
"code": 0,
225
"message": "0",
226
"ttl": 1
227
}
228
```
229
230
231
232
## 点踩&取消点踩视频TAG（暂不支持bvID）
233
234
> http://api.bilibili.com/x/tag/archive/hate2
235
236
*方式：POST*
237
238
需要登录(SESSDATA)
239
240
重复访问为取消
241
242
**参数（ application/x-www-form-urlencoded ）：**
243
244
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
245
| ------ | ---- | ------------------- | ------ | ---- |
246
| aid | data | 视频avID | 必要 | |
247
| tag_id | data | TAGID | 必要 | |
248
| csrf | data | cookies中的bili_jct | 必要 | |
249
250
**json回复：**
251
252
根对象：
253
254
| 字段 | 类型 | 内容 | 备注 |
255
| ------- | ---- | -------- | ---------------------------- |
256
| code | num | 返回值 | 0：成功 <br />-400：请求错误 |
257
| message | str | 错误信息 | 默认为0 |
258
| ttl | num | 1 | 作用尚不明确 |
259
260
**示例：**
261
262
为视频`av89772773`的TAG`TAGID=7520816`点踩
263
264
curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=89772773&tag_id=7520816" "http://api.bilibili.com/x/tag/archive/hate2"
265
266
```json
267
{
268
"code": 0,
269
"message": "0",
270
"ttl": 1
271
}
272
```
273