返回提交历史
Added
search/search.md
+132
-0
XFEstudio/bilibili-API-collect
添加搜索接口
8d13895
代码差异
1 个文件
+132
-0
@@ -0,0 +1,132 @@
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