Docs

Sugar Snap’s API provides you with podcast feeds formatted as JSON.

Endpoint

https://sugar-snap.dev/api/podcasts

Request parameters

Include these in the URL’s query string (see below for an example).

feed_url

string

Full URL to the Podcast’s RSS feed (e.g. http://feeds.serialpodcast.org/serialpodcast )

Example request

curl "https://sugar-snap.dev/api/podcasts?feed_url=http%3A%2F%2Ffeeds.serialpodcast.org%2Fserialpodcast"

Response fields

title

string

Name of the podcast.

subtitle

string

Subtitle of the podcast if it has one, or an empty string if not.

site_url

string | null

URL to the podcast’s website (or null if not available).

cover_art

object

Podcast’s cover art.

Child fields

cover_art.url

string | null

URL to the podcast’s cover art (or null if not available).

episodes

array

List of the podcast’s episodes.

Child fields

episodes[0].title

string

Episode title.

episodes[0].description

string

Show notes in plain text.

episodes[0].audio

object

Episode audio.

Child fields

episodes[0].audio.url

string

URL to the episode’s audio file.

The vast majority of the time this is an MP3 file.

episodes[0].audio.duration_in_secs

number | null

Episode duration in seconds (or null if not available).

This is only a hint and might not be accurate.

episodes[0].audio.file_size_hint

number | null

Audio file size in bytes (or null if not available).

This is only a hint and might not be accurate.

episodes[0].audio.media_type

string | null

The media type of the audio file (or null if not available).

Usually this will be audio/mpeg for MP3 files.