Skip to content

Latest commit

 

History

History
181 lines (151 loc) · 5.43 KB

suggest.md

File metadata and controls

181 lines (151 loc) · 5.43 KB

搜索建议

获取搜索建议关键词(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"
}