List all visible episodes for a given podcast.

GET

https://demo.azuracast.com/api/station/{station_id}/public/podcast/{podcast_id}/episodes

curl -X GET 'https://demo.azuracast.com/api/station/0/public/podcast/string/episodes'

const response = await fetch('https://demo.azuracast.com/api/station/0/public/podcast/string/episodes', {
  method: 'GET',
});

const data = await response.text();

import requests

response = requests.get('https://demo.azuracast.com/api/station/0/public/podcast/string/episodes')
print(response.text)

[
  {
    "links": {},
    "id": "string",
    "title": "string",
    "link": "string",
    "description": "string",
    "description_short": "string",
    "explicit": true,
    "season_number": 0,
    "episode_number": 0,
    "created_at": 0,
    "publish_at": 0,
    "is_published": true,
    "has_media": true,
    "playlist_media_id": "string",
    "playlist_media": {
      "text": "Chet Porter - Aluko River",
      "artist": "Chet Porter",
      "title": "Aluko River",
      "album": "Moving Castle",
      "genre": "Rock",
      "isrc": "US28E1600021",
      "lyrics": "",
      "id": "9f33bbc912c19603e51be8e0987d076b",
      "art": "https://picsum.photos/1200/1200",
      "custom_fields": [
        "custom_field_value"
      ]
    },
    "media": {
      "id": "string",
      "original_name": "string",
      "length": 0,
      "length_text": "string",
      "path": "string",
      "size": 19693056
    },
    "has_custom_art": true,
    "art": "string",
    "art_updated_at": 0
  }
]

{
  "code": 500,
  "type": "NotLoggedInException",
  "message": "Error description.",
  "formatted_message": "<b>Error description.</b><br>Detailed error text.",
  "extra_data": [],
  "success": false
}

{
  "code": 500,
  "type": "NotLoggedInException",
  "message": "Error description.",
  "formatted_message": "<b>Error description.</b><br>Detailed error text.",
  "extra_data": [],
  "success": false
}

Parameters

station_idinteger | stringrequiredpath

podcast_idstringrequiredpath

Podcast ID

Response

200OKArray<Api_PodcastEpisode>

Success

Response fields application/json

Array<Api_PodcastEpisode>

Show child attributes

linksobjectread only

Show child attributes

[key: string]string

idstring

titlestring

linkstring | null

descriptionstring

description_shortstring

explicitboolean

season_numberinteger | null

episode_numberinteger | null

created_atinteger

publish_atinteger

is_publishedboolean

has_mediaboolean

playlist_media_idstring | null

playlist_mediaApi_HasSongFields & object | null

Show child attributes

One of

textstring

The song title, usually “Artist - Title”

Example

Chet Porter - Aluko River

artiststring | null

The song artist.

Example

Chet Porter

titlestring | null

The song title.

Example

Aluko River

albumstring | null

The song album.

Example

Moving Castle

genrestring | null

The song genre.

Example

Rock

isrcstring | null

The International Standard Recording Code (ISRC) of the file.

Example

US28E1600021

lyricsstring | null

Lyrics to the song.

Example

idstring

The song’s 32-character unique identifier hash

Example

9f33bbc912c19603e51be8e0987d076b

artstring

URL to the album artwork (if available).

Example

https://picsum.photos/1200/1200

custom_fieldsArray<string>

mediaApi_PodcastMedia | null

Show child attributes

One of

idstring | null

original_namestring | null

lengthnumber<float>

length_textstring | null

pathstring | null

sizeinteger

The file size (in bytes).

Example

19693056

has_custom_artboolean

artstring | null

art_updated_atinteger

404Not FoundApi_Error

Record not found.

Response fields application/json

codeintegerrequired

The numeric code of the error.

Example

typestringrequired

The programmatic class of error.

Example

NotLoggedInException

messagestringrequired

The text description of the error.

Example

Error description.

formatted_messagestring | nullrequired

The HTML-formatted text description of the error.

Example

<b>Error description.</b><br>Detailed error text.

extra_dataArray<any>required

Stack traces and other supplemental data.

successbooleanrequired

Used for API calls that expect an \Entity\Api\Status type response.

Example

false

500Internal Server ErrorApi_Error

A generic exception has occurred.

Response fields application/json

codeintegerrequired

The numeric code of the error.

Example

typestringrequired

The programmatic class of error.

Example

NotLoggedInException

messagestringrequired

The text description of the error.

Example

Error description.

formatted_messagestring | nullrequired

The HTML-formatted text description of the error.

Example

<b>Error description.</b><br>Detailed error text.

extra_dataArray<any>required

Stack traces and other supplemental data.

successbooleanrequired

Used for API calls that expect an \Entity\Api\Status type response.

Example

false

Docs by Sourcey