表情列表
获取我的表情列表
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'
查看响应示例：
{
"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'
查看响应示例：
{
"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 | 简写名 | 无则无此项 |