From 91dc5508fa0c55fda0db3d61ab2a77a3a35cf22c Mon Sep 17 00:00:00 2001
From: SessionHu <102411014+SessionHu@users.noreply.github.com>
Date: Thu, 8 May 2025 22:29:12 +0800
Subject: [PATCH] =?UTF-8?q?feat(dynamic/topic.md):=20=E6=8E=A8=E8=8D=90?=
 =?UTF-8?q?=E8=AF=9D=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

close #1271
---
 docs/dynamic/topic.md | 153 +++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 151 insertions(+), 2 deletions(-)

diff --git a/docs/dynamic/topic.md b/docs/dynamic/topic.md
index 570367d..34f961c 100644
--- a/docs/dynamic/topic.md
+++ b/docs/dynamic/topic.md
@@ -61,7 +61,7 @@
 | --- | --- | --- | --- |
 | id | num | 话题 id |  |
 | name | str | 话题名 |  |
-| view | num | 观看数 |  |
+| view | num | 浏览数 |  |
 | discuss | num | 讨论数 |  |
 | stat_desc | str | 状态描述 |  |
 | description | str | 话题描述 |  |
@@ -175,7 +175,7 @@ curl -G 'https://app.bilibili.com/x/topic/pub/search' \
 
 | 字段 | 类型 | 内容 | 备注 |
 | --- | --- | -- | --- |
-| topic_items | array | 空 |  |
+| topic_items | unknown[] | 空? | 可能与 [推荐话题](#推荐话题) 相同? |
 | request_id | str | 请求 id | 当传入 `keywords` 时不为空|
 
 **示例:**
@@ -200,3 +200,152 @@ curl -G 'https://app.bilibili.com/x/topic/pub/rcmd/search'
 ```
 
 </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 -->