LrcShare API

主题

歌曲与歌词 ​

歌曲列表 ​

GET /v1/songs

最新收录的歌曲（按收录时间倒序），用于增量同步全站曲目。

参数默认说明
limit20每页数量，1 ~ 100
offset0偏移量

返回轻量摘要（与搜索 type=song 同构），适合渲染选择列表：

json
{
  "code": 200,
  "data": {
    "total": 532,
    "limit": 20,
    "offset": 0,
    "items": [
      {
        "id": "s_purplesoul_013",
        "title": "歌名",
        "artists": [{ "id": "art_xxx", "name": "歌手" }],
        "album": { "id": "alb_xxx", "name": "专辑名", "year": "2024", "cover": "https://..." },
        "genres": ["Hip-Hop"],
        "cover": "https://..."
      }
    ]
  }
}

歌曲详情 ​

GET /v1/song/:id

用户在列表中确认目标后调用，一次请求返回全部数据——元数据、词曲编署名、歌词、来源 comment 全在这里。

json
{
  "code": 200,
  "data": {
    "id": "s_purplesoul_013",
    "title": "歌名",
    "aliases": ["别名"],
    "artists": [{ "id": "art_xxx", "name": "歌手" }],
    "album": { "id": "alb_xxx", "name": "专辑名", "year": "2024", "cover": "https://..." },
    "track": 3,
    "disc": 1,
    "genres": ["Hip-Hop"],
    "lyricist": ["词作者"],
    "composer": ["曲作者"],
    "arranger": ["编曲"],
    "cover": "https://...",
    "contributor": "贡献者",
    "comment": "本歌词来自于:贡献者@lrcshare.com",
    "video_url": "https://www.bilibili.com/video/...",
    "created_at": "2026-08-01T12:00:00+00:00",
    "lrc": "[00:00.00] ...\n本歌词来自于:贡献者@lrcshare.com"
  }
}

字段说明：

字段说明
lrc完整时间轴的 LRC 歌词，末尾自动追加一行来源署名（纯文本行，不带时间戳），写入播放器或音乐文件标签后来源可溯；无 LRC 数据时为 null
comment署名字符串，可直接整串写入音乐文件的 comment 标签；无贡献者时为 本歌词来自于:lrcshare.com
lyricist / composer / arranger作词 / 作曲 / 编曲（名字数组）
  • id 不存在或未发布时返回 404
  • 写音乐标签建议：LYRICS ← lrc，COMMENT ← comment，其余按字段对应

示例 ​

bash
curl "https://api.lrcshare.com/v1/songs?limit=10&offset=20"
curl "https://api.lrcshare.com/v1/song/s_purplesoul_013"