---
title: "Enable users to query music playlists by type."
method: GET
path: "/gpt/getPlaylists"
---

# Enable users to query music playlists by type.

`GET /gpt/getPlaylists`

Users can request music playlists by entering keywords related to specific moods, genres, rankings, popularity, and featured content.

## Query parameters

- `locale` 'zh-tw' | 'ja-jp' | 'en-us', required
- `type` 'latest' | 'top' | 'featured' | 'pop' | 'electronic_dance' | 'hiphop' | 'kpop' | 'soundtrack' | 'rock' | 'never_go_out' | 'cpop' | 'jpop' | 'relax' | 'country' | 'hk' | 'jazz' | 'workout' | 'chill' | 'themed' | 'romance' | 'mood' | 'dinner' | 'focus' | 'travel' | 'sleep' | 'party' | 'good_mood' | 'coummute', required

## Response `200`

OK

- PlaylistsResponse
  - `gpt` object, required
    - `items` PlaylistItem[] — The playlists of musics.
      - `title` string
      - `thumbnail` string
      - `ref` string
      - `size` number
      - `releaseDate` string
      - `owner` string
      - `url` string

---

[API](https://skmtc.dev/mbplayer/apis/mixerbox-oneplayer-music-plugin.md) · [All operations](https://skmtc.dev/mbplayer/apis/mixerbox-oneplayer-music-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mbplayer/mixerbox-oneplayer-music-plugin/revisions/869476a845be/schema)