LrcShare API

主题

搜索 ​

GET /v1/search

四维度搜索，一次搜一个维度（与主站搜索框的四个 tab 一致）。

参数 ​

参数必填默认说明
keyword是—搜索关键词
type否song搜索维度：song 单曲 / album 专辑 / artist 艺术家 / lyric 歌词
limit否20每页数量，1 ~ 100
offset否0偏移量

各维度行为 ​

type匹配范围返回
song歌名 + 别名/译名（如日文歌的中文译名可直接搜）歌曲摘要数组
album专辑名Album 对象数组
artist艺术家名（含 is_show=true 的展示艺术家）Artist 对象数组
lyric歌词内容，返回命中歌曲歌曲摘要数组

type=song / lyric 返回的是轻量摘要（歌名/歌手/专辑名+年份/风格/封面），渲染选择列表用；用户确认目标后用 id 调 /v1/song/:id 获取全部数据。

响应 ​

json
{
  "code": 200,
  "data": {
    "keyword": "紫",
    "type": "song",
    "total": null,
    "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://..."
      }
    ]
  }
}
  • type=song 时 total 不返回（库端模糊搜索无精确计数），其余 type 带 total

示例 ​

bash
# 搜单曲
curl "https://api.lrcshare.com/v1/search?keyword=紫&type=song"

# 搜专辑
curl "https://api.lrcshare.com/v1/search?keyword=逍遥客&type=album"

# 用歌词内容反查歌曲
curl "https://api.lrcshare.com/v1/search?keyword=我说的&type=lyric&limit=5"