bac

表情列表

获取我的表情列表

https://api.bilibili.com/x/emote/user/panel/web

请求方式:GET

认证方式:Cookie(SESSDATA)

使用登录(Cookie)进行会员专属及已购买表情包的分发,否则全为免费表情包

url参数:

参数名 类型 内容 必要性 备注
business str 使用场景 必要 reply:评论区
dynamic:动态

json回复:

根对象:

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

data对象:

字段 类型 内容 备注
packages array 表情包  

data中的packages数组:

类型 内容 备注
0 obj 表情包1 详情见附表
n obj 表情包(n+1) 详情见附表
…… obj …… ……

示例:

curl -G 'https://api.bilibili.com/x/emote/user/panel/web' \
--data-urlencode 'business=reply' \
-b 'SESSDATA=xxx'
查看响应示例: ```json { "code": 0, "message": "0", "ttl": 1, "data": { "packages": [ { "id": 1, "text": "小黄脸", "url": "http://i0.hdslb.com/bfs/emote/81edf17314cea3b48674312b4364df44d5c01f17.png", "mtime": 1591604235, "type": 1, "attr": 66, "meta": { "size": 1, "item_id": 958 }, "emote": [ { "id": 2126, "package_id": 1, "text": "[视频卫星]", "url": "http://i0.hdslb.com/bfs/emote/dce6fc7d6dfeafff01241924db60f8251cca5307.png", "mtime": 1590986882, "type": 1, "attr": 0, "meta": { "size": 1 }, "flags": {} }, { "id": 1901, "package_id": 1, "text": "[加油武汉]", "url": "http://i0.hdslb.com/bfs/emote/eb966aaa5b690d3f9308a9f936f5b5a72a7f956b.png", "mtime": 1580024058, "type": 1, "attr": 0, "meta": { "size": 1 }, "flags": {} }, { "id": 1906, "package_id": 1, "text": "[口罩]", "url": "http://i0.hdslb.com/bfs/emote/3ad2f66b151496d2a5fb0a8ea75f32265d778dd3.png", "mtime": 1581309529, "type": 1, "attr": 0, "meta": { "size": 1 }, "flags": {} }, { "id": 1, "package_id": 1, "text": "[微笑]", "url": "http://i0.hdslb.com/bfs/emote/685612eadc33f6bc233776c6241813385844f182.png", "mtime": 1582182040, "type": 1, "attr": 0, "meta": { "size": 1 }, "flags": {} }, { "id": 1958, "package_id": 1, "text": "[笑]", "url": "http://i0.hdslb.com/bfs/emote/81edf17314cea3b48674312b4364df44d5c01f17.png", "mtime": 1582184940, "type": 1, "attr": 0, "meta": { "size": 1 }, "flags": {} }, ………… }, { "id": 53, "text": "热词系列一", "url": "http://i0.hdslb.com/bfs/emote/bacd6e17997348873ef89e5f1bcbbda877a1606a.png", "mtime": 1592205524, "type": 1, "attr": 2, "meta": { "size": 2, "item_id": 1039 }, "emote": [ { "id": 1937, "package_id": 53, "text": "[热词系列_知识增加]", "url": "http://i0.hdslb.com/bfs/emote/142409b595982b8210b2958f3d340f3b47942645.png", "mtime": 1585202919, "type": 1, "attr": 2, "meta": { "size": 2, "alias": "知识增加" }, "flags": {} }, { "id": 2147, "package_id": 53, "text": "[热词系列_希望没事]", "url": "http://i0.hdslb.com/bfs/emote/6c0d2e6c486d1ba5afd6204a96e102652464a01d.png", "mtime": 1591689594, "type": 1, "attr": 2, "meta": { "size": 2, "alias": "希望没事" }, "flags": {} }, { "id": 2083, "package_id": 53, "text": "[热词系列_泪目]", "url": "http://i0.hdslb.com/bfs/emote/bba3703ab90b7d16fe9dbcb85ed949db687f8331.png", "mtime": 1588910215, "type": 1, "attr": 2, "meta": { "size": 2, "alias": "泪目" }, "flags": {} }, { "id": 2082, "package_id": 53, "text": "[热词系列_保护]", "url": "http://i0.hdslb.com/bfs/emote/55f8f6445ca7c3170cdfc5b16036abf639ce9b57.png", "mtime": 1588910215, "type": 1, "attr": 2, "meta": { "size": 2, "alias": "保护" }, "flags": {} }, ………… }, ………… ] } } ```

获取指定的表情包明细

https://api.bilibili.com/x/emote/package

请求方式:GET

url参数:

参数名 类型 内容 必要性 备注
business str 使用场景 必要 reply:评论区
dynamic:动态
ids nums 表情包id 必要 id之间以,隔开

json回复:

根对象:

字段 类型 内容 备注
code num 返回值 0:成功
-400:请求错误
message str 错误信息 默认为0
ttl num 1  
data 有效时:obj
无效时:null
信息本体  

data对象:

字段 类型 内容 备注
packages array 表情包  

data中的packages数组:

类型 内容 备注
0 obj 表情包1 详情见附表
n obj 表情包(n+1) 详情见附表
…… obj …… ……

示例:

获取表情包id为93的表情包明细

curl -G 'https://api.bilibili.com/x/emote/package' \
--data-urlencode 'ids=93' \
--data-urlencode 'business=reply'
查看响应示例: ```json { "code": 0, "message": "0", "ttl": 1, "data": { "packages": [ { "id": 93, "text": "泠鸢yousa", "url": "http://i0.hdslb.com/bfs/emote/5fa6082e098402d16d58c68e441ae76e40befd2c.png", "mtime": 1592213522, "type": 3, "attr": 28, "meta": { "size": 2, "item_id": 1907, "item_url": "https://www.bilibili.com/h5/mall/suit/detail?navhide=1&stahide=0&id=1911" }, "emote": [ { "id": 2086, "package_id": 93, "text": "[泠鸢yousa_awsl]", "url": "http://i0.hdslb.com/bfs/emote/7663b729161bd4556c2ec318c07791000743eb56.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "awsl" }, "flags": {} }, { "id": 2087, "package_id": 93, "text": "[泠鸢yousa_打call]", "url": "http://i0.hdslb.com/bfs/emote/718e9495846db4172eb87d2f7f02015a34d35ea2.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "打call" }, "flags": {} }, { "id": 2088, "package_id": 93, "text": "[泠鸢yousa_沉默]", "url": "http://i0.hdslb.com/bfs/emote/5e967cf1669743ed92e9a8ff3e5de6d90ca63d3d.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "沉默" }, "flags": {} }, { "id": 2089, "package_id": 93, "text": "[泠鸢yousa_大哭]", "url": "http://i0.hdslb.com/bfs/emote/3f757b147b9b1e201470eae7dac9cc0360172569.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "大哭" }, "flags": {} }, { "id": 2090, "package_id": 93, "text": "[泠鸢yousa_干杯]", "url": "http://i0.hdslb.com/bfs/emote/5cf5e14101be845233a222ab1bbdc21c63af04c3.png", "mtime": 1590401422, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "干杯" }, "flags": {} }, { "id": 2091, "package_id": 93, "text": "[泠鸢yousa_好人卡]", "url": "http://i0.hdslb.com/bfs/emote/e3907b3bb20b18e7ecb11cd86829c9a4ce5b1b2f.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "好人卡" }, "flags": {} }, { "id": 2092, "package_id": 93, "text": "[泠鸢yousa_加大力度]", "url": "http://i0.hdslb.com/bfs/emote/a0393a2d4b522f07a319dfd2e91754a3cdff2c48.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "加大力度" }, "flags": {} }, { "id": 2093, "package_id": 93, "text": "[泠鸢yousa_滑稽]", "url": "http://i0.hdslb.com/bfs/emote/a8057c0e0579b93c16010a270e261fd0a64034af.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "滑稽" }, "flags": {} }, { "id": 2094, "package_id": 93, "text": "[泠鸢yousa_请吃桃]", "url": "http://i0.hdslb.com/bfs/emote/e92276d9d8c28f85f7dbcc0fbbb6ecb3345ce33e.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "请吃桃" }, "flags": {} }, { "id": 2095, "package_id": 93, "text": "[泠鸢yousa_惊讶]", "url": "http://i0.hdslb.com/bfs/emote/9fdc2c5b4b970aded56fe2f326bd4d00e849339d.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "惊讶" }, "flags": {} }, { "id": 2096, "package_id": 93, "text": "[泠鸢yousa_生气]", "url": "http://i0.hdslb.com/bfs/emote/9e6ba9ff34101e04d3e321cad486f845f892050e.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "生气" }, "flags": {} }, { "id": 2097, "package_id": 93, "text": "[泠鸢yousa_贴贴]", "url": "http://i0.hdslb.com/bfs/emote/dbc177d314231add509501ffc6bc7655fca2c10f.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "贴贴" }, "flags": {} }, { "id": 2098, "package_id": 93, "text": "[泠鸢yousa_头晕]", "url": "http://i0.hdslb.com/bfs/emote/49830c1c8a1652f7ee9cb854ac7dbf8e378cdcd6.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "头晕" }, "flags": {} }, { "id": 2099, "package_id": 93, "text": "[泠鸢yousa_问号]", "url": "http://i0.hdslb.com/bfs/emote/ab7a543233eff83138c3221c86a762ab36bab7bc.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "问号" }, "flags": {} }, { "id": 2100, "package_id": 93, "text": "[泠鸢yousa_真棒]", "url": "http://i0.hdslb.com/bfs/emote/02ea49543a3ac52feee185c156ab08fb2bfdd89e.png", "mtime": 1589776042, "type": 3, "attr": 0, "meta": { "size": 2, "alias": "真棒" }, "flags": {} } ], "flags": { "added": true } } ] } } ```

获取所有表情包列表

https://api.bilibili.com/x/emote/setting/panel

请求方式:GET

认证方式:Cookie(SESSDATA)

url参数:

参数名 类型 内容 必要性 备注
business str 使用场景 必要 reply:评论区
dynamic:动态

json回复:

根对象:

字段 类型 内容 备注
code num 返回值 0:成功
-101:账号未登录
-400:请求错误
message str 错误信息 默认为0
ttl num 1  
data obj 信息本体  

data对象:

字段 类型 内容 备注
user_panel_packages array 用户拥有的表情包  
all_packages array 所有表情包  
mall obj 商城页面  

data对象中的user_panel_packages数组:

类型 内容 备注
0 obj 用户拥有的表情包1 详情见附表
n obj 用户拥有的表情包(n+1) 详情见附表
…… obj …… ……

data对象中的all_packages数组:

类型 内容 备注
0 obj 所有表情包1 详情见附表
n obj 所有表情包(n+1) 详情见附表
…… obj …… ……

data对象中的mall对象:

字段 类型 内容 备注
title str 商城名称  
url str 商城页面url  

示例:

curl -G 'https://api.bilibili.com/x/emote/setting/panel' \
--data-urlencode 'business=reply' \
-b 'SESSDATA=xxx'

限于篇幅,代码块示例略

附表-表情包对象

字段 类型 内容 备注
id num 表情包id  
text str 表情包名称  
url str 表情包标志图片url  
mtime num 创建时间 时间戳
type num 表情包类型 1:普通
2:会员专属
3:购买所得
4:颜文字
attr num ??? 作用尚不明确
meta obj 属性信息  
emote array 表情列表  
flags obj 是否添加标志  

表情包对象中的flags对象:

字段 类型 内容 备注
added bool 是否已添加 true:已添加
false:未添加
需要登录(SESSDATA)
否则恒为false

表情包对象中的meta对象:

字段 类型 内容 备注
size num 表情尺寸信息 1:小
2:大
item_id num 购买物品id  
item_url num 购买物品页面url 无则无此项

表情包对象中的emote数组:

类型 内容 备注
0 obj 表情1  
n obj 表情(n+1)  
…… obj …… ……

emote数组中的对象:

字段 类型 内容 备注
id num 表情id  
package_id num 表情包id  
text str 表情转义符 颜文字时为该字串
url str 表情图片url 颜文字时为该字串
mtime num 创建时间 时间戳
type num 表情类型 1:普通
2:会员专属
3:购买所得
4:颜文字
attr num ??? 作用尚不明确
meta obj 属性信息  
flags obj 禁用标志 无则为空

emote数组中的对象中的flags对象:

字段 类型 内容 备注
no_access bool 是否为禁用 true:禁用
需要登录(SESSDATA)
否则恒为true

emote数组中的对象中的meta对象:

字段 类型 内容 备注
size num 表情尺寸信息 1:小
2:大
alias str 简写名 无则无此项