Bilibili-gadget/bilibili-API-collect-master/docs/search/suggest.md

搜索建议

获取搜索建议关键词（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=洛天依'

查看响应示例:

{
  "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"
}