# 话题搜索

## 搜索发布话题

> https://app.bilibili.com/x/topic/pub/search  
> https://api.bilibili.com/x/topic/pub/search

*请求方法: GET*

注: 该接口可能存在传入页面大小与返回数量不匹配的问题, 可能与访问权限有关

<!--{
  "from": {
    "url": "https://t.bilibili.com/"
    "selector": ".bili-topic-search__input__inner"
  }
}-->

**URL参数:**

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --- | --- | --- | --- | --- |
| keywords | str | 关键词 | 不必要 |  |
| content | str | 空 | 不必要 |  |
| upload_id | str | 上传 id? | 不必要 | 页面刷新第一次请求时为空, 后均非空<br />似乎为固定值, 格式: `${your_mid}_${login_or_last_refresh_or_cookie_ts}_${dig4}`, 如 `616368979_1722652786_2534` |
| page_size | int | 页大小 | 不必要 | 默认为 20 |
| page_num | int | 1 | 不必要 | 不用于翻页 |
| offset | int | 偏移 | 不必要 | 可从响应 `data.page_info.offset` 中获取 |
| web_location | str | 333.1365 | 不必要 |  |

**JSON回复:**

根对象:

| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| code | num | 返回值 | 0: 成功<br />-400: 请求错误 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 |  |
| data | obj | 信息本体 |  |

`data` 对象:

| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| new_topic | obj | 新建话题? |  |
| has_create_jurisdiction | bool | false | 是否有创建权限? |
| topic_items | array | 话题列表 |  |
| request_id | str | 请求 id |  |
| page_info | obj | 页信息 |  |

`data` 中的 `new_topic` 对象:

| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| name | str | 请求参数中的 `keywords` |  |

`data` 中的 `topic_items` 数组中的对象:

| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| id | num | 话题 id |  |
| name | str | 话题名 |  |
| view | num | 浏览数 |  |
| discuss | num | 讨论数 |  |
| stat_desc | str | 状态描述 |  |
| description | str | 话题描述 |  |
| show_interact_data | bool | false | 是否显示互动数据? |

`data` 中的 `page_info` 对象:

| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| offset | num | 下次请求可用的偏移 | 请求参数中的 `offset` + `page_size` |
| has_more | bool | 是否有更多数据 | 当没有更多时可能不存在该字段 |

**示例:**

注: 该示例就是解释开头所注的问题的一个示例

```shell
curl -G 'https://app.bilibili.com/x/topic/pub/search' \
--url-query 'keywords=2233'
```

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

```json
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "new_topic": {
      "name": "2233"
    },
    "has_create_jurisdiction": false,
    "topic_items": [
      {
        "id": 1101122,
        "name": "2233异世集",
        "view": 2502,
        "discuss": 11,
        "stat_desc": "2502浏览·11讨论",
        "description": "分享数字周边",
        "show_interact_data": false
      },
      {
        "id": 1050671,
        "name": "2233生日倒计时",
        "view": 21149,
        "discuss": 130,
        "stat_desc": "2.1万浏览·130讨论",
        "description": "2233生日倒计时",
        "show_interact_data": false
      },
      {
        "id": 1057129,
        "name": "2233手办可可爱爱",
        "view": 836,
        "discuss": 14,
        "stat_desc": "836浏览·14讨论",
        "description": "喜欢2233，",
        "show_interact_data": false
      }
    ],
    "request_id": "1$0$1723796266$7f515d4e26b7bd5007fb8ca4b066bf0b",
    "page_info": {
      "offset": 4,
      "has_more": true
    }
  }
}
```

</details>

## 推荐搜索话题?

> https://app.bilibili.com/x/topic/pub/rcmd/search  
> https://api.bilibili.com/x/topic/pub/rcmd/search

*请求方法: GET*

注: 该接口啥也不返回, 但是网页端会请求该接口

<!--{
  "from": {
    "url": "https://t.bilibili.com/"
  },
  "gh": [1083]
}-->

**URL参数:**

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --- | --- | --- | --- | --- |
| keywords | str | 空 | 不必要 |  |
| upload_id | str | 上传 id? | 不必要 | 同上 |
| web_location | str | 333.1365 | 不必要 | 有时请求不带该参数 |

**JSON回复:**

根对象:

| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| code | num | 返回值 | 0: 成功 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 |  |
| data | str | 数据本体 |  |

`data` 对象:

| 字段 | 类型 | 内容 | 备注 |
| --- | --- | -- | --- |
| topic_items | unknown[] | 空? | 可能与 [推荐话题](#推荐话题) 相同? |
| request_id | str | 请求 id | 当传入 `keywords` 时不为空|

**示例:**

```shell
curl -G 'https://app.bilibili.com/x/topic/pub/rcmd/search'
```

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

```json
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "topic_items": [],
    "request_id": ""
  }
}
```

</details>

## 推荐话题

> https://app.bilibili.com/x/topic/web/dynamic/rcmd

*请求方法: GET*

**URL 参数:**

| 参数名       | 类型   | 内容       | 必要性 | 备注 |
| ------------ | ------ | ---------- | ------ | ---- |
| source       | string | 来源       | 不必要 | 如 `Web` |
| page_size    | number | 获取数量   | 不必要 | 默认为 `9`, 留空为 `6`, 最大为 `26`, 最小为 `1` |
| web_location | string | `333.1365` | 不必要 |      |


**JSON 回复:**

根对象:

| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| code | num | 返回值 | 0: 成功 |
| message | str | 错误信息 | 成功时为 `0` |
| ttl | num | `1` |  |
| data | str | 数据本体 |  |

`data` 对象:

| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| topic_items | object[] | 话题列表 | 套了个娃 |

`data.topic_items[]` 对象:

| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| discuss | number | 讨论数 |  |
| dynamics | number | 动态数 |  |
| id | number | 话题 id |  |
| jump_url | string | 跳转 URL |  |
| name | string | 话题名 |  |
| show_interact_data | boolean | 是否显示互动数据? |  |
| view | number | 浏览数 |  |

**示例:**

```shell
curl -
```

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

```json
{
  "code": 0,
  "data": {
    "topic_items": [
      {
        "discuss": 147,
        "dynamics": 20,
        "id": 1305890,
        "jump_url": "https://m.bilibili.com/topic-detail?topic_id=1305890",
        "name": "燕云河西凉州篇预测",
        "show_interact_data": false,
        "view": 261060
      },
      {
        "discuss": 554,
        "dynamics": 24,
        "id": 1305885,
        "jump_url": "https://m.bilibili.com/topic-detail?topic_id=1305885",
        "name": "真人版驯龙高手新预告",
        "show_interact_data": false,
        "view": 472265
      },
      {
        "discuss": 24358,
        "dynamics": 57,
        "id": 1305877,
        "jump_url": "https://m.bilibili.com/topic-detail?topic_id=1305877",
        "name": "国米4-3巴萨",
        "show_interact_data": false,
        "view": 4851673
      },
      {
        "discuss": 201,
        "dynamics": 24,
        "id": 1305933,
        "jump_url": "https://m.bilibili.com/topic-detail?topic_id=1305933",
        "name": "公积金住房贷款利率下调0.25%",
        "show_interact_data": false,
        "view": 111704
      },
      {
        "discuss": 20201,
        "dynamics": 70,
        "id": 1305920,
        "jump_url": "https://m.bilibili.com/topic-detail?topic_id=1305920",
        "name": "印度巴基斯坦交火",
        "show_interact_data": false,
        "view": 12102634
      },
      {
        "discuss": 2497,
        "dynamics": 37,
        "id": 1305940,
        "jump_url": "https://m.bilibili.com/topic-detail?topic_id=1305940",
        "name": "降准降息释放什么信号",
        "show_interact_data": false,
        "view": 475373
      },
      {
        "discuss": 11970,
        "dynamics": 51,
        "id": 1305886,
        "jump_url": "https://m.bilibili.com/topic-detail?topic_id=1305886",
        "name": "淮水竹亭值得一看吗",
        "show_interact_data": false,
        "view": 3171863
      },
      {
        "discuss": 860,
        "dynamics": 38,
        "id": 1305904,
        "jump_url": "https://m.bilibili.com/topic-detail?topic_id=1305904",
        "name": "GTA6全新预告",
        "show_interact_data": false,
        "view": 202393
      },
      {
        "discuss": 576,
        "dynamics": 23,
        "id": 1305830,
        "jump_url": "https://m.bilibili.com/topic-detail?topic_id=1305830",
        "name": "默茨正式当选德国新任总理",
        "show_interact_data": false,
        "view": 280448
      }
    ]
  },
  "message": "0",
  "ttl": 1
}
```
</details>

<!-- Generated by json-apidoc-gen @ 2025-05-08T06:56:53.249280549Z -->