diff --git a/search/search.md b/search/search.md new file mode 100644 index 0000000..ec209d1 --- /dev/null +++ b/search/search.md @@ -0,0 +1,132 @@ +# 普通搜索 + +## 默认搜索(综合搜索) + +> https://api.bilibili.com/x/web-interface/search/all/v2 + +*方式:GET* + +返回和关键字相关的20条信息 + +**url参数:** + +| 参数名 | 类型 | 内容 | 含义 | 备注 | +| --------------- | ---- | --------- | ------------ | -------- | +| keyword | str | 字符串 | 搜索的关键词 | 关键词 | +| order | str | totalrank | 综合排序 | 排序方式 | +| duration | str | 0 | 全部时长 | 时长 | +| tids | str | 0 | 全部分区 | 分区代码 | +| page | str | 1 | 分页值 | 分页 | +| \_\_refresh\_\_ | str | true | | 未知 | +| highlight | str | 1 | | 未知 | +| single_column | str | 0 | | 未知 | +| context | str | 空 | | 未知 | +| tids_2 | str | 空 | | 未知 | +| \_extra | str | 空 | | 未知 | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------ | +| code | num | 返回值 | 0:成功 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | obj | 信息本体 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---------------- | ---- | ------------------ | -------------------- | +| seid | num | 搜索id | | +| page | num | 页数 | | +| pagesize | num | 每页条数 | 固定20 | +| numResults | num | 总条数 | 最大值为1000 | +| numPages | num | 分页数 | 最大值为50 | +| suggest_keyword | | 空 | 作用尚不明确 | +| rqt_type | str | search | 作用尚不明确 | +| cost_time | obj | 详细搜索用时 | 大概 | +| exp_list | obj | | 作用尚不明确 | +| egg_hit | obj | 详细分类搜索结果 | 数量页数等 | +| top_tlist | obj | 详细分类搜索结果数 | 视频、番剧等分别多少 | +| show_column | num | 0 | 作用尚不明确 | +| show_module_list | list | 返回结果类型列表 | | +| result | list | 结果列表 | | + +`result`对象: + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ------------ | ------------------------------------ | +| 列表下标 | obj | 搜索结果结果 | 包含多种类型结果,为bilibili综合搜索 | + +**示例:** + +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 + +## 分类搜索 + +> https://api.bilibili.com/x/web-interface/search/type + +*方式:GET* + +返回和关键字相关的20条信息 + +**url参数:** + +| 参数名 | 类型 | 内容 | 含义 | 备注 | +| --------------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | +| keyword | str | 字符串 | 搜索的关键词 | 关键词 | +| order | str | **totalrank**
click
pubdate
dm
stow
------
0
fans
level
------
online
live_time | **综合排序**
最多点击
最新发布
最多弹幕
最多收藏
-------------
默认排序
粉丝数
Lv等级
-------------
人气直播
最新开播 | 排序方式
------------
用户
------------
直播间 | +| order_sort | str | 0
1 | 由高到低
由低到高 | 粉丝数,Lv等级排序方式 | +| user_type | str | 0
1
2
3 | 全部用户
up主
普通用户
认证用户 | 用户分类,用户专属 | +| duration | str | **0**
1
2
3
4 | **全部时长**
10分钟以下
10-30分钟
30-60分钟
60分钟以上 | 时长 | +| tids | str | **0**
tid | **全部分区**
分区代码 | 分区代码 | +| category_id | str | **0**
2
1
28
3
29
16
17
--------
0
1
2 | **全部分区**
动画
游戏
影视
生活
兴趣
轻小说
科技
--------
全部分区
画友
摄影 | 类型,专栏专属
-----------------------
类型,相簿专属 | +| search_type | str | **video**
media_bangumi
media_ft
live
live_user
article
topic
bili_user
photo | **视频**
番剧
影视
直播
主播
专栏
话题
用户
相簿 | 搜索类型 | +| cover_type | str | user_cover
cover | 封面图
关键帧 | 直播,封面类型 | +| page | str | 1 | 分页值 | 分页 | +| \_\_refresh\_\_ | str | true | | 未知 | +| highlight | str | 1 | | 未知 | +| single_column | str | 0 | | 未知 | +| context | str | 空 | | 未知 | +| tids_2 | str | 空 | | 未知 | +| \_extra | str | 空 | | 未知 | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | --------------------------------------------- | +| code | num | 返回值 | 0:成功 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | obj | 信息本体 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---- | ---------------- | ------------ | +| seid | num | 搜索id | | +| page | num | 页数 | | +| pagesize | num | 每页条数 | 固定20 | +| numResults | num | 总条数 | 最大值为1000 | +| numPages | num | 分页数 | 最大值为50 | +| suggest_keyword | | 空 | 作用尚不明确 | +| rqt_type | str | search | 作用尚不明确 | +| cost_time | obj | 详细搜索用时 | 大概 | +| exp_list | obj | | 作用尚不明确 | +| egg_hit | obj | 详细分类搜索结果 | 数量页数等 | +| result | list | 结果列表 | | +| show_column | num | 0 | 作用尚不明确 | + +`result`对象: + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ------------ | -------------------- | +| 列表下标 | obj | 搜索结果结果 | 一般列表包含20条数据 | + +**示例:** + +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 \ No newline at end of file