1. 歌曲
网易云 API
  • 登录
    • QR Code
      • key
      • create
    • 手机号登陆
      • 验证验证码
      • 手机登录
      • 新版发送验证码
    • 游客登陆
      GET
    • 登录状态
      GET
    • 退出登录
      GET
    • 刷新登录
      GET
  • 用户
    • 最近播放
      • 最近播放-歌曲
      • 最近播放-歌单
    • VIP
      • 黑胶乐签打卡
      • 黑胶乐签未来打卡信息
      • 黑胶乐签某日打卡详情
      • 黑胶乐签历史
      • vip 信息
    • 听歌足迹
      • 听歌足迹 - 今日收听
      • 听歌足迹 - 总收听时长
      • 听歌足迹 - 周/月/年收听报告
    • 获取用户绑定信息
      GET
    • 获取用户详情
      GET
    • 获取用户关注列表
      GET
    • 获取用户粉丝列表
      GET
    • 获取账号信息
      GET
    • 私人 FM
      GET
  • 歌单
    • 获取歌单所有歌曲
      GET
    • 获取歌单详情
      GET
    • 喜欢音乐列表
      GET
    • 获取用户歌单
      GET
    • 对歌单添加或删除歌曲
      GET
    • 新建歌单
      GET
    • 删除歌单
      GET
    • 获取每日推荐
      GET
    • 不喜欢每日推荐的某一首歌
      GET
    • 推荐歌单
      GET
    • 最近播放-歌单
      GET
  • 歌曲
    • 最近播放-歌曲
      GET
    • 获取歌词
      GET
    • 获取逐字歌词
      GET
    • 音乐是否可用
      GET
    • 获取歌曲详情
      GET
    • 喜欢音乐
      GET
    • 直接获取灰色歌曲链接
      GET
    • 302到音乐 url - 新版
      GET
    • 获取音乐 url
      GET
    • 获取音乐 url - 新版
      GET
    • 动态歌曲封面
      GET
  • 评论
    • 获取歌曲评论
    • 给评论点赞/取消
    • 评论发送
    • 评论删除
    • 回复评论
    • 获取用户历史评论
  • 通知
    • 通知 - 评论
  • 首页
    • 私人 FM
    • 获取每日推荐歌单
    • 获取每日推荐歌曲
    • 推荐歌单
    • 轮播图
    • 热门声音
    • 榜单
  • 歌手
    • 获取歌手详情
    • 热门歌手
    • 歌手粉丝数量
    • 歌手简要百科信息
    • 获取歌手简介
    • 获取歌手单曲
    • 获取关注的歌手
    • 关注/取关歌手
  • 专辑
    • 获取专辑内容
    • 获取已收藏专辑列表
    • 专辑动态信息
  • 搜索
    • 综合搜素
      • 搜索歌手
      • 单曲搜索接口
      • 歌单搜索接口
      • 专辑搜索接口
      • 歌手搜索接口
      • 播客搜索接口
      • 声音搜索接口
    • 热搜列表(简略)
    • 默认搜索关键词 PC
    • 综合搜索结果
  • 私人云盘
  • 播客
    • 我订阅的播客
    • 喜欢的声音
    • 播客的声音结果
  • 系统
    • 后端版本
  • 电台
    • 获取用户电台
    • 电台个性推荐
    • 电台 banner
    • 电台 - 今日优选
  • MV
  • 动态
    • 用户上游全部动态
    • 获取动态列表
    • 热门话题
  • 乐迷团
    • 乐迷团详情
  1. 歌曲

获取歌曲详情

开发中
GET
/song/detail

name: String, 歌曲标题
id: u64, 歌曲ID
pst: 0,功能未知
t: enum,
0: 一般类型
1: 通过云盘上传的音乐,网易云不存在公开对应
如果没有权限将不可用,除了歌曲长度以外大部分信息都为null。
可以通过 /api/v1/playlist/manipulate/tracks 接口添加到播放列表。
如果添加到“我喜欢的音乐”,则仅自己可见,除了长度以外各种信息均为未知,且无法播放。
如果添加到一般播放列表,虽然返回code 200,但是并没有效果。
网页端打开会看到404画面。
属于这种歌曲的例子: https://music.163.com/song/1345937107
2: 通过云盘上传的音乐,网易云存在公开对应
如果没有权限则只能看到信息,但无法直接获取到文件。
可以通过 /api/v1/playlist/manipulate/tracks 接口添加到播放列表。
如果添加到“我喜欢的音乐”,则仅自己可见,且无法播放。
如果添加到一般播放列表,则自己会看到显示“云盘文件”,且云盘会多出其对应的网易云公开歌曲。其他人看到的是其对应的网易云公开歌曲。
网页端打开会看到404画面。
属于这种歌曲的例子: https://music.163.com/song/435005015
ar: Vec, 歌手列表
alia: Vec,
别名列表,第一个别名会被显示作副标题
例子: https://music.163.com/song/536623501
pop: 小数,常取[0.0, 100.0]中离散的几个数值, 表示歌曲热度
st: 0: 功能未知
rt: Option, None、空白字串、或者类似600902000007902089的字符串,功能未知
fee: enum,
0: 免费或无版权
1: VIP 歌曲
4: 购买专辑
8: 非会员可免费播放低音质,会员可播放高音质及下载
fee 为 1 或 8 的歌曲均可单独购买 2 元单曲
v: u64, 常为[1, ?]任意数字, 代表歌曲当前信息版本
version: u64, 常为[1, ?]任意数字, 代表歌曲当前信息版本
crbt: Option, None或字符串表示的十六进制,功能未知
cf: Option, 空白字串或者None,功能未知
al: Album, 专辑,如果是DJ节目(dj_type != 0)或者无专辑信息(single == 1),则专辑id为0
dt: u64, 歌曲时长
hr: Option, Hi-Res质量文件信息
sq: Option, 无损质量文件信息
h: Option, 高质量文件信息
m: Option, 中质量文件信息
l: Option, 低质量文件信息
a: Option<未知>, 常为None, 功能未知
cd: Option, None或如"04", "1/2", "3", "null"的字符串,表示歌曲属于专辑中第几张CD,对应音频文件的Tag
no: u32, 表示歌曲属于CD中第几曲,0表示没有这个字段,对应音频文件的Tag
rtUrl: Option<String(?)>, 常为None, 功能未知
rtUrls: Vec<String(?)>, 常为空列表, 功能未知
djId: u64,
0: 不是DJ节目
其他:是DJ节目,表示DJ ID
copyright: u32, 0, 1, 2: 功能未知
s_id: u64, 对于t == 2的歌曲,表示匹配到的公开版本歌曲ID
mark: u64, 一些歌曲属性,用按位与操作获取对应位置的值
8192 立体声?(不是很确定)
131072 纯音乐
262144 支持 杜比全景声(Dolby Atmos)
1048576 脏标 🅴
17179869184 支持 Hi-Res
其他未知,理论上有从1到2^63共64种不同的信息
专辑信息的mark字段也同理
例子:id 1859245776 和 1859306637 为同一首歌,前者 mark & 1048576 == 1048576,后者 mark & 1048576 == 0,因此前者是脏版。

originCoverType: enum
0: 未知
1: 原曲
2: 翻唱
originSongSimpleData: Option, 对于翻唱曲,可选提供原曲简单格式的信息
single: enum,
0: 有专辑信息或者是DJ节目
1: 未知专辑
noCopyrightRcmd: Option, 不能判断出歌曲有无版权
mv: u64, 非零表示有MV ID
rtype: 常为0,功能未知
rurl: Option<String(?)>, 常为None,功能未知
mst: u32, 偶尔为0, 常为9,功能未知
cp: u64, 功能未知
publishTime: i64, 毫秒为单位的Unix时间戳
pc: 云盘歌曲信息,如果不存在该字段,则为非云盘歌曲
privilege:权限相关信息
cs:bool,是否为云盘歌曲
st:小于0时为灰色歌曲, 使用上传云盘的方法解灰后 st == 0
toast:bool,是否「由于版权保护,您所在的地区暂时无法使用。」
flLevel:免费用户的该歌曲播放音质
plLevel:当前用户的该歌曲最高试听音质
dlLevel:当前用户的该歌曲最高下载音质
maxBrLevel;歌曲最高音质

请求参数

Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/song/detail?ids=347230'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "songs": [
        {
            "name": "鲜花",
            "mainTitle": null,
            "additionalTitle": null,
            "id": 2086327879,
            "pst": 0,
            "t": 0,
            "ar": [
                {
                    "id": 27730224,
                    "name": "回春丹",
                    "tns": [],
                    "alias": []
                }
            ],
            "alia": [],
            "pop": 100,
            "st": 0,
            "rt": "",
            "fee": 8,
            "v": 41,
            "crbt": null,
            "cf": "",
            "al": {
                "id": 175805808,
                "name": "鲜花",
                "picUrl": "https://p4.music.126.net/sOVQYvAwK8rGHrwd-wM1Og==/109951173409075892.jpg",
                "tns": [],
                "pic_str": "109951173409075892",
                "pic": 109951173409075890
            },
            "dt": 341377,
            "h": {
                "br": 320000,
                "fid": 0,
                "size": 13657965,
                "vd": -54478,
                "sr": 48000
            },
            "m": {
                "br": 192000,
                "fid": 0,
                "size": 8194797,
                "vd": -51976,
                "sr": 48000
            },
            "l": {
                "br": 128000,
                "fid": 0,
                "size": 5463213,
                "vd": -50589,
                "sr": 48000
            },
            "sq": {
                "br": 1121384,
                "fid": 0,
                "size": 47851901,
                "vd": -54516,
                "sr": 48000
            },
            "hr": {
                "br": 1891146,
                "fid": 0,
                "size": 80699291,
                "vd": -54477,
                "sr": 48000
            },
            "a": null,
            "cd": "01",
            "no": 1,
            "rtUrl": null,
            "ftype": 0,
            "rtUrls": [],
            "djId": 0,
            "copyright": 0,
            "s_id": 0,
            "mark": 17716748288,
            "originCoverType": 1,
            "originSongSimpleData": null,
            "tagPicList": null,
            "resourceState": true,
            "version": 7,
            "songJumpInfo": null,
            "entertainmentTags": null,
            "awardTags": null,
            "displayTags": null,
            "artistClassics": false,
            "markTags": [],
            "songFeature": null,
            "single": 0,
            "noCopyrightRcmd": null,
            "rtype": 0,
            "rurl": null,
            "mv": 0,
            "mst": 9,
            "cp": 1416618,
            "publishTime": 0
        }
    ],
    "privileges": [
        {
            "id": 2086327879,
            "fee": 8,
            "payed": 0,
            "st": 0,
            "pl": 320000,
            "dl": 0,
            "sp": 7,
            "cp": 1,
            "subp": 1,
            "cs": false,
            "maxbr": 999000,
            "fl": 320000,
            "toast": false,
            "flag": 1544452,
            "preSell": false,
            "playMaxbr": 999000,
            "downloadMaxbr": 999000,
            "maxBrLevel": "jymaster",
            "playMaxBrLevel": "jymaster",
            "downloadMaxBrLevel": "jymaster",
            "plLevel": "exhigh",
            "dlLevel": "none",
            "flLevel": "exhigh",
            "rscl": null,
            "freeTrialPrivilege": {
                "resConsumable": false,
                "userConsumable": false,
                "listenType": null,
                "cannotListenReason": null,
                "playReason": null,
                "freeLimitTagType": null
            },
            "rightSource": 0,
            "chargeInfoList": [
                {
                    "rate": 128000,
                    "chargeUrl": null,
                    "chargeMessage": null,
                    "chargeType": 0
                },
                {
                    "rate": 192000,
                    "chargeUrl": null,
                    "chargeMessage": null,
                    "chargeType": 0
                },
                {
                    "rate": 320000,
                    "chargeUrl": null,
                    "chargeMessage": null,
                    "chargeType": 0
                },
                {
                    "rate": 999000,
                    "chargeUrl": null,
                    "chargeMessage": null,
                    "chargeType": 1
                },
                {
                    "rate": 1999000,
                    "chargeUrl": null,
                    "chargeMessage": null,
                    "chargeType": 1
                }
            ],
            "code": 0,
            "message": null,
            "plLevels": null,
            "dlLevels": null,
            "ignoreCache": null,
            "bd": null
        }
    ],
    "code": 200
}
修改于 2026-03-13 02:21:57
上一页
音乐是否可用
下一页
喜欢音乐
Built with