搜索建议

获取搜索建议关键词（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`相同有高亮显示时带有`<em class="suggest_high_light">`的xml标签
spid	num	？？？	作用尚不明确

page caches对象：

字段	类型	内容	备注
save cache	str	no	作用尚不明确

sengine对象：

字段	类型	内容	备注
usage	num	0	作用尚不明确

示例：

获取关于lei的搜索建议，关键词带有高亮

curl -G 'https://s.search.bilibili.com/main/suggest' \
--data-urlencode 'term=lei' \
--data-urlencode 'main_ver=v1' \
--data-urlencode 'highlight='

查看响应示例：

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

# 搜索建议

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

搜索建议

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