bilibili-API-collect/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  | 空         |                                                    |

**示例：**

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

```shell
curl -G 'https://s.search.bilibili.com/main/suggest' \
--data-urlencode 'term=洛天依'
```

<details>
<summary>查看响应示例:</summary>

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

</details>