github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-29 14:00:09 +08:00
Code Issues Packages Projects Releases Wiki Activity
a07976d6ed
bilibili-API-collect/danmaku/buzzword.md
社会易姐QwQ 83cfcc80d6 fix【README】typo, add doc【API签名】
2022-01-30 22:37:57 +08:00

20 KiB
Raw Blame History

名词解释

该功能用于解释和科普 B 站弹幕、评论等的专有名词及梗，展示其出处，并推荐相关站内内容

可使用页面 https://www.bilibili.com/blackboard/activity-joFQ0txEQd.html?type_id=4 查看名词列表

可使用页面 https://www.bilibili.com/blackboard/activity-WroMZNunfa.html?id=1 查看名词解释详情

拉取名词解释列表

http://api.bilibili.com/x/v2/dm/buzzword/list

请求方式：GET

url参数：

参数名 类型 内容 必要性 备注
type_id num 名词类型 必要 如：4代表“哔哩哔哩热词图鉴”
5代表“语言类”
pn num 页码 非必要 默认为1
ps num 每页项数 非必要 默认为20

json回复：

根对象：

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

data对象：

字段 类型 内容 备注
type obj 类型信息
buzzwords array 词语列表
page obj 页面信息

data中的type对象：

字段 类型 内容 备注
id num 类型 id
name str 类型名称
name_pinyin obj 拼音信息 见副表

data中的buzzwords数组：

项 类型 内容 备注
0 obj 名词条目 1
n obj 名词条目（n+1）
…… obj …… ……

buzzwords数组中的对象：

字段 类型 内容 备注
id num 名词 id 用于查询名词解释详情
name str 名词
name_pinyin obj 拼音信息 见副表
picture str 名词图片 url

data中的page对象：

字段 类型 内容 备注
num num 当前页码
size num 每页项数
total num 总计项数
cnt num (?)

副表：拼音name_pinyin对象：

字段 类型 内容 备注
对应单个汉字 1 str 拼音字串
对应单个汉字 n str 拼音字串
…… str …… ……

示例：

拉取对应哔哩哔哩热词图鉴的名词列表，以20项为一页拉取第1页

curl -G 'http://api.bilibili.com/x/v2/dm/buzzword/list' \
--data-urlencode 'type_id=4' \
--data-urlencode 'ps=10' \
--data-urlencode 'pn=1'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "type": {
            "id": 4,
            "name": "哔哩哔哩热词图鉴",
            "name_pinyin": {
                "哔": "bì",
                "哩": "lī",
                "图": "tú",
                "热": "rè",
                "词": "cí",
                "鉴": "jiàn"
            },
            "level": 0
        },
        "buzzwords": [
            {
                "id": 145,
                "name": "麦乐鸡侠",
                "name_pinyin": {
                    "乐": "lè",
                    "侠": "xiá",
                    "鸡": "jī",
                    "麦": "mài"
                },
                "picture": "https://i0.hdslb.com/bfs/archive/1cdec1ff86733a38c1a9ff824dde6d4121955aee.png"
            },
            {
                "id": 146,
                "name": "金钱豹",
                "name_pinyin": {
                    "豹": "bào",
                    "金": "jīn",
                    "钱": "qián"
                },
                "picture": "https://i0.hdslb.com/bfs/archive/3d492f4c01da7d15073d3175871e14ed56f0f78a.png"
            },
            {
                "id": 11,
                "name": "通辽可汗",
                "name_pinyin": {
                    "可": "kě",
                    "汗": "hàn",
                    "辽": "liáo",
                    "通": "tōng"
                },
                "picture": "https://i0.hdslb.com/bfs/archive/ca332fb5f9da48497298cf26fe07b1f061e53a0b.jpg"
            },
            {
                "id": 123,
                "name": "资本马桶搋",
                "name_pinyin": {
                    "搋": "chuāi",
                    "本": "běn",
                    "桶": "tǒng",
                    "资": "zī",
                    "马": "mǎ"
                },
                "picture": "https://i0.hdslb.com/bfs/archive/aaf33dced1941af0946f37c62f4b48fcaba9c9a2.jpg"
            },
            {
                "id": 133,
                "name": "马了顶大",
                "name_pinyin": {
                    "了": "le",
                    "大": "dà",
                    "顶": "dǐng",
                    "马": "mǎ"
                },
                "picture": "https://i0.hdslb.com/bfs/archive/9653bd7f8d2c804aceb8043ebd5c8360a93e26c0.png"
            },
            {
                "id": 9,
                "name": "退钱",
                "name_pinyin": {
                    "退": "tuì",
                    "钱": "qián"
                },
                "picture": "https://i0.hdslb.com/bfs/archive/2540db0bc94792b1f5be75e19aa05d33666e3036.jpg"
            },
            {
                "id": 141,
                "name": "森林冰火人",
                "name_pinyin": {
                    "人": "rén",
                    "冰": "bīng",
                    "林": "lín",
                    "森": "sēn",
                    "火": "huǒ"
                },
                "picture": "https://i0.hdslb.com/bfs/archive/bc5ca101313d4db223c395d64779e76eb3482d60.jpg"
            },
            {
                "id": 22,
                "name": "学霸题",
                "name_pinyin": {
                    "学": "xué",
                    "霸": "bà",
                    "题": "tí"
                },
                "picture": "https://i0.hdslb.com/bfs/archive/a67a0a57ec48beb8c8dcc9f26c7bb66cd0ed5da7.jpg"
            },
            {
                "id": 10,
                "name": "张三",
                "name_pinyin": {
                    "三": "sān",
                    "张": "zhāng"
                },
                "picture": "https://i0.hdslb.com/bfs/archive/f4dac6fdc5c58639b79ae87385e9b9f7eae3b263.png"
            },
            {
                "id": 5,
                "name": "饮茶先啦",
                "name_pinyin": {
                    "先": "xiān",
                    "啦": "la",
                    "茶": "chá",
                    "饮": "yǐn"
                },
                "picture": "https://i0.hdslb.com/bfs/archive/4c90ad207f0041e2dccd586827028aea50c2dc7d.jpg"
            }
        ],
        "page": {
            "num": 1,
            "size": 10,
            "total": 143,
            "cnt": 0
        }
    }
}

查询名词解释详情

http://api.bilibili.com/x/v2/dm/buzzword/detail

请求方式：GET

url参数：

参数名 类型 内容 必要性 备注
id num 名词id 必要 如：1代表“kksk”
2代表“打脸”

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
-404：不存在该名词
message str 错误信息 默认为0
ttl num 1
data 有数据时：obj
无数据时：null		 数据本体

data对象：

字段 类型 内容 备注
id num 名词id
name str 名词
description str 名词解释
picture str 名词图片 url
types array 父分类列表 该名词可能隶属多个父分类
related_words array 近义词/相关词
uppers 有数据：array
无数据：null		 相关 UP 列表 该名词(梗)出处
related_ugc 有数据：array
无数据：null		 相关 ucg 视频列表 该名词(梗)出处
related_ogv 有数据：array
无数据：null		 相关 pgc 视频列表 该名词(梗)出处
guides obj 推荐创作信息
related_buzzwords array 推荐名词列表
topic obj 关联话题信息
show_dynamic bool 是否展示话题动态聚合 true展示
false不展示

data中的types数组：

项 类型 内容 备注
0 obj 父分类 1
n obj 父分类（n+1）
…… obj …… ……

types数组中的对象：

字段 类型 内容 备注
id num 类型 id
name str 类型名称
name_pinyin null
level num 权重？

data中的related_words数组：

项 类型 内容 备注
0 str 近义词/相关词1
n str 近义词/相关词（n+1）
…… str …… ……

data中的uppers数组：

项 类型 内容 备注
0 obj 相关 UP 1
n obj 相关 UP（n+1）
…… obj …… ……

uppers数组中的对象：

字段 类型 内容 备注
id num UP 主 mid
recommend str
name str UP 主昵称
face str UP 主头像 url
official obj UP 主认证信息
followed bool 是否关注 需要登录(Cookie 或 APP)
true已关注
false未关注
fans_count num 粉丝数

data中的related_ugc数组：

项 类型 内容 备注
0 obj 相关 ucg 视频 1
n obj 相关 ucg 视频（n+1）
…… obj …… ……

related_ugc数组中的对象：

字段 类型 内容 备注
aid num 稿件 avid
cid num 视频 cid
name str 视频标题
link str 空
play num 播放数
danmaku num 弹幕数
duration num 视频时长 单位为秒
cover str 视频封面 url

data中的related_ogv数组：

项 类型 内容 备注
0 obj 相关 pgc 视频 1
n obj 相关 pgc 视频（n+1）
…… obj …… ……

related_ogv数组中的对象：

字段 类型 内容 备注
season_id num 剧集 ssid
name str 剧集标题
play num 播放数
followed num 追剧/番数
is_followed bool 是否追剧/番 true已追剧/番
false未追剧/番
new_ep str 最新一集信息
cover str 剧集封面 url
episodes null
follow_info obj

data中的guides对象：

字段 类型 内容 备注
description str 创作推介文案
contribute_tags array 创作跳转按钮信息

guides中的contribute_tags数组：

项 类型 内容 备注
0 obj 创作跳转按钮 1
n obj 创作跳转按钮（n+1）
…… obj …… ……

contribute_tags数组中的对象：

字段 类型 内容 备注
title str 按钮文案
link str 跳转 uri 跳转至必剪或客户端创作入口

data中的related_buzzwords数组：

项 类型 内容 备注
0 obj 推荐名词 1
n obj 推荐名词（n+1）
…… obj …… ……

related_buzzwords数组中的对象：

字段 类型 内容 备注
id num 名词 id 用于查询名词解释详情
name str 名词
name_pinyin null
picture str 空

data中的topic对象：

字段 类型 内容 备注
topic_id num 关联话题id
topic_name str 关联话题名称

示例：

查询名词kksk的详情

curl -G 'http://api.bilibili.com/x/v2/dm/buzzword/detail' \
--data-urlencode 'id=1'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "id": 1,
        "name": "kksk",
        "description": "该梗是日语“ここすき”罗马音的字母缩写，翻译为喜欢这里。一般作为赞扬认可的弹幕出现在视频画面中。由于在2017年随着以《恶魔人》为BGM和语音剪辑素材的《美洲豹人》系列作品的传播，让这个梗快速的通过弹幕流行开，并频繁出现在各类稿件经典画面中。",
        "picture": "https://i0.hdslb.com/bfs/archive/c269c9ca1b5eb730ee1d77aadd28e3165eaa4d6d.png",
        "types": [
            {
                "id": 4,
                "name": "哔哩哔哩热词图鉴",
                "name_pinyin": null,
                "level": 0
            },
            {
                "id": 5,
                "name": "语言类",
                "name_pinyin": null,
                "level": 0
            },
            {
                "id": 9,
                "name": "空耳",
                "name_pinyin": null,
                "level": 0
            }
        ],
        "related_words": [
            "恶魔人",
            "美洲豹人",
            "喜欢这里"
        ],
        "uppers": [
            {
                "id": 488450,
                "recommend": "",
                "name": "PXN1",
                "face": "http://i2.hdslb.com/bfs/face/96dd8cc4f2922bd81e5a938f6ad02b3e3041debe.jpg",
                "official": {
                    "role": 0,
                    "title": "",
                    "desc": "",
                    "type": -1
                },
                "followed": false,
                "fans_count": 1416
            }
        ],
        "related_ugc": [
            {
                "aid": 30056798,
                "cid": 52388183,
                "name": "恶 魔 人",
                "link": "",
                "play": 3434500,
                "danmaku": 8292,
                "duration": 188,
                "cover": "http://i0.hdslb.com/bfs/archive/f0433d2dacf4b3397a9390ab982cefd138dbf8c8.jpg"
            }
        ],
        "related_ogv": null,
        "guides": {
            "description": "使用同款热梗素材创作你的专属作品吧！添加热梗主题#kksk是什么梗#参与投稿，优质稿件会优先展示在哔哩哔哩热词图鉴相关推荐中哦！",
            "contribute_tags": [
                {
                    "title": "拍同款",
                    "link": "bilibili://uper/appTraffic?appScheme=bcut%3A%2F%2Fstudio%2Fmaterial_editor%2F%3Ftab_id%3D1%26sub_id%3D90160%26third_id%3D150281&appName=com.bilibili.studio&appID=1299589486"
                }
            ]
        },
        "related_buzzwords": null,
        "topic": {
            "topic_id": 7642,
            "topic_name": "kksk是什么梗"
        },
        "show_dynamic": false
    }
}