---
title: "Enable users to query podcasts by type."
method: GET
path: "/gpt/getPodcastsByCategory"
---

# Enable users to query podcasts by type.

`GET /gpt/getPodcastsByCategory`

## Request

- Base URL: `https://www.mbplayer.com`
- URL: `https://www.mbplayer.com/gpt/getPodcastsByCategory`
- Auth: none declared

Users can request a specific kind of podcast using relevant keywords related to music, comedy, news, crime, education, history, TV & film, government, society & culture, and religion & spirituality.

## Query parameters

- `locale` 'zh-tw' | 'ja-jp' | 'en-us', required
- `categoryId` '1310' | '1303' | '1489' | '1488' | '1304' | '1309' | '1487' | '1314' | '1511' | '1324', required

## Response `200`

OK

- PodcastsResponse
  - `gpt` object, required
    - `items` PodcastItem[]: The array of Podcasts.
      - `title` string
      - `image` string
      - `author` string
      - `language` string
      - `url` string
      - `id` 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.dev/mbplayer/apis/mixerbox-oneplayer-music-plugin/revisions/869476a845be?raw)