bac

话题搜索

搜索发布话题

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

请求方法: GET

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

URL参数:

参数名	类型	内容	必要性	备注
keywords	str	关键词	不必要
content	str	空	不必要
upload_id	str	上传 id?	不必要	页面刷新第一次请求时为空, 后均非空似乎为固定值, 格式: `${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: 成功 -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	是否有更多数据	当没有更多时可能不存在该字段

示例:

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

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

查看响应示例:

```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 } } } ```

推荐搜索话题?

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