---
title: "文件夹浏览"
method: GET
path: "/songs/folders"
tags: ["歌曲管理"]
---

# 文件夹浏览

`GET /songs/folders`

按目录层级浏览本地歌曲。path 为相对于 music_path 的路径（空 = 根目录），返回下一级子文件夹及其递归歌曲数和当前目录的直属歌曲。

## Query parameters

- `path` string
- `keyword` string

## Response `200`

成功 {path, parent_path, music_path, folders:[{name,path,song_count}], total_folders, songs:[...], total_songs}

- object

## Other responses

- `400` — 未设置音乐目录 / 非法路径
- `500` — 服务器错误

## Changes

- **2026-09-01** `597a7646d1ff` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/songs/folders/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)