返回提交历史
Modified
README.md
+8
-3
Modified
comment/comment_list.md
+9
-8
Modified
history&toview/history.md
+2
-2
Deleted
search/search.md
+0
-132
Added
search/search_request.md
+846
-0
Added
search/search_response.md
+740
-0
Modified
user/relation.md
+66
-7
XFEstudio/bilibili-API-collect
修改并补全搜索相关
b243929
代码差异
7 个文件
+1671
-152
@@ -67,7 +67,10 @@
67
67
- [xml历史弹幕](danmaku/history.md)√
68
68
- [快照](danmaku/snapshot.md)√
69
69
- [弹幕操作](danmaku/action.md)×
70
- 高级弹幕
71
- 屏蔽管理
70
72
- [专栏](article)
73
- 分区
71
74
- [基本信息](article/info.md)×
72
75
- [点赞&投币&收藏](article/like_coin_fav.md)×
73
76
- 文集基本信息
@@ -81,10 +84,13 @@
81
84
- [排行榜&最新动态](ranking&dynamic)
82
85
- [排行榜](ranking&dynamic/ranking.md)x
83
86
- [最新动态](ranking&dynamic/dynamic.md)x
84
- 搜索
85
- 普通搜索
87
- [搜索](search)
88
- [搜索请求](search/search_request.md)×
89
- [搜索结果](search/search_response.md)√
86
90
- 热搜
91
- 搜索建议
87
92
- [小黑屋](blackroom)
93
- 基本信息
88
94
- [封禁公示](blackroom/banlist.md)√
89
95
- 仲裁信息
90
96
- [评论区](comment)
@@ -100,7 +106,6 @@
100
106
- [实时广播](broadcast)
101
107
- [总则](broadcast/general.md)√
102
108
- [视频内广播](broadcast/video_room.md)√
103
- 分区实时在线
104
109
- [充电](electric)
105
110
- [B币方式](electric/Bcoin.md)√
106
111
- [微信&支付宝方式](electric/WeChat&Alipay.md)√
@@ -7,6 +7,7 @@
7
7
| 代码 | 评论区类型 | oid的意义 |
8
8
| ---- | ----------------------- | ---------- |
9
9
| 1 | 视频 | 视频avID |
10
| 2 | 话题 | 话题ID |
10
11
| 4 | 活动 | 活动ID |
11
12
| 5 | 小视频 | 小视频ID |
12
13
| 6 | 小黑屋 | 封禁公示ID |
@@ -27,14 +28,14 @@
27
28
28
29
**url参数：**
29
30
30
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
31
| ------ | ---- | -------------- | ------ | --------------------------------------- |
32
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
33
| oid | num | 目标评论区ID | 必要 | |
34
| sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1 2：按热度 |
35
| nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 |
36
| pn | num | 页码 | 非必要 | 默认为1 |
37
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
31
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
32
| ------ | ---- | -------------- | ------ | -------------------------------------------------------- |
33
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
34
| oid | num | 目标评论区ID | 必要 | |
35
| sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1：按点赞数<br />2：按回复数 |
36
| nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 |
37
| pn | num | 页码 | 非必要 | 默认为1 |
38
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
38
39
39
40
**json回复：**
40
41
@@ -110,11 +110,11 @@
110
110
111
111
| 字段 | 类型 | 内容 | 备注 |
112
112
| -------- | ---- | ------------------- | ------------------------------------------------------------ |
113
| oid | num | 目标ID | 稿件视频&剧集：视频avID<br />直播：直播间ID<br />文章：文章cvID<br />文集：文集rlID |
113
| oid | num | 目标ID | 稿件视频&剧集（当`business=archive`或`business=pgc`时）：视频avID<br />直播（当`business=live`时）：直播间ID<br />文章（当`business=article`时）：文章cvID<br />文集（当`business=article-list`时）：文集rlID |
114
114
| epid | num | 剧集epID | 仅用于剧集 |
115
115
| bvid | str | 视频bvID | 仅用于稿件视频 |
116
116
| page | num | 观看到的视频分P数 | 仅用于稿件视频 |
117
| cid | num | 观看到的对象ID | 稿件视频&剧集：视频CID<br />文集：文章cvID |
117
| cid | num | 观看到的对象ID | 稿件视频&剧集（当`business=archive`或`business=pgc`时）：视频CID<br />文集（当`business=article-list`时）：文章cvID |
118
118
| part | str | 观看到的视频分P标题 | 仅用于稿件视频 |
119
119
| business | str | 条目类型 | **详细内容见参数** |
120
120
| dt | num | 查看平台代码 | 1 3 5 7：手机端<br />2：web端<br />4 6：pad端<br />33：TV端<br />0：其他 |
@@ -1,132 +0,0 @@
1
# 普通搜索
2
3
## 默认搜索(综合搜索)
4
5
> https://api.bilibili.com/x/web-interface/search/all/v2
6
7
*方式:GET*
8
9
返回和关键字相关的20条信息
10
11
**url参数：**
12
13
| 参数名 | 类型 | 内容 | 含义 | 备注 |
14
| --------------- | ---- | --------- | ------------ | -------- |
15
| keyword | str | 字符串 | 搜索的关键词 | 关键词 |
16
| order | str | totalrank | 综合排序 | 排序方式 |
17
| duration | str | 0 | 全部时长 | 时长 |
18
| tids | str | 0 | 全部分区 | 分区代码 |
19
| page | str | 1 | 分页值 | 分页 |
20
| \_\_refresh\_\_ | str | true | | 未知 |
21
| highlight | str | 1 | | 未知 |
22
| single_column | str | 0 | | 未知 |
23
| context | str | 空 | | 未知 |
24
| tids_2 | str | 空 | | 未知 |
25
| \_extra | str | 空 | | 未知 |
26
27
**json回复：**
28
29
根对象：
30
31
| 字段 | 类型 | 内容 | 备注 |
32
| ------- | ---- | -------- | ------------ |
33
| code | num | 返回值 | 0：成功 |
34
| message | str | 错误信息 | 默认为0 |
35
| ttl | num | 1 | 作用尚不明确 |
36
| data | obj | 信息本体 | |
37
38
`data`对象：
39
40
| 字段 | 类型 | 内容 | 备注 |
41
| ---------------- | ---- | ------------------ | -------------------- |
42
| seid | num | 搜索id | |
43
| page | num | 页数 | |
44
| pagesize | num | 每页条数 | 固定20 |
45
| numResults | num | 总条数 | 最大值为1000 |
46
| numPages | num | 分页数 | 最大值为50 |
47
| suggest_keyword | | 空 | 作用尚不明确 |
48
| rqt_type | str | search | 作用尚不明确 |
49
| cost_time | obj | 详细搜索用时 | 大概 |
50
| exp_list | obj | | 作用尚不明确 |
51
| egg_hit | obj | 详细分类搜索结果 | 数量页数等 |
52
| top_tlist | obj | 详细分类搜索结果数 | 视频、番剧等分别多少 |
53
| show_column | num | 0 | 作用尚不明确 |
54
| show_module_list | list | 返回结果类型列表 | |
55
| result | list | 结果列表 | |
56
57
`result`对象：
58
59
| 字段 | 类型 | 内容 | 备注 |
60
| -------- | ---- | ------------ | ------------------------------------ |
61
| 列表下标 | obj | 搜索结果结果 | 包含多种类型结果，为bilibili综合搜索 |
62
63
**示例：**
64
65
https://api.bilibili.com/x/web-interface/search/all/v2?context=&page=1&order=totalrank&keyword=少年&duration=0&tids_2=&__refresh__=true&_extra=&tids=0&highlight=1&single_column=0
66
67
## 分类搜索
68
69
> https://api.bilibili.com/x/web-interface/search/type
70
71
*方式:GET*
72
73
返回和关键字相关的20条信息
74
75
**url参数：**
76
77
| 参数名 | 类型 | 内容 | 含义 | 备注 |
78
| --------------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
79
| keyword | str | 字符串 | 搜索的关键词 | 关键词 |
80
| order | str | **totalrank**<br/>click<br/>pubdate<br/>dm<br/>stow<br/>------<br/>0<br/>fans<br/>level<br/>------<br/>online<br/>live_time | **综合排序**<br/>最多点击<br/>最新发布<br/>最多弹幕<br/>最多收藏<br/>-------------<br/>默认排序<br/>粉丝数<br/>Lv等级<br/>-------------<br/>人气直播<br/>最新开播 | 排序方式<br/>------------<br/>用户<br/>------------<br/>直播间 |
81
| order_sort | str | 0<br/>1 | 由高到低<br/>由低到高 | 粉丝数，Lv等级排序方式 |
82
| user_type | str | 0<br/>1<br/>2<br/>3 | 全部用户<br/>up主<br/>普通用户<br/>认证用户 | 用户分类，用户专属 |
83
| duration | str | **0**<br/>1<br/>2<br/>3<br/>4 | **全部时长**<br/>10分钟以下<br/>10-30分钟<br/>30-60分钟<br/>60分钟以上 | 时长 |
84
| tids | str | **0**<br/>tid | **全部分区**<br/>分区代码 | 分区代码 |
85
| category_id | str | **0**<br/>2<br/>1<br/>28<br/>3<br/>29<br/>16<br/>17<br/>--------<br/>0<br/>1<br/>2 | **全部分区**<br/>动画<br/>游戏<br/>影视<br/>生活<br/>兴趣<br/>轻小说<br/>科技<br/>--------<br/>全部分区<br/>画友<br/>摄影 | 类型，专栏专属<br/>-----------------------<br/>类型，相簿专属 |
86
| search_type | str | **video**<br/>media_bangumi<br/>media_ft<br/>live<br/>live_user<br/>article<br/>topic<br/>bili_user<br/>photo | **视频**<br/>番剧<br/>影视<br/>直播<br/>主播<br/>专栏<br/>话题<br/>用户<br/>相簿 | 搜索类型 |
87
| cover_type | str | user_cover<br/>cover | 封面图<br/>关键帧 | 直播，封面类型 |
88
| page | str | 1 | 分页值 | 分页 |
89
| \_\_refresh\_\_ | str | true | | 未知 |
90
| highlight | str | 1 | | 未知 |
91
| single_column | str | 0 | | 未知 |
92
| context | str | 空 | | 未知 |
93
| tids_2 | str | 空 | | 未知 |
94
| \_extra | str | 空 | | 未知 |
95
96
**json回复：**
97
98
根对象：
99
100
| 字段 | 类型 | 内容 | 备注 |
101
| ------- | ---- | -------- | --------------------------------------------- |
102
| code | num | 返回值 | 0：成功 |
103
| message | str | 错误信息 | 默认为0 |
104
| ttl | num | 1 | 作用尚不明确 |
105
| data | obj | 信息本体 | |
106
107
`data`对象：
108
109
| 字段 | 类型 | 内容 | 备注 |
110
| --------------- | ---- | ---------------- | ------------ |
111
| seid | num | 搜索id | |
112
| page | num | 页数 | |
113
| pagesize | num | 每页条数 | 固定20 |
114
| numResults | num | 总条数 | 最大值为1000 |
115
| numPages | num | 分页数 | 最大值为50 |
116
| suggest_keyword | | 空 | 作用尚不明确 |
117
| rqt_type | str | search | 作用尚不明确 |
118
| cost_time | obj | 详细搜索用时 | 大概 |
119
| exp_list | obj | | 作用尚不明确 |
120
| egg_hit | obj | 详细分类搜索结果 | 数量页数等 |
121
| result | list | 结果列表 | |
122
| show_column | num | 0 | 作用尚不明确 |
123
124
`result`对象：
125
126
| 字段 | 类型 | 内容 | 备注 |
127
| -------- | ---- | ------------ | -------------------- |
128
| 列表下标 | obj | 搜索结果结果 | 一般列表包含20条数据 |
129
130
**示例：**
131
132
https://api.bilibili.com/x/web-interface/search/type?context=&search_type=video&page=1&order=&keyword=少年&duration=&category_id=&tids_1=&tids_2=&__refresh__=true&_extra=&highlight=1&single_column=0
@@ -630,18 +630,18 @@ http://api.bilibili.com/x/relation/tags
630
630
631
631
| 字段 | 类型 | 内容 | 备注 |
632
632
| ------- | ------ | -------- | ------------------------------------------------------------ |
633
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />22104：该分组不存在<br />-101：账号未登录 |
633
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />22104：该分组不存在 |
634
634
| message | str | 错误信息 | 默认为0 |
635
635
| ttl | num | 1 | 作用尚不明确 |
636
636
| data | array | 成员列表 | |
637
637
638
638
`data`数组：
639
639
640
| 项 | 类型 | 内容 | 备注 |
641
| ---- | ---- | --------- | ---------------- |
642
| 0 | obj | 成员信息1 | |
643
| n | obj | 成员信息n | 按照添加顺序排序 |
644
| …… | num | …… | …… |
640
| 项 | 类型 | 内容 | 备注 |
641
| ---- | ---- | --------------- | ---------------- |
642
| 0 | obj | 成员信息1 | |
643
| n | obj | 成员信息（n+1） | 按照添加顺序排序 |
644
| …… | obj | …… | …… |
645
645
646
646
数组`data`中的对象：
647
647
@@ -747,7 +747,7 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1
747
747
748
748
需要登录(SESSDATA)
749
749
750
**num参数：**
750
**url参数：**
751
751
752
752
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
753
753
| ------ | ---- | ----------- | ------ | ---- |
@@ -792,6 +792,65 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221
792
792
793
793
794
794
795
### 查询所有特别关注的UID
796
797
> http://api.bilibili.com/x/relation/tag/special
798
799
需要登录(SESSDATA)
800
801
**json回复：**
802
803
根对象：
804
805
| 字段 | 类型 | 内容 | 备注 |
806
| ------- | ----- | -------- | ----------------------------- |
807
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
808
| message | str | 错误信息 | 默认为0 |
809
| ttl | num | 1 | 作用尚不明确 |
810
| data | array | 成员列表 | |
811
812
`data`数组：
813
814
| 项 | 类型 | 内容 | 备注 |
815
| ---- | ---- | -------------- | ---- |
816
| 0 | num | 成员1UID | |
817
| n | num | 成员（n+1）UID | |
818
| …… | num | …… | …… |
819
820
**示例：**
821
822
http://api.bilibili.com/x/relation/tag/special
823
824
```json
825
{
826
"code": 0,
827
"message": "0",
828
"ttl": 1,
829
"data": [
830
500716647,
831
32832243,
832
53456,
833
25944552,
834
301839556,
835
427494870,
836
319214221,
837
31949159,
838
382666849,
839
258318451,
840
15858903,
841
54992199,
842
3379951,
843
392279807,
844
23215368,
845
258150656,
846
20165629,
847
22179720
848
]
849
}
850
```
851
852
853
795
854
### 创建关注分组
796
855
797
856
<img src="/imgs/add.svg" width="100" height="100" />