默认搜索&热搜
获取默认搜索内容（web端）
https://api.bilibili.com/x/web-interface/wbi/search/default
~~https://api.bilibili.com/x/web-interface/search/default~~ （旧链接）
请求方式：GET
鉴权方式：Wbi 签名
默认搜索为搜索框中默认填充内容，用于官方推荐内容，若不输入点击搜索按钮跳转为url中的链接
json回复：
根对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| seid | str | 搜索seid | |
| id | num | 默认搜索id | |
| type | num | 0 | |
| show_name | str | 显示文字 | |
| name | str | 空 | |
| goto_type | num | 跳转类型 | 1：视频 |
| goto_value | str | 搜索目标id | 视频：稿件avid |
| url | str | 搜索目标跳转url |
示例：
curl 'https://api.bilibili.com/x/web-interface/search/default'
查看响应示例：
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"seid": "17607543598496143098",
"id": 3296036255232726331,
"type": 0,
"show_name": "歪果仁在中国做模特能赚多少钱？",
"name": "",
"goto_type": 1,
"goto_value": "243920322",
"url": "https://www.bilibili.com/video/BV1Tv411q7gx"
}
}
获取热搜列表
https://api.bilibili.com/x/web-interface/wbi/search/square ~~https://api.bilibili.com/x/web-interface/search/square~~
请求方式: GET
URL参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| limit | num | 结果限制 | 必要 | 范围 [1, 50] |
| platform | str | 平台标识 | 不必要 | web: web 端 |
JSON回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0: 成功 -400: 请求错误 |
| message | str | 错误信息 | 默认为空 |
| ttl | num | 1 | |
| data | obj | 数据本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| trending | obj | 热搜榜单 | 套了个娃 |
data中的trending对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| title | str | 标题 | |
| trackid | str | 跟踪 ID? | |
| list | array | 热搜列表 | |
| top_list | array | 空 |
trending中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 热搜 1 | |
| 1 | obj | 热搜 2 | |
| …… | obj | …… | |
| n | obj | 热搜 (n+1) |
list数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| keyword | str | 关键词 | |
| show_name | str | 显示文字 | |
| icon | str | 图标 URL | |
| uri | str | 空 | |
| goto | str | 空 |
示例:
获取热搜列表, 数量限制 4
curl -G --url 'https://api.bilibili.com/x/web-interface/search/square' \
--url-query 'limit=4'
查看响应示例:
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"trending": {
"title": "bilibili热搜",
"trackid": "8079760748892487175",
"list": [
{
"keyword": "马克龙祝贺中国世界前两名",
"show_name": "马克龙祝贺中国世界前两名",
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221213/eaf2dd702d7cc14d8d9511190245d057/lrx9rnKo24.png",
"uri": "",
"goto": ""
},
{
"keyword": "小孩电竞世界杯夺冠",
"show_name": "小孩电竞世界杯夺冠",
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221213/eaf2dd702d7cc14d8d9511190245d057/lrx9rnKo24.png",
"uri": "",
"goto": ""
},
{
"keyword": "孙颖莎说我全勤下班了",
"show_name": "孙颖莎说我全勤下班了",
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221118/eaf2dd702d7cc14d8d9511190245d057/UF7B1wVKT2.png",
"uri": "",
"goto": ""
},
{
"keyword": "7月广东新冠新增一万余例",
"show_name": "7月广东新冠新增一万余例",
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221213/eaf2dd702d7cc14d8d9511190245d057/lrx9rnKo24.png",
"uri": "",
"goto": ""
}
],
"top_list": []
}
}
}
获取热搜列表（web端）
https://s.search.bilibili.com/main/hotword
请求方式：GET
榜单每隔固定时间统计一次，请求后返回搜索前10的关键词
带有转义
json回复：
根对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| exp_str | str | ？？？ | |
| code | num | 返回值 | 0：成功 |
| cost | obj | 详细搜索用时 | 大概是吧？ |
| seid | str | 搜索seid | |
| timestamp | num | 榜单统计时间 | 时间戳 |
| message | str | 错误信息 | 默认为success |
| list | array | 热搜列表 |
list数组：
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 榜单第1名 | |
| n | obj | 榜单第（n+1）名 | 按照名次顺序 |
| 10 | obj | 榜单第10名 | 最后一项 |
list数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| status | str | 空 | |
| hot_id | num | 热词id | 大概是吧？ |
| keyword | str | 关键词 | |
| resource_id | num | 资源id | |
| goto_type | num | 0 | |
| res | array | null | |
| show_name | str | 完整关键词 | |
| pos | num | 名次 | 1-10 |
| word_type | num | 条目属性 | 4: 新 5: 热 6: [雾,咒,小丑(愚人节)] 具体看icon7: 直播中 8: 默认(无标签) 9: 梗 11: 话题 12: 独家 |
| id | num | 名次 | 1-10 |
| goto_value | str | 空 | |
| live_id | array | null | |
| name_type | str | 空 | |
| icon | str | 图标url |
示例：
curl 'https://s.search.bilibili.com/main/hotword'
查看响应示例：
{
"exp_str": "8104#8200#8300#8401#8500#5502#6699",
"code": 0,
"cost": {
"reas_request": "0.001895",
"params_check": "0.000127",
"reas_response_format": "0.000098",
"deserialize_response": "0.000080",
"reas_request_format": "0.000076",
"total": "0.002479",
"main_handler": "0.002252"
},
"seid": "9318821020548476185",
"timestamp": 1596034742,
"message": "success",
"list": [{
"status": "",
"hot_id": 11003,
"keyword": "流浪地球2刘德华",
"resource_id": 0,
"goto_type": 0,
"res": [
],
"show_name": "流浪地球2刘德华造型",
"pos": 1,
"word_type": 8,
"id": 1,
"goto_value": "",
"live_id": [
],
"name_type": "",
"icon": "http://i0.hdslb.com/bfs/feed-admin/e9e7a2d8497d4063421b685e72680bf1cfb99a0d.png"
},
{
"status": "",
"hot_id": 11012,
"keyword": "QQ飞车手游飞跃黄河",
"resource_id": 0,
"goto_type": 0,
"res": [
],
"show_name": "QQ飞车手游飞跃黄河",
"pos": 2,
"word_type": 8,
"id": 2,
"goto_value": "",
"live_id": [
],
"name_type": "",
"icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png"
},
{
"status": "",
"hot_id": 10996,
"keyword": "西工大遭网络攻击最新调查",
"resource_id": 0,
"goto_type": 0,
"res": [
],
"show_name": "西工大遭网络攻击最新调查",
"pos": 3,
"word_type": 8,
"id": 3,
"goto_value": "",
"live_id": [
],
"name_type": "",
"icon": "http://i0.hdslb.com/bfs/feed-admin/e9e7a2d8497d4063421b685e72680bf1cfb99a0d.png"
},
{
"status": "",
"hot_id": 11004,
"keyword": "EDG 起诉",
"resource_id": 0,
"goto_type": 0,
"res": [
],
"show_name": "EDGJieJie已起诉多家企业",
"pos": 4,
"word_type": 8,
"id": 4,
"goto_value": "",
"live_id": [
],
"name_type": "",
"icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png"
},
{
"status": "",
"hot_id": 10992,
"keyword": "隐入尘烟",
"resource_id": 0,
"goto_type": 0,
"res": [
],
"show_name": "隐入尘烟全平台下架",
"pos": 5,
"word_type": 8,
"id": 5,
"goto_value": "",
"live_id": [
],
"name_type": "",
"icon": "http://i0.hdslb.com/bfs/feed-admin/e9e7a2d8497d4063421b685e72680bf1cfb99a0d.png"
},
{
"status": "",
"hot_id": 10987,
"keyword": "原神半年内最良心封神池",
"resource_id": 0,
"goto_type": 0,
"res": [
],
"show_name": "原神半年内最良心封神池",
"pos": 6,
"word_type": 8,
"id": 6,
"goto_value": "",
"live_id": [
],
"name_type": "",
"icon": ""
},
{
"status": "",
"hot_id": 10988,
"keyword": "高校回应设国内首个元宇宙院系",
"resource_id": 0,
"goto_type": 0,
"res": [
],
"show_name": "高校回应设国内首个元宇宙院系",
"pos": 7,
"word_type": 8,
"id": 7,
"goto_value": "",
"live_id": [
],
"name_type": "",
"icon": ""
},
{
"status": "",
"hot_id": 10994,
"keyword": "美宇宙飞船成功撞击小行星",
"resource_id": 0,
"goto_type": 0,
"res": [
],
"show_name": "美宇宙飞船成功撞击小行星",
"pos": 8,
"word_type": 8,
"id": 8,
"goto_value": "",
"live_id": [
],
"name_type": "",
"icon": ""
},
{
"status": "",
"hot_id": 10991,
"keyword": "你薅的羊毛可能已违法",
"resource_id": 0,
"goto_type": 0,
"res": [
],
"show_name": "你薅的羊毛可能已违法",
"pos": 9,
"word_type": 8,
"id": 9,
"goto_value": "",
"live_id": [
],
"name_type": "",
"icon": ""
},
{
"status": "",
"hot_id": 11013,
"keyword": "辛普森一家",
"resource_id": 0,
"goto_type": 0,
"res": [
],
"show_name": "辛普森一家",
"pos": 10,
"word_type": 8,
"id": 10,
"goto_value": "",
"live_id": [
],
"name_type": "",
"icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png"
}
]
}
获取热搜列表（手机端）
https://app.bilibili.com/x/v2/search/trending/ranking
请求方式：GET
榜单每隔固定时间统计一次
带有转义
url参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| limit | num | 热搜数量 | 非必要 | 留空为20, 最大为100 |
json回复：
根对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 返回值 | 默认为1 |
data对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| trackid | num | 不知用途 | |
| list | array | 热搜列表 |
list数组：
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 榜单第1名 | |
| n | obj | 榜单第（n+1）名 | 按照名次顺序 |
| 20/limit | obj | 榜单第20名 | 最后一项 |
list数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| position | num | 名次 | 1-20/limit |
| keyword | str | 关键词 | |
| show_name | str | 完整关键词 | |
| word_type | num | 条目属性 | 同 web 端 |
| icon | str | 图标url | |
| hot_id | num | 热词id | 大概是吧？ |
示例：
curl 'https://app.bilibili.com/x/v2/search/trending/ranking'
查看响应示例：
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"trackid": "2578006123492681222",
"list": [{
"position": 1,
"keyword": "列车延误乘务员哽咽安抚乘客",
"show_name": "列车延误乘务员哽咽安抚乘客",
"word_type": 5,
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221213/eaf2dd702d7cc14d8d9511190245d057/lrx9rnKo24.png",
"hot_id": 107814,
"is_commercial": "0"
}, {
"position": 2,
"keyword": "黑神话悟空首次线下试玩",
"show_name": "黑神话悟空首次线下试玩",
"word_type": 5,
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221213/eaf2dd702d7cc14d8d9511190245d057/lrx9rnKo24.png",
"hot_id": 107781,
"is_commercial": "0"
}, {
"position": 3,
"keyword": "22万人打出9.9分的动画",
"show_name": "22万人打出9.9分的动画",
"word_type": 6,
"icon": "https://i0.hdslb.com/bfs/legacy/463fa23613670218608e68247a137dd071c0e9c8.png",
"hot_id": 107818,
"is_commercial": "0"
}, {
"position": 4,
"keyword": "冰冻近五万年线虫被复活",
"show_name": "冰冻近五万年线虫被复活",
"word_type": 5,
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221213/eaf2dd702d7cc14d8d9511190245d057/lrx9rnKo24.png",
"hot_id": 107774,
"is_commercial": "0"
}, {
"position": 5,
"keyword": "LNG前任和现任的较量",
"show_name": "LNG前任和现任的较量",
"word_type": 4,
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221118/eaf2dd702d7cc14d8d9511190245d057/UF7B1wVKT2.png",
"hot_id": 107853,
"is_commercial": "0"
}, {
"position": 6,
"keyword": "LOL手游剑姬女警新皮",
"show_name": "LOL手游剑姬女警新皮",
"word_type": 8,
"hot_id": 107841,
"is_commercial": "0"
}, {
"position": 7,
"keyword": "抽奖中金条却因过号被取消",
"show_name": "抽奖中金条却因过号被取消",
"word_type": 8,
"hot_id": 107817,
"is_commercial": "0"
}, {
"position": 8,
"keyword": "雪王到长城开蜜雪冰城",
"show_name": "雪王到长城开蜜雪冰城",
"word_type": 4,
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221118/eaf2dd702d7cc14d8d9511190245d057/UF7B1wVKT2.png",
"hot_id": 107849,
"is_commercial": "0"
}, {
"position": 9,
"keyword": "堡垒之夜联动终结者",
"show_name": "堡垒之夜联动终结者",
"word_type": 8,
"hot_id": 107846,
"is_commercial": "0"
}, {
"position": 10,
"keyword": "王者新英雄海诺动画",
"show_name": "王者新英雄海诺动画",
"word_type": 4,
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221118/eaf2dd702d7cc14d8d9511190245d057/UF7B1wVKT2.png",
"hot_id": 107870,
"is_commercial": "0"
}, {
"position": 11,
"keyword": "周星驰功夫10万字拆解",
"show_name": "周星驰功夫10万字拆解",
"word_type": 4,
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221118/eaf2dd702d7cc14d8d9511190245d057/UF7B1wVKT2.png",
"hot_id": 107848,
"is_commercial": "0"
}, {
"position": 12,
"keyword": "张杰铁粉彭奶奶去世",
"show_name": "张杰铁粉彭奶奶去世",
"word_type": 4,
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221118/eaf2dd702d7cc14d8d9511190245d057/UF7B1wVKT2.png",
"hot_id": 107840,
"is_commercial": "0"
}, {
"position": 13,
"keyword": "李玟二姐回应礼服争议",
"show_name": "李玟二姐回应礼服争议",
"word_type": 8,
"hot_id": 107833,
"is_commercial": "0"
}, {
"position": 14,
"keyword": "洪水中飘来冰箱市民取走饮料",
"show_name": "洪水中飘来冰箱市民取走饮料",
"word_type": 8,
"hot_id": 107802,
"is_commercial": "0"
}, {
"position": 15,
"keyword": "LOL斗魂觉醒佛耶戈语音",
"show_name": "LOL斗魂觉醒佛耶戈语音",
"word_type": 8,
"hot_id": 107790,
"is_commercial": "0"
}, {
"position": 16,
"keyword": "全面落实带薪休假制度",
"show_name": "全面落实带薪休假制度",
"word_type": 4,
"icon": "http://i0.hdslb.com/bfs/activity-plat/static/20221118/eaf2dd702d7cc14d8d9511190245d057/UF7B1wVKT2.png",
"hot_id": 107839,
"is_commercial": "0"
}, {
"position": 17,
"keyword": "花少北 把病娇治好了",
"show_name": "花少北 把病娇治好了",
"word_type": 8,
"hot_id": 107782,
"is_commercial": "0"
}, {
"position": 18,
"keyword": "2.28米高的村超娃",
"show_name": "2.28米高的村超娃",
"word_type": 8,
"hot_id": 107805,
"is_commercial": "0"
}, {
"position": 19,
"keyword": "当在动漫中不小心撞到",
"show_name": "当在动漫中不小心撞到",
"word_type": 8,
"hot_id": 107832,
"is_commercial": "0"
}, {
"position": 20,
"keyword": "台风卡努路径趋向日本",
"show_name": "台风卡努路径趋向日本",
"word_type": 8,
"hot_id": 107800,
"is_commercial": "0"
}],
"exp_str": "8000#5508#6604#7703",
"hotword_egg_info": "0"
}
}