mirror of
https://github.com/bolucat/Archive.git
synced 2026-04-22 16:07:49 +08:00
github-action[bot]
176 lines
6.2 KiB
Markdown
176 lines
6.2 KiB
Markdown
# 搜索建议
|
|
|
|
## 获取搜索建议关键词（web端）
|
|
|
|
> https://s.search.bilibili.com/main/suggest
|
|
|
|
*请求方式：GET*
|
|
|
|
搜索建议最多提供10个候选关键词
|
|
|
|
搜索建议内容可为任意语言（中 英 日等....），中文拼音支持全拼联想词
|
|
|
|
**url参数：**
|
|
|
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
|
| --------------- | ---- | ---------------------- | ------ | ------------------------ |
|
|
| term | str | 需要获得建议的输入内容 | 必要 | |
|
|
| main_ver | str | v1 | 非必要 | 默认为 `v1` |
|
|
| highlight | str | 任意, 无明显作用 | 非必要 | 默认为空 |
|
|
| func | str | 函数? | 非必要 | 默认为 `suggest` |
|
|
| suggest_type | str | 建议类型? | 非必要 | 默认为 `accurate` |
|
|
| sub_type | str | 子类型? | 非必要 | 默认为 `tag` |
|
|
| userid | num | 本用户 mid | 非必要 | 可能用于个性化推荐 |
|
|
| bangumi_acc_num | num | 番剧累积数? | 非必要 | 默认为 `1` |
|
|
| special_acc_num | num | 特殊累积数? | 非必要 | 默认为 `1` |
|
|
| topic_acc_num | num | 话题累积数? | 非必要 | 默认为 `1` |
|
|
| upuser_acc_num | num | UP主累积数? | 非必要 | 默认为 `1` |
|
|
| tag_num | num | Tag 数? | 非必要 | 默认为 `10` |
|
|
| special_num | num | 特殊推荐数? | 非必要 | 默认为 `10` |
|
|
| bangumi_num | num | 番剧推荐数? | 非必要 | 默认为 `10` |
|
|
| upuser_num | num | UP主推荐数? | 非必要 | 默认为 `3` |
|
|
| rnd | num | 一个随机浮点数 | 非必要 | 由 `Math.random()` 生成? |
|
|
| buvid | str | 同 Cookie 中 buvid3 | 非必要 | |
|
|
| spmid | str | 333.1007 | 非必要 | |
|
|
|
|
**json回复：**
|
|
|
|
根对象：
|
|
|
|
| 字段 | 类型 | 内容 | 备注 |
|
|
| ----------- | ---- | ------------ | ------------ |
|
|
| exp_str | str | 实验字符串? | 作用尚不明确 |
|
|
| code | num | 返回值 | 0：成功 |
|
|
| result | obj | 搜索建议结果 | |
|
|
| stoken | str | ？？？ | 作用尚不明确 |
|
|
|
|
`result`对象：
|
|
|
|
| 字段 | 类型 | 内容 | 备注 |
|
|
| ---- | ----- | -------- | ---- |
|
|
| tag | array | 套了个娃 | |
|
|
|
|
`result`中的`tag`数组：
|
|
|
|
| 项 | 类型 | 内容 | 备注 |
|
|
| ---- | ---- | ------------------- | ---------------------- |
|
|
| 0 | obj | 第1建议关键词 | |
|
|
| n | obj | 第（n+1）建议关键词 | 按照相关程度与热度顺序 |
|
|
| 9 | obj | 第10建议关键词 | 最后一项 |
|
|
|
|
`tag`数组中的对象：
|
|
|
|
| 字段 | 类型 | 内容 | 备注 |
|
|
| ----- | ---- | ---------- | -------------------------------------------------- |
|
|
| value | str | 关键词内容 | |
|
|
| ref | num | 0 | 作用尚不明确 |
|
|
| name | str | 显示内容 | 带有 `<em class="suggest_high_light">` 的 XML 标签 |
|
|
| spid | num | 5 | 作用尚不明确 |
|
|
| type | str | 空 | |
|
|
|
|
**示例：**
|
|
|
|
获取关于 `洛天依` 的搜索建议
|
|
|
|
```shell
|
|
curl -G 'https://s.search.bilibili.com/main/suggest' \
|
|
--data-urlencode 'term=洛天依'
|
|
```
|
|
|
|
<details>
|
|
<summary>查看响应示例:</summary>
|
|
|
|
```json
|
|
{
|
|
"exp_str": "106301_106700",
|
|
"code": 0,
|
|
"result": {
|
|
"tag": [
|
|
{
|
|
"value": "洛天依",
|
|
"term": "洛天依",
|
|
"ref": 0,
|
|
"name": "<em class=\"suggest_high_light\">洛天依</em>",
|
|
"spid": 5,
|
|
"type": ""
|
|
},
|
|
{
|
|
"value": "洛天依十二周年",
|
|
"term": "洛天依十二周年",
|
|
"ref": 0,
|
|
"name": "<em class=\"suggest_high_light\">洛天依</em>十二周年",
|
|
"spid": 5,
|
|
"type": ""
|
|
},
|
|
{
|
|
"value": "洛天依演唱会",
|
|
"term": "洛天依演唱会",
|
|
"ref": 0,
|
|
"name": "<em class=\"suggest_high_light\">洛天依</em>演唱会",
|
|
"spid": 5,
|
|
"type": ""
|
|
},
|
|
{
|
|
"value": "洛天依手办",
|
|
"term": "洛天依手办",
|
|
"ref": 0,
|
|
"name": "<em class=\"suggest_high_light\">洛天依</em>手办",
|
|
"spid": 5,
|
|
"type": ""
|
|
},
|
|
{
|
|
"value": "洛天依歌曲",
|
|
"term": "洛天依歌曲",
|
|
"ref": 0,
|
|
"name": "<em class=\"suggest_high_light\">洛天依</em>歌曲",
|
|
"spid": 5,
|
|
"type": ""
|
|
},
|
|
{
|
|
"value": "洛天依童话镇",
|
|
"term": "洛天依童话镇",
|
|
"ref": 0,
|
|
"name": "<em class=\"suggest_high_light\">洛天依</em>童话镇",
|
|
"spid": 5,
|
|
"type": ""
|
|
},
|
|
{
|
|
"value": "洛天依东京不太热",
|
|
"term": "洛天依东京不太热",
|
|
"ref": 0,
|
|
"name": "<em class=\"suggest_high_light\">洛天依</em>东京不太热",
|
|
"spid": 5,
|
|
"type": ""
|
|
},
|
|
{
|
|
"value": "洛天依霜雪千年",
|
|
"term": "洛天依霜雪千年",
|
|
"ref": 0,
|
|
"name": "<em class=\"suggest_high_light\">洛天依</em>霜雪千年",
|
|
"spid": 5,
|
|
"type": ""
|
|
},
|
|
{
|
|
"value": "洛天依生日会",
|
|
"term": "洛天依生日会",
|
|
"ref": 0,
|
|
"name": "<em class=\"suggest_high_light\">洛天依</em>生日会",
|
|
"spid": 5,
|
|
"type": ""
|
|
},
|
|
{
|
|
"value": "洛天依生日",
|
|
"term": "洛天依生日",
|
|
"ref": 0,
|
|
"name": "<em class=\"suggest_high_light\">洛天依</em>生日",
|
|
"spid": 5,
|
|
"type": ""
|
|
}
|
|
]
|
|
},
|
|
"stoken": "4020133863501304726"
|
|
}
|
|
```
|
|
|
|
</details>
|