mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2024-12-28 13:30:08 +08:00
182 lines
5.4 KiB
Markdown
182 lines
5.4 KiB
Markdown
# 搜索建议
|
||
|
||
## 获取搜索建议关键词（web端）
|
||
|
||
> https://s.search.bilibili.com/main/suggest
|
||
|
||
*请求方式：GET*
|
||
|
||
搜索建议最多提供10个候选关键词
|
||
|
||
搜索建议内容可为任意语言（中 英 日等....），中文拼音支持全拼联想词
|
||
|
||
**url参数：**
|
||
|
||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||
| --------- | ---- | ---------------------- | ------ | ------------------------ |
|
||
| term | str | 需要获得建议的输入内容 | 必要 | |
|
||
| main_ver | str | v1 | 非必要 | 固定为`v1` |
|
||
| highlight | str | 任意 | 非必要 | 有此项开启关键词高亮标签 |
|
||
|
||
**json回复：**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----------- | ---- | ------------ | ------------ |
|
||
| code | num | 返回值 | 0：成功 |
|
||
| cost | obj | 详细搜索用时 | 大概是吧？ |
|
||
| result | obj | 搜索建议结果 | |
|
||
| page caches | obj | ？？？ | 作用尚不明确 |
|
||
| sengine | obj | ？？？ | 作用尚不明确 |
|
||
| stoken | str | ？？？ | 作用尚不明确 |
|
||
|
||
`cost`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ---- | -------- | ---- |
|
||
| about | obj | 套了个娃 | |
|
||
|
||
`cost`中的`about`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------ | ---- | ---- | ---- |
|
||
| params_check | str | | |
|
||
| total | str | | |
|
||
| main_handler | str | | |
|
||
|
||
`result`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ---- | ----- | -------- | ---- |
|
||
| tag | array | 套了个娃 | |
|
||
|
||
`result`中的`tag`数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ------------------- | ---------------------- |
|
||
| 0 | obj | 第1建议关键词 | |
|
||
| n | obj | 第（n+1）建议关键词 | 按照相关程度与热度顺序 |
|
||
| 9 | obj | 第10建议关键词 | 最后一项 |
|
||
|
||
`tag`数组中的对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ---- | ---------- | ------------------------------------------------------------ |
|
||
| value | str | 关键词内容 | |
|
||
| ref | num | 0 | 作用尚不明确 |
|
||
| name | str | 显示内容 | 在无高亮显示时与`value`相同<br />有高亮显示时带有`<em class="suggest_high_light">`的xml标签 |
|
||
| spid | num | ？？？ | 作用尚不明确 |
|
||
|
||
`page caches`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ---------- | ---- | ---- | ------------ |
|
||
| save cache | str | no | 作用尚不明确 |
|
||
|
||
`sengine`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ---- | ---- | ------------ |
|
||
| usage | num | 0 | 作用尚不明确 |
|
||
|
||
**示例：**
|
||
|
||
获取关于`lei`的搜索建议，关键词带有高亮
|
||
|
||
```shell
|
||
curl -G 'https://s.search.bilibili.com/main/suggest' \
|
||
--data-urlencode 'term=lei' \
|
||
--data-urlencode 'main_ver=v1' \
|
||
--data-urlencode 'highlight='
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"cost": {
|
||
"about": {
|
||
"params_check": "0.000103",
|
||
"total": "0.011644",
|
||
"main_handler": "0.011472"
|
||
}
|
||
},
|
||
"result": {
|
||
"tag": [
|
||
{
|
||
"value": "雷军",
|
||
"ref": 0,
|
||
"name": "雷军",
|
||
"spid": 1
|
||
},
|
||
{
|
||
"value": "雷之律者",
|
||
"ref": 0,
|
||
"name": "雷之律者",
|
||
"spid": 5
|
||
},
|
||
{
|
||
"value": "LEI神",
|
||
"ref": 0,
|
||
"name": "<em class=\"suggest_high_light\">LEI</em>神",
|
||
"spid": 5
|
||
},
|
||
{
|
||
"value": "LEIGH ELLEXSON",
|
||
"ref": 0,
|
||
"name": "<em class=\"suggest_high_light\">LEI</em>GH ELLEXSON",
|
||
"spid": 5
|
||
},
|
||
{
|
||
"value": "LEICA Q2",
|
||
"ref": 0,
|
||
"name": "<em class=\"suggest_high_light\">LEI</em>CA Q2",
|
||
"spid": 5
|
||
},
|
||
{
|
||
"value": "LEIGHANNE",
|
||
"ref": 0,
|
||
"name": "<em class=\"suggest_high_light\">LEI</em>GHANNE",
|
||
"spid": 0
|
||
},
|
||
{
|
||
"value": "雷达探测姬",
|
||
"ref": 0,
|
||
"name": "雷达探测姬",
|
||
"spid": 5
|
||
},
|
||
{
|
||
"value": "雷律",
|
||
"ref": 0,
|
||
"name": "雷律",
|
||
"spid": 5
|
||
},
|
||
{
|
||
"value": "雷霆嘎巴",
|
||
"ref": 0,
|
||
"name": "雷霆嘎巴",
|
||
"spid": 5
|
||
},
|
||
{
|
||
"value": "雷霆沙赞",
|
||
"ref": 0,
|
||
"name": "雷霆沙赞",
|
||
"spid": 5
|
||
}
|
||
]
|
||
},
|
||
"page caches": {
|
||
"save cache": "no"
|
||
},
|
||
"sengine": {
|
||
"usage": 0
|
||
},
|
||
"stoken": "12344377692164099019"
|
||
}
|
||
```
|
||
|
||
</details>
|