---
title: "曲库歌名/歌手名清单"
method: GET
path: "/songs/names"
tags: ["歌曲管理"]
---

# 曲库歌名/歌手名清单

`GET /songs/names`

一次性返回曲库中指定维度的全部去重、非空取值（按名称升序），不分页、无计数、无封面等冗余字段。
支持维度：title(歌名)/artist(歌手名)。供 TV 等第三方客户端拉取曲库名录后本地搜索匹配，替代「分页拉全部歌曲再自行去重」的浪费。
artist 按曲库原始整串返回（不按 / 、等分隔符拆分），返回的名字可直接回填 /songs?artist=<value> 精确过滤。

## Query parameters

- `field` 'title' | 'artist', required

## Response `200`

成功返回 {field, names:[...], total}

- object

## Other responses

- `400` — 缺少或不支持的 field
- `500` — 服务器错误

---

[API](https://skmtc.net/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.net/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/versions/ee41778dbf8f/schema)