getPodcasts

Returns all Podcast channels the server subscribes to, and (optionally) their episodes.
Categories:

http://your-server/rest/getPodcasts Since 1.6.0

Returns all Podcast channels the server subscribes to, and (optionally) their episodes. This method can also be used to return details for only one channel - refer to the id parameter. A typical use case for this method would be to first retrieve all channels without episodes, and then retrieve all episodes for the single channel the user selects.

Parameters

Parameter Req. OpenS. Default Comment
includeEpisodes No true (Since 1.9.0) Whether to include Podcast episodes in the returned result.
id No (Since 1.9.0) If specified, only return the Podcast channel with this ID.

Example

Result

A subsonic-response element with a nested podcasts element on success.

{
  "subsonic-response": {
    "status": "ok",
    "version": "1.16.1",
    "type": "AwesomeServerName",
    "serverVersion": "0.1.3 (tag)",
    "openSubsonic": true,
    "podcasts": {
      "channel": [
        {
          "id": "7390",
          "parent": "7389",
          "isDir": "false",
          "title": "Jonas Gahr Støre",
          "album": "NRK – Hallo P3",
          "artist": "Podcast",
          "year": "2015",
          "coverArt": "7389",
          "size": "41808585",
          "contentType": "audio/mpeg",
          "suffix": "mp3",
          "duration": "2619",
          "bitRate": "128",
          "isVideo": "false",
          "created": "2015-09-07T20:07:31.000Z",
          "artistId": "453",
          "type": "podcast",
          "streamId": "7410",
          "channelId": "17",
          "description": "Jonas Gahr Støre fra Arbeiderpartiet er med i dagens partilederutspørring i Hallo P3!",
          "status": "completed",
          "publishDate": "2015-09-07T15:29:00.000Z"
        },
        {
          "id": "3",
          "url": "https://example.com/404",
          "status": "error",
          "errorMessage": "Not Found"
        }
      ]
    }
  }
}
{
  "subsonic-response": {
    "status": "ok",
    "version": "1.16.1",
      "channel": [
        {
          "id": "7390",
          "parent": "7389",
          "isDir": "false",
          "title": "Jonas Gahr Støre",
          "album": "NRK – Hallo P3",
          "artist": "Podcast",
          "year": "2015",
          "coverArt": "7389",
          "size": "41808585",
          "contentType": "audio/mpeg",
          "suffix": "mp3",
          "duration": "2619",
          "bitRate": "128",
          "isVideo": "false",
          "created": "2015-09-07T20:07:31.000Z",
          "artistId": "453",
          "type": "podcast",
          "streamId": "7410",
          "channelId": "17",
          "description": "Jonas Gahr Støre fra Arbeiderpartiet er med i dagens partilederutspørring i Hallo P3!",
          "status": "completed",
          "publishDate": "2015-09-07T15:29:00.000Z"
        },
        {
          "id": "3",
          "url": "https://example.com/404",
          "status": "error",
          "errorMessage": "Not Found"
        }
      ]
    }
  }
}
Field Type Req. OpenS. Details
podcasts podcasts Yes The podacsts
Last modified December 16, 2024: Make old endpoints consistent with OG Subsonic, various bugfixes (#119) (a080a53)