Get information for a public episode of a public podcast.

GET

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

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

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

const data = await response.text();

import requests

response = requests.get('https://demo.azuracast.com/api/station/0/public/podcast/string/episode/string')
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

episode_idstringrequiredpath

Podcast Episode ID

Response

200OKHasLinks & object

Success

Response fields application/json

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