---
title: "获取歌单列表"
method: GET
path: "/playlists"
tags: ["歌单管理"]
---

# 获取歌单列表

`GET /playlists`

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

## Query parameters

- `type` 'normal' | 'radio'
- `song_source` 'remote' | 'local'
- `keyword` string
- `exclude_labels` string
- `limit` integer
- `offset` integer

## Response `200`

成功返回歌单列表

- object

## Other responses

- `400` — song_source 取值非法
- `500` — 服务器错误

## Changes

- **2026-09-07** `711b5d7626a5` — 2 info
  - added the new optional `query` request parameter `song_source`
  - added the non-success response with the status `400`
- **2026-07-15** `b7ceb0f5da66` — 1 info
  - added the new optional `query` request parameter `keyword`
- **2026-06-30** `34b04ad1f476` — 1 info
  - added the new optional `query` request parameter `exclude_labels`
- **2026-06-26** `be19914b7eed` — 2 warning
  - deleted the `query` request parameter `exclude_labels`
  - deleted the `query` request parameter `keyword`

[Change history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/playlists/get.md)

---

[API](https://skmtc.dev/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.dev/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc.dev/songloft-org/apis/songloft-api/revisions/94a164c257e6?raw)