搜索建议
获取搜索建议关键词（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 |
空 |
|
示例：
获取关于 洛天依 的搜索建议
curl -G 'https://s.search.bilibili.com/main/suggest' \
--data-urlencode 'term=洛天依'
查看响应示例:
```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"
}
```