网易云歌词查询
网易云歌词查询
接口信息
GET
mini10.top/api/lyric
Method
GET
分类
音乐
Calls
10
KEY
无需 KEY
计费
免费
QPM
不限制
鉴权方式
无需密钥
作者
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| id | string | 是 | 歌曲id | 21233962 |
[
{
"name": "id",
"type": "string",
"required": true,
"description": "歌曲id",
"example": "21233962"
}
]
{"openapi":"3.1.1","info":{"title":"网易云歌词查询","description":"网易云歌词查询","version":"1.0.0"},"paths":{"/api/lyric":{"get":{"summary":"网易云歌词查询","description":"网易云歌词查询","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","example":"21233962"},"description":"歌曲id"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"https://mini10.top","description":"当前访问入口(https)"}]}
返回示例
{
"sgc": false,
"sfy": false,
"qfy": false,
"transUser": {
"id": 1967399,
"status": 99,
"demand": 1,
"userid": 48187258,
"nickname": "淡写晚风l",
"uptime": 1439458407014
},
"lrc": {
"version": 7,
"lyric": "[00:00.000] 作词 : Lionel Richie\n[00:01.000] 作曲 : Lionel Richie\n[00:07.959]My love\n[00:11.460]There's only you in my life\n[00:16.460]The only thing that's right\n[00:22.520]Oh yeah\n[00:22.960]My first love yeah\n[00:27.600]You're every breath that I take\n[00:31.600]You're every step I make\n[00:36.669]Oh\n[00:37.549]And I\n[00:39.49]And I\n[00:40.979]I want to share\n[00:44.539]All my love with you, hey yeah\n[00:51.419]No-one else will do mh\n[00:56.669]And your eyes your eyes, your eyes\n[01:00.989]They tell me how much you care\n[01:06.789]Oh, yes\n[01:09.849]You will always be\n[01:16.899]My endless love\n[01:21.489]\n[01:23.909]Oh yeah\n[01:26.29]\n[01:27.729]Two hearts\n[01:31.229]Two hearts that beat as one\n[01:35.979]Our lives have just begun\n[01:41.969]And forever forever\n[01:46.349]I'll hold you close in my arms\n[01:51.349]I can't resist your charms\n[01:55.979]No no no no no no no\n[01:57.599]And I\n[01:59.479]And I\n[02:01.699]I'd be a fool\n[02:04.349]For you, I'm sure\n[02:10.540]You know I don't mind no, you know I don't mind\n[02:18.220]'Cause baby you baby, baby, baby, baby\n[02:21.410]You mean the world to me, yeah\n[02:28.100]I know I've found in you\n[02:35.920]My endless love\n[02:41.350]\n[02:52.230]Yeah yeah\n[02:53.290]Do do, do dooo, do do do\n[03:05.650]Whooooa\n[03:07.210]And I\n[03:11.330]I'd play the fool\n[03:14.220]For you, for you baby I'm sure\n[03:20.960]You know I don't mind you know I don't mind\n[03:27.400]Oh, yes\n[03:30.970]You'd be the only one\n[03:37.20]'Cause no-one can't deny\n[03:42.400]This love I have inside\n[03:47.220]And I'll give it all to you\n[03:51.970]My love my love, my love\n[03:55.840]My my my\n[03:56.960]My endless love\n[04:01.900]Mmh\n[04:07.590]My love\n"
},
"tlyric": {
"version": 3,
"lyric": "[by:Lemonadelike]\n[00:07.959]我的爱\n[00:11.460]在我的生命中只有你\n[00:16.460]是唯一正确的事情\n[00:22.520]哦耶\n[00:22.960]我的初恋 耶\n[00:27.600]你是我的每一次呼吸\n[00:31.600]你是我迈出的每一个步伐\n[00:36.669]哦\n[00:37.549]我\n[00:39.49]我\n[00:40.979]我想分享\n[00:44.539]与你分享我全部的爱 嘿耶\n[00:51.419]没有人能如此\n[00:56.669]你的双眸,你的双眸,你的双眸\n[01:00.989]他们告诉我你有多重要\n[01:06.789]哦, 是的\n[01:09.849]你会是\n[01:16.899]我无尽的爱\n[01:23.909]哦耶\n[01:27.729]两颗心\n[01:31.229]两颗心一起跳动\n[01:35.979]我们的生命刚刚开始\n[01:41.969]持续到永远,永远\n[01:46.349]我会紧紧把你拥进怀里\n[01:51.349]我不能抵挡你的魅力\n[01:55.979]不~\n[01:57.599]我\n[01:59.479]我\n[02:01.699]我想是一个傻子\n[02:04.349]是你的傻子,我确信\n[02:10.540]你知道我不在意,你知道我不在意\n[02:18.220]因为你是我的宝贝\n[02:21.410]对我而言你是我的全世界\n[02:28.100]我知道我会找到你\n[02:35.920]我无尽的爱\n[02:52.230]耶~\n[02:53.290]嘟~\n[03:05.650]哇哦\n[03:07.210]我\n[03:11.330]我像个傻子\n[03:14.220]是你的傻子\n[03:20.960]你知道我并不介意\n[03:27.400]哦,是的\n[03:30.970]你是我的唯一\n[03:37.20]没人能拒绝\n[03:42.400]我内心的爱意\n[03:47.220]将全部给你\n[03:51.970]我的爱,我的爱,我的爱\n[03:55.840]我的~\n[03:56.960]我无尽的爱\n[04:01.900]嗯~\n[04:07.590]我的爱\n"
},
"code": 200
}
接口反馈
网易云歌词查询
接口说明
按歌曲 ID 获取网易云歌词内容,返回原文歌词与翻译歌词,便于在歌词展示、播放器或歌词检索类应用中使用。接口免费,无需密钥。
调用地址
https://mini10.top/api/lyric
请求方式
GET。调用时以查询参数形式携带歌曲 id,例如 https://mini10.top/api/lyric?id=21233962。
鉴权说明
本接口无需密钥,可直接调用,且不产生费用。
请求参数
调用地址:https://mini10.top/api/lyric,请求方式:GET。本接口无需密钥,免费调用。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 歌曲 ID,取自网易云音乐歌曲对应的数字标识,以字符串形式传入,如 21233962 |
参数取值说明:
id须为纯数字字符串,直接使用歌曲页面地址中id=后的数值,不要附加其他字符或空格。- 该参数为唯一查询条件,需随请求一并提交,缺失或格式不正确时将无法定位歌曲。
成功响应示例
请求成功后返回 JSON 对象,code 为 200,歌词正文位于 lrc 与 tlyric 中(下列歌词内容有删减):
{
"sgc": false,
"sfy": false,
"qfy": false,
"transUser": {
"id": 1967399,
"status": 99,
"demand": 1,
"userid": 48187258,
"nickname": "淡写晚风l",
"uptime": 1439458407014
},
"lrc": {
"version": 7,
"lyric": "[00:00.000] 作词 : Lionel Richie\n[00:01.000] 作曲 : Lionel Richie\n[00:07.959]My love\n[00:11.460]There's only you in my life\n[00:16.460]The only thing that's right\n[01:16.899]My endless love\n"
},
"tlyric": {
"version": 3,
"lyric": "[by:Lemonadelike]\n[00:07.959]我的爱\n[00:11.460]在我的生命中只有你\n[00:16.460]是唯一正确的事情\n[01:16.899]我无尽的爱\n"
},
"code": 200
}
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| sgc | boolean | 歌词属性标记,布尔值 |
| sfy | boolean | 歌词属性标记,布尔值 |
| qfy | boolean | 歌词属性标记,布尔值 |
| transUser | object | 翻译歌词的贡献者信息,无贡献者信息时可能为空 |
| transUser.id | number | 贡献者记录标识 |
| transUser.status | number | 贡献者记录状态值 |
| transUser.demand | number | 贡献者记录关联数值 |
| transUser.userid | number | 贡献者用户标识 |
| transUser.nickname | string | 贡献者昵称 |
| transUser.uptime | number | 贡献时间,毫秒级时间戳 |
| lrc | object | 原文歌词对象 |
| lrc.version | number | 歌词版本号 |
| lrc.lyric | string | 原文歌词文本,LRC 格式,逐行以 [分:秒.毫秒] 时间标签开头,行间以换行符分隔 |
| tlyric | object | 翻译歌词对象,结构与 lrc 一致;该歌曲无翻译歌词时内容为空 |
| tlyric.version | number | 翻译歌词版本号 |
| tlyric.lyric | string | 翻译歌词文本,LRC 格式,可包含 [by:作者] 等标签行 |
| code | number | 响应状态,200 表示查询成功 |
错误响应示例
调用失败时返回统一结构的 JSON,code 固定为 0,msg 为错误说明,errcode 为业务错误码:
{
"code": 0,
"msg": "歌曲id不能为空",
"errcode": 11013
}
密钥相关错误示例(本接口无需密钥,仅用于说明统一错误结构):
{
"code": 0,
"msg": "未提供调用密钥",
"errcode": 11001
}
服务侧异常示例:
{
"code": 0,
"msg": "服务暂不可用",
"errcode": 11017
}
业务错误码说明
| errcode | 含义 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
| 11023 | 密钥已过期 |
| 11024 | 令牌分配积分不足 |
| 11025 | 该密钥无权调用此接口 |
调用示例
终端 curl(bash)
curl "https://mini10.top/api/lyric?id=21233962"
PHP
// PHP 示例
$url = "https://mini10.top/api/lyric?id=21233962";
$response = file_get_contents($url);
$data = json_decode($response, true);
if (isset($data['lrc']['lyric'])) {
echo $data['lrc']['lyric'];
} else {
echo "未获取到歌词内容";
}
注意事项
- 调用地址固定为
https://mini10.top/api/lyric,请勿改写域名或路径;建议全程使用 HTTPS 访问,避免在公共网络下以明文方式传输参数与返回内容。 - 本接口无需密钥,免费调用,但请勿因此将其视作可无限制压测的公共资源;批量拉取歌词时请控制并发与请求节奏,避免高频重复请求同一
id。 id为必填的歌曲 id 字符串,需使用目标歌曲对应的数字 id(如21233962),不要传入歌名、歌手名或完整链接;id 错误时可能返回空歌词或非预期结果,请在业务侧对空结果做兜底处理。- 返回值中
lrc.lyric为原文歌词、tlyric.lyric为翻译歌词,均为带时间戳的 LRC 文本,含\n换行与[mm:ss.xxx]标记,渲染前请按文本处理并做转义,不要直接作为 HTML 插入页面,以防注入风险。 - 并非所有歌曲都带翻译,
tlyric.lyric可能为空;sgc、sfy、qfy等字段用于标识歌词的附加属性,业务逻辑应以code与lrc.lyric是否为空作为主要判断依据,不要依赖单一字段。 - 翻译歌词由用户贡献,作者信息与时间等信息随返回内容一并给出,展示时请保留原有署名行,不要删改或伪造成自有内容。
- 返回体量随歌词长度变化,个别歌曲文本较长,客户端应设置合理的超时与响应体大小上限,避免因单次响应过大导致解析阻塞。
- 请勿将本接口返回内容用于超出授权范围的商业分发;歌词版权归原权利人所有,如需公开传播请自行确认合规性。
快速上手
curl "https://mini10.top/api/lyric?id=21233962"
在线测试
请求地址
mini10.top/api/lyric
参数
Response
// 结果将在此处显示