Skip to content

Latest commit

 

History

History
692 lines (596 loc) · 17.3 KB

hot.md

File metadata and controls

692 lines (596 loc) · 17.3 KB
Raw

默认搜索&热搜

获取默认搜索内容（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/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"
	}
}