歌单管理

获取歌单列表

获取歌单列表，支持按类型过滤、按歌单内歌曲来源过滤、关键词搜索和分页。默认排除隐藏歌单，传 exclude_labels=none 显示全部。 song_source 按歌单内歌曲的来源筛选（歌单本身没有来源字段，只能由歌曲反推）：remote=歌单内含网络歌曲（「网络歌单」），local=含本地歌曲（「本地歌单」）。判定是 EXISTS 而非「全部是」，故本地+网络混合的歌单在两个取值下都会出现，空歌单两个取值下都不出现。电台歌曲的 type 是 radio 而非 remote，故电台歌单不会被 song_source=remote 命中。

get/playlists

Query parameters

type'normal' | 'radio'

歌单类型

song_source'remote' | 'local'

按歌单内歌曲来源过滤: remote=含网络歌曲, local=含本地歌曲

keywordstring

搜索关键词（模糊匹配歌单名称/描述）

exclude_labelsstring

要排除的标签(逗号分隔), 默认排除 hidden; 传 none 显示全部

limitinteger

每页数量

offsetinteger

偏移量

Response

成功返回歌单列表

object required

Changes

Changed in 4 of the 136 revisions of this API.24

Sep 7, 2026711b5d7626a52See the full diff
- ○
  added the new optional query request parameter song_source
  new-optional-request-parameter
- ○
  added the non-success response with the status
  response-non-success-status-added
Jul 15, 2026b7ceb0f5da661See the full diff
- ○
  added the new optional query request parameter keyword
  new-optional-request-parameter
Jun 30, 202634b04ad1f4761See the full diff
- ○
  added the new optional query request parameter exclude_labels
  new-optional-request-parameter
Jun 26, 2026be19914b7eed2See the full diff
- ●
  deleted the query request parameter exclude_labels
  request-parameter-removed
- ●
  deleted the query request parameter keyword
  request-parameter-removed

Full history