返回提交历史
Modified
docs/video/recommend.md
+124
-2
XFEstudio/bilibili-API-collect
feat: 新增获取首页视频推荐列表 (#733)
* feat: 新增获取首页视频推荐列表 Update: recommend.md * typo: https 改为 http * feat: 新增获取首页视频推荐列表
21c7f54
代码差异
1 个文件
+124
-2
@@ -1,5 +1,10 @@
1
1
# 视频推荐
2
2
3
- [获取单视频推荐列表（web端）](#获取单视频推荐列表（web端）)
4
- [获取首页视频推荐列表（web端）](#获取首页视频推荐列表（web端）)
5
6
---
7
3
8
## 获取单视频推荐列表（web端）
4
9
5
10
> https://api.bilibili.com/x/web-interface/archive/related
@@ -46,14 +51,14 @@
46
51
avid方式：
47
52
48
53
```shell
49
curl -G 'https://api.bilibili.com/x/web-interface/archive/related' \
54
curl -G 'http://api.bilibili.com/x/web-interface/archive/related' \
50
55
--data-urlencode 'aid=7'
51
56
```
52
57
53
58
bvid方式：
54
59
55
60
```shell
56
curl -G 'https://api.bilibili.com/x/web-interface/archive/related' \
61
curl -G 'http://api.bilibili.com/x/web-interface/archive/related' \
57
62
--data-urlencode 'bvid=BV1xx411c7m9'
58
63
```
59
64
@@ -288,3 +293,120 @@ curl -G 'https://api.bilibili.com/x/web-interface/archive/related' \
288
293
```
289
294
290
295
</details>
296
297
298
## 获取首页视频推荐列表（web端）
299
300
> https://api.bilibili.com/x/web-interface/index/top/rcmd
301
302
*请求方式：GET*
303
304
认证方式：Cookie（SESSDATA）
305
306
最多获取14条推荐视频
307
308
**url参数：**
309
310
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
311
|--------------|-----|---------------------------|-----|------------------------------|
312
| fresh_type | num | 相关性 | 非必要 | 默认为3 <br /> 值越大推荐内容越相关 |
313
| version | num | web端新旧版本:0为旧版本1为新版本 | 非必要 | 默认为0 <br /> 1,0分别为新旧web端 |
314
| ps | num | pagesize 单页返回的记录条数默认为10或8 | 非必要 | 默认为10 <br /> 当version为1时默认为8 |
315
| fresh_idx | num | 翻页相关 | 非必要 | 默认为1 <br /> 与翻页相关 |
316
| fresh_idx_1h | num | 翻页相关 | 非必要 | 默认为1 <br /> 与翻页相关 |
317
318
**json回复：**
319
320
根对象：
321
322
| 字段 | 类型 | 内容 | 备注 |
323
|-------------|-------|------|----------------------|
324
| code | num | 返回值 | 0：成功 <br />-400：请求错误 |
325
| message | str | 错误信息 | 默认为0 |
326
| ttl | num | 1 | |
327
| data | array | 推荐列表 | |
328
| userfeature | str | 用户功能 | |
329
| abtest | obj | 用户分组 | |
330
331
`data`数组：
332
333
| 项 | 类型 | 内容 | 备注 |
334
|-----| ---- |-----------| ---- |
335
| 0 | obj | 推荐视频1 | |
336
| n | obj | 推荐视频(n+1) | |
337
| …… | obj | …… | …… |
338
| 13 | obj | 推荐视频13 | |
339
340
`data`数组中的对象：
341
342
基本同「[获取视频详细信息（web端）](info.md#获取视频详细信息（web端）)」中的data对象
343
344
`abtest`对象:
345
346
| 字段 | 类型 | 内容 | 备注 |
347
|-------|-----|------|-----|
348
| group | str | 用户分组 | |
349
350
**示例：**
351
352
获取新版web端首页推荐视频列表
353
354
```shell
355
curl -G 'http://api.bilibili.com/x/web-interface/index/top/rcmd' \
356
--data-urlencode 'fresh_type=3' \
357
--data-urlencode 'version=1' \
358
--data-urlencode 'ps=10' \
359
--data-urlencode 'fresh_idx=1' \
360
--data-urlencode 'fresh_idx_1h=1'
361
```
362
363
<details>
364
<summary>查看响应示例：</summary>
365
366
```json
367
{
368
"code": 0,
369
"message": "0",
370
"ttl": 1,
371
"data": {
372
"item": [
373
{
374
"id": 511495739,
375
"bvid": "BV1Cu411z7mG",
376
"cid": 717978243,
377
"goto": "av",
378
"uri": "http://www.bilibili.com/video/BV1Cu411z7mG",
379
"pic": "http://i2.hdslb.com/bfs/archive/e05f487bc9f26baa568f10fe69a0e1ea5e0fbc23.jpg",
380
"title": "请大家助力我的梦想！为凑够10万赞，在街头唱《Be Crazy For Me》！",
381
"duration": 199,
382
"pubdate": 1652605500,
383
"owner": {
384
"mid": 1723817,
385
"name": "樱萍Apple",
386
"face": "http://i2.hdslb.com/bfs/face/6e0fa1bdbbf7e0dd929d968df3b57ca99d187e25.jpg"
387
},
388
"stat": {
389
"view": 263169,
390
"like": 39871,
391
"danmaku": 543
392
},
393
"avfeature": "{\"ctr\":0.192554,\"wdur\":2.323159,\"duration\":213.318313,\"wdlks\":0.685926,\"multi_score_0\":0.452564,\"multi_score_1\":0.112414,\"multi_score_2\":0.03976,\"rankscore\":13.906487,\"av_play\":258890,\"av_like\":39224,\"av_coin\":7165,\"reason_type\":3,\"av_feature\":\"|real_matchtype -1 |s_e online_av2av_v2 |source_len 1 |m_k_w 0 \"}",
394
"isfollowed": 0,
395
"rcmdreason": {
396
"content": "3万点赞",
397
"reasontype": 3
398
},
399
"showinfo": 1,
400
"trackid": "web_pegasus_0.shylf-ai-recsys-1355.165525355529.398"
401
}
402
......
403
],
404
"userfeature": "{\"enter_rank\":1500,\"is_fallback\":0,\"s_fresh_idx\":41,\"s_fresh_idx_session\":31,\"s_session_idx\":1,\"fresh_idx\":1,\"fresh_idx_1h\":1}",
405
"abtest": {
406
"group": "b"
407
}
408
}
409
}
410
```
411
412
</details>