import{_ as n,c as t,a,o as l}from"./app-Dgsdh8A6.js";const o={};function e(p,s){return l(),t("div",null,s[0]||(s[0]=[a(`

搜索建议

获取搜索建议关键词（web端）

https://s.search.bilibili.com/main/suggest

请求方式：GET

搜索建议最多提供10个候选关键词

搜索建议内容可为任意语言（中 英 日等....），中文拼音支持全拼联想词

url参数：

参数名类型内容必要性备注
termstr需要获得建议的输入内容必要
main_verstrv1非必要默认为 v1
highlightstr任意, 无明显作用非必要默认为空
funcstr函数?非必要默认为 suggest
suggest_typestr建议类型?非必要默认为 accurate
sub_typestr子类型?非必要默认为 tag
useridnum本用户 mid非必要可能用于个性化推荐
bangumi_acc_numnum番剧累积数?非必要默认为 1
special_acc_numnum特殊累积数?非必要默认为 1
topic_acc_numnum话题累积数?非必要默认为 1
upuser_acc_numnumUP主累积数?非必要默认为 1
tag_numnumTag 数?非必要默认为 10
special_numnum特殊推荐数?非必要默认为 10
bangumi_numnum番剧推荐数?非必要默认为 10
upuser_numnumUP主推荐数?非必要默认为 3
rndnum一个随机浮点数非必要由 Math.random() 生成?
buvidstr同 Cookie 中 buvid3非必要
spmidstr333.1007非必要

json回复：

根对象：

字段类型内容备注
exp_strstr实验字符串?作用尚不明确
codenum返回值0：成功
resultobj搜索建议结果
stokenstr？？？作用尚不明确

result对象：

字段类型内容备注
tagarray套了个娃

result中的tag数组：

项类型内容备注
0obj第1建议关键词
nobj第（n+1）建议关键词按照相关程度与热度顺序
9obj第10建议关键词最后一项

tag数组中的对象：

字段类型内容备注
valuestr关键词内容
refnum0作用尚不明确
namestr显示内容带有 <em class="suggest_high_light"> 的 XML 标签
spidnum5作用尚不明确
typestr空

示例：

获取关于 洛天依 的搜索建议

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"
}
`,21)]))}const r=n(o,[["render",e]]),d=JSON.parse('{"path":"/docs/search/suggest.html","title":"搜索建议","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1724238159000,"contributors":[{"name":"SocialSisterYi","username":"SocialSisterYi","email":"1440239038@qq.com","commits":2,"url":"https://github.com/SocialSisterYi"},{"name":"SessionHu","username":"SessionHu","email":"102411014+SessionHu@users.noreply.github.com","commits":1,"url":"https://github.com/SessionHu"}],"changelog":[{"hash":"60a0c5d1a2f44fe61335da04571305fa7727a968","time":1724238159000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat: 各种接口补充与错误修正 (#1066)"},{"hash":"f6760f4be38d5b592d396b211e48c666286524de","time":1677124138000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🔨remove header index"},{"hash":"7d89ece2ac46425810647c4ac92acf5f3721cb68","time":1676998806000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🚀调整项目结构"}]},"filePathRelative":"docs/search/suggest.md"}');export{r as comp,d as data};