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
Raw

搜索建议

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