github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-27 13:00:29 +08:00
Code Issues Packages Projects Releases Wiki Activity
8b7ca24b97
bilibili-API-collect/docs/audio/music_list.md
SocialSisterYi f6760f4be3
🔨remove header index
2023-02-23 11:48:58 +08:00

27 KiB
Raw Blame History

歌单&音频收藏夹详细信息

查询自己创建的歌单

https://www.bilibili.com/audio/music-service-c/web/collections/list

请求方式：GET

认证方式：Cookie（SESSDATA）

鉴权方式：Cookie中DedeUserID存在且不为0

url参数：

参数名 类型 内容 必要性 备注
pn num 页码 必要
ps num 每页项数 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
72000000：参数错误
72010002：未登录
msg str 错误信息 默认为success
data 正确时：obj
错误时：null		 信息本体

data对象：

字段 类型 内容 备注
curPage num 当前页码
pageCount num 总计页数
totalSize num 总计收藏夹数
pageSize num 当前页面项数
data array 歌单列表

data中的data数组：

项 类型 内容 备注
0 obj 音频收藏夹mlid1
n obj 音频收藏夹mlid(n+1)
…… obj …… ……

data数组中的对象：

字段 类型 内容 备注
id num 音频收藏夹mlid
uid num 创建用户mid
uname str 创建用户昵称
title str 歌单标题
type num 收藏夹属性 0：普通收藏夹
1：默认收藏夹
published num 是否公开 0：不公开
1：公开
cover str 歌单封面图片url
ctime num 歌单创建时间 时间戳
song num 歌单中的音乐数量
desc str 歌单备注信息
sids array 歌单中的音乐
menuId num 音频收藏夹对应的歌单amid
statistic obj 歌单状态数信息

data中的sids数组：

项 类型 内容 备注
0 num 收藏的音频auid1
n num 收藏的音频auid(n+1) 按照歌单顺序排列
…… num …… ……

data中的statistic对象：

字段 类型 内容 备注
sid num 音频收藏夹对应的歌单amid
play num 播放数
collect num 收藏数
comment null 评论数
share num 分享数

示例：

curl -G 'https://www.bilibili.com/audio/music-service-c/web/collections/list' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx;DedeUserID=1;'

共计创建了两个歌单，如下

查看响应示例： 
{
    "code": 0,
    "msg": "success",
    "data": {
        "curPage": 1,
        "pageCount": 1,
        "totalSize": 2,
        "pageSize": 2,
        "data": [
            {
                "id": 15967839,
                "uid": 293793435,
                "uname": "社会易姐QwQ",
                "title": "默认歌单",
                "type": 1,
                "published": 1,
                "cover": "http://i0.hdslb.com/bfs/music/1e079693701d2f525850c288fcc48fa4259a73f6.jpg",
                "ctime": 1519295502,
                "song": 13,
                "desc": "",
                "sids": [
                    11673,
                    276404,
                    15664,
                    737904,
                    108588,
                    1286999,
                    658085,
                    682118,
                    736952,
                    48716,
                    15711,
                    13598,
                    57744
                ],
                "menuId": 15958713,
                "statistic": {
                    "sid": 15958713,
                    "play": 0,
                    "collect": 0,
                    "comment": null,
                    "share": 0
                }
            },
            {
                "id": 30894022,
                "uid": 293793435,
                "uname": "社会易姐QwQ",
                "title": "test",
                "type": 0,
                "published": 1,
                "cover": "",
                "ctime": 1590154346,
                "song": 0,
                "desc": "test1",
                "sids": [],
                "menuId": 30866686,
                "statistic": {
                    "sid": 30866686,
                    "play": 0,
                    "collect": 0,
                    "comment": 0,
                    "share": 0
                }
            }
        ]
    }
}

查询音频收藏夹（默认歌单）信息

https://www.bilibili.com/audio/music-service-c/web/collections/info

请求方式：GET

认证方式：Cookie（SESSDATA）

鉴权方式：Cookie中DedeUserID存在且不为0

url参数：

参数名 类型 内容 必要性 备注
sid num 音频收藏夹mlid 必要 必须为默认收藏夹mlid

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
72000000：参数错误
72010002：未登录
msg str 错误信息 默认为success
data 正确时：obj
错误时：null		 信息本体

data对象：

字段 类型 内容 备注
id num 音频收藏夹mlid
uid num 创建用户mid
uname str 创建用户昵称
title str 默认歌单 恒为默认歌单
type num 1 恒为1
published num 是否公开 0：不公开
1：公开
cover str 歌单封面图片url
ctime num 歌单创建时间 时间戳
song num 歌单中的音乐数量
desc str 空 恒为空
sids array 歌单中的音乐
menuId num 音频收藏夹对应的歌单amid 与普通歌单不同通用
statistic obj 歌单状态数信息

data中的sids数组：

项 类型 内容 备注
0 num 收藏的音频auid1
n num 收藏的音频auid(n+1) 按照歌单顺序排列
…… num …… ……

data中的statistic对象：

字段 类型 内容 备注
sid num 音频收藏夹对应的歌单amid
play num 0
collect num 0
comment null -
share num 0

示例：

查询我的默认歌单，id为15967839

curl -G 'https://www.bilibili.com/audio/music-service-c/web/collections/info' \
--data-urlencode 'sid=15967839 ' \
-b 'SESSDATA=xxx;DedeUserID=1;'
查看响应示例： 
{
    "code": 0,
    "msg": "success",
    "data": {
        "id": 15967839,
        "uid": 293793435,
        "uname": "社会易姐QwQ",
        "title": "默认歌单",
        "type": 1,
        "published": 1,
        "cover": "http://i0.hdslb.com/bfs/music/1e079693701d2f525850c288fcc48fa4259a73f6.jpg",
        "ctime": 1519295502,
        "song": 13,
        "desc": "",
        "sids": [
            11673,
            276404,
            15664,
            737904,
            108588,
            1286999,
            658085,
            682118,
            736952,
            48716,
            15711,
            13598,
            57744
        ],
        "menuId": 15958713,
        "statistic": {
            "sid": 15958713,
            "play": 0,
            "collect": 0,
            "comment": null,
            "share": 0
        }
    }
}

查询热门歌单

https://www.bilibili.com/audio/music-service-c/web/menu/hit

请求方式：GET

url参数：

参数名 类型 内容 必要性 备注
pn num 页码 必要
ps num 每页项数 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
72000000：参数错误
72010002：未登录
msg str 错误信息 默认为success
data 正确时：obj
错误时：null		 信息本体

data对象：

字段 类型 内容 备注
curPage num 当前页码
pageCount num 总计页数
totalSize num 总计收藏夹数
pageSize num 当前页面项数
data array 歌单列表

data中的data数组：

项 类型 内容 备注
0 obj 音频收藏夹mlid1
n obj 音频收藏夹mlid(n+1)
…… obj …… ……

data数组中的对象：

字段 类型 内容 备注
menuId num 音频收藏夹对应的歌单amid
uid num 创建用户mid
uname str 创建用户昵称
title str 歌单标题
cover str 歌单封面图片url
intro str 歌单介绍
type num 歌单属性 1：普通歌单
2：置顶歌单
5：PGC歌单
off num 歌单是否公开 0：公开
1：私密
ctime num 歌单创建时间 时间戳
curtime num 当前时间 时间戳
statistic obj 歌单状态数信息
snum num 歌单包含歌曲个数

data中的statistic对象：

字段 类型 内容 备注
sid num 音频收藏夹对应的歌单amid
play num 播放数
collect num 收藏数
comment num 评论数
share num 分享数

示例：

curl -G 'https://www.bilibili.com/audio/music-service-c/web/menu/hit' \

--data-urlencode 'ps=1' \

--data-urlencode 'pn=6'

使用参数：ps=1&qn=2

查看响应示例： 
{
    "code": 0,
    "msg": "success",
    "data": {
        "curPage": 1,
        "pageCount": 1,
        "totalSize": 11,
        "pageSize": 3,
        "data": [{
            "menuId": 10624,
            "uid": 32708543,
            "uname": "大家的音乐姬",
            "title": "新曲推荐",
            "cover": "http://i0.hdslb.com/bfs/music/a32c1ed4f6ec3f74f8240f4486a750dda3a509e5.jpg",
            "intro": "每天11:00更新，为你推送最新音乐",
            "type": 2,
            "off": 0,
            "ctime": 1501209433,
            "curtime": 1655712354,
            "statistic": {
                "sid": 10624,
                "play": 2366255,
                "collect": 20565,
                "comment": 1104,
                "share": 622
            },
            "snum": 16,
            "attr": 0,
            "isDefault": 0,
            "collectionId": 0
        }, {
            "menuId": 125312,
            "uid": 32708543,
            "uname": "大家的音乐姬",
            "title": "丧甜可口?你意想不到的软萌电音",
            "cover": "http://i0.hdslb.com/bfs/music/04f6c29ed094368253bc05fecb7bf990cee2d3a3.jpg",
            "intro": "这个化学反应是怦然心动?",
            "type": 1,
            "off": 0,
            "ctime": 1533298738,
            "curtime": 1655712354,
            "statistic": {
                "sid": 125312,
                "play": 298018,
                "collect": 9928,
                "comment": 89,
                "share": 239
            },
            "snum": 19,
            "attr": 0,
            "isDefault": 0,
            "collectionId": 0
        }, {
            "menuId": 26241,
            "uid": 32708543,
            "uname": "大家的音乐姬",
            "title": "那些听了会泪目的动漫歌曲",
            "cover": "http://i0.hdslb.com/bfs/music/006832318fc85fdf287667d51d83dba3b78be808.jpg",
            "intro": "那些年陪伴我们的动漫歌曲，你还记得吗？\n",
            "type": 1,
            "off": 0,
            "ctime": 1509608572,
            "curtime": 1655712354,
            "statistic": {
                "sid": 26241,
                "play": 370120,
                "collect": 8390,
                "comment": 110,
                "share": 131
            },
            "snum": 12,
            "attr": 0,
            "isDefault": 0,
            "collectionId": 0
        }]
    }
}

查询热门榜单

https://www.bilibili.com/audio/music-service-c/web/menu/rank

请求方式：GET

url参数：

参数名 类型 内容 必要性 备注
pn num 页码 必要
ps num 每页项数 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
72000000：参数错误
72010002：未登录
msg str 错误信息 默认为success
data 正确时：obj
错误时：null		 信息本体

data对象：

字段 类型 内容 备注
curPage num 当前页码
pageCount num 总计页数
totalSize num 总计收藏夹数
pageSize num 当前页面项数
data array 歌单列表

data中的data数组：

项 类型 内容 备注
0 obj 音频收藏夹mlid1
n obj 音频收藏夹mlid(n+1)
…… obj …… ……

data数组中的对象：

字段 类型 内容 备注
menuId num 音频收藏夹对应的歌单amid
uid num 创建用户mid
uname str 创建用户昵称
title str 歌单标题
cover str 歌单封面图片url
intro str 歌单介绍
type num 歌单属性 1：普通歌单
2：置顶歌单
5：PGC歌单
off num 歌单是否公开 0：公开
1：私密
ctime num 歌单创建时间 时间戳
curtime num 当前时间 时间戳
statistic obj 歌单状态数信息
snum num 歌单包含歌曲个数
audios array 歌单中的音乐信息(部分)

data数组中的statistic对象：

字段 类型 内容 备注
sid num 音频收藏夹对应的歌单amid
play num 收藏数
collect num 点赞数
comment num 评论数
share num 分享数

data数组中的audios数组：

项 类型 内容 备注
0 obj 音频1
n obj 音频(n+1)
…… obj …… ……

audios数组中的audios对象：

字段 类型 内容 备注
id num 音频id
title str 音频标题
duration num 音频时长 单位：秒(s)

示例：

curl -G 'https://www.bilibili.com/audio/music-service-c/web/menu/rank' \

--data-urlencode 'ps=1' \

--data-urlencode 'pn=6'

使用参数：ps=1&qn=6

查看响应示例： 
{
    "code": 0,
    "msg": "success",
    "data": {
        "curPage": 1,
        "pageCount": 2,
        "totalSize": 12,
        "pageSize": 6,
        "data": [{
            "menuId": 10624,
            "uid": 32708543,
            "uname": "大家的音乐姬",
            "title": "新曲推荐",
            "cover": "http://i0.hdslb.com/bfs/music/a32c1ed4f6ec3f74f8240f4486a750dda3a509e5.jpg",
            "intro": "每天11:00更新，为你推送最新音乐",
            "type": 2,
            "off": 0,
            "ctime": 1501209433,
            "curtime": 1655713346,
            "statistic": {
                "sid": 10624,
                "play": 2366255,
                "collect": 20565,
                "comment": 1104,
                "share": 622
            },
            "snum": 16,
            "attr": 0,
            "isDefault": 0,
            "collectionId": 0,
            "audios": [{
                "id": 1572281,
                "title": "【Mitchie M】Nechusho No!No! (feat. 初音未来 & MEIKO)",
                "duration": 112
            }, {
                "id": 1551077,
                "title": "【洛天依原创】双星伴生",
                "duration": 197
            }, {
                "id": 1544428,
                "title": "【小柔】寄り酔い（cover）",
                "duration": 216
            }]
        }, {
            "menuId": 10627,
            "uid": 32708543,
            "uname": "大家的音乐姬",
            "title": "热歌榜（每日11:00更新）",
            "cover": "http://i0.hdslb.com/bfs/music/bc735b32ab123f7ddc602b9194defae2cd66062f.jpg",
            "intro": "每日上午11:00更新，精选三日内热门投稿作品。",
            "type": 2,
            "off": 0,
            "ctime": 1501211353,
            "curtime": 1655713346,
            "statistic": {
                "sid": 10627,
                "play": 2289612,
                "collect": 11437,
                "comment": 434,
                "share": 223
            },
            "snum": 20,
            "attr": 0,
            "isDefault": 0,
            "collectionId": 0,
            "audios": [{
                "id": 1955567,
                "title": "山海（原唱：草东没有派对）",
                "duration": 215
            }, {
                "id": 923884,
                "title": "platiunm",
                "duration": 181
            }, {
                "id": 1954370,
                "title": "Dark Dawn v1",
                "duration": 200
            }]
        }, {
            "menuId": 10628,
            "uid": 32708543,
            "uname": "大家的音乐姬",
            "title": "原创榜（每日11:00更新）",
            "cover": "http://i0.hdslb.com/bfs/music/58782504cefb307878d12422fd365ed7f971fad1.jpg",
            "intro": "每日上午11:00更新，精选三日内原创投稿音乐。",
            "type": 2,
            "off": 0,
            "ctime": 1501211627,
            "curtime": 1655713346,
            "statistic": {
                "sid": 10628,
                "play": 395817,
                "collect": 2583,
                "comment": 314,
                "share": 88
            },
            "snum": 20,
            "attr": 0,
            "isDefault": 0,
            "collectionId": 0,
            "audios": [{
                "id": 923884,
                "title": "platiunm",
                "duration": 181
            }, {
                "id": 1954370,
                "title": "Dark Dawn v1",
                "duration": 200
            }, {
                "id": 1954654,
                "title": "张真源 - 你要快乐 (Live)",
                "duration": 235
            }]
        }, {
            "menuId": 10629,
            "uid": 32708543,
            "uname": "大家的音乐姬",
            "title": "中文人声三日榜",
            "cover": "http://i0.hdslb.com/bfs/music/f547e3b96d3f283eaa6a3a071de22092fb5101f8.jpg",
            "intro": "每日上午11:00更新，精选三日内中文人声投稿音乐。",
            "type": 2,
            "off": 0,
            "ctime": 1501211818,
            "curtime": 1655713346,
            "statistic": {
                "sid": 10629,
                "play": 842507,
                "collect": 5102,
                "comment": 362,
                "share": 137
            },
            "snum": 20,
            "attr": 0,
            "isDefault": 0,
            "collectionId": 0,
            "audios": [{
                "id": 1955567,
                "title": "山海（原唱：草东没有派对）",
                "duration": 215
            }, {
                "id": 1955546,
                "title": "爱你",
                "duration": 86
            }, {
                "id": 1954654,
                "title": "张真源 - 你要快乐 (Live)",
                "duration": 235
            }]
        }, {
            "menuId": 10630,
            "uid": 32708543,
            "uname": "大家的音乐姬",
            "title": "日文人声三日榜",
            "cover": "http://i0.hdslb.com/bfs/music/7dd5d629f50481e22e2f5eced510f5fbd89f5233.jpg",
            "intro": "每日上午11:00更新，精选三日内日文人声投稿音乐。",
            "type": 2,
            "off": 0,
            "ctime": 1501211959,
            "curtime": 1655713346,
            "statistic": {
                "sid": 10630,
                "play": 891268,
                "collect": 8671,
                "comment": 601,
                "share": 169
            },
            "snum": 20,
            "attr": 0,
            "isDefault": 0,
            "collectionId": 0,
            "audios": [{
                "id": 1954053,
                "title": "派对浪客诸葛孔明 插入歌『ChocoPate』久远七海 starring Lezel",
                "duration": 117
            }, {
                "id": 1956316,
                "title": "ただ君に晴れ（只给予你的晴天）",
                "duration": 196
            }, {
                "id": 1956321,
                "title": "うまぴょい伝説（马儿蹦跳传说）",
                "duration": 262
            }]
        }, {
            "menuId": 10631,
            "uid": 32708543,
            "uname": "大家的音乐姬",
            "title": "VOCALOID三日榜",
            "cover": "http://i0.hdslb.com/bfs/music/ce8b1646cbbd5513de7976ba81d0fd9c340c1899.jpg",
            "intro": "每日上午11:00更新，精选三日内VOCALOID投稿音乐。",
            "type": 2,
            "off": 0,
            "ctime": 1501212166,
            "curtime": 1655713346,
            "statistic": {
                "sid": 10631,
                "play": 170112,
                "collect": 2900,
                "comment": 528,
                "share": 60
            },
            "snum": 10,
            "attr": 0,
            "isDefault": 0,
            "collectionId": 0,
            "audios": [{
                "id": 1954717,
                "title": "弦歌引-翻调",
                "duration": 230
            }, {
                "id": 1956148,
                "title": "告RADIO - 春色リップ",
                "duration": 253
            }, {
                "id": 1954302,
                "title": "susan说",
                "duration": 195
            }]
        }]
    }
}