Spotify

List Spotify podcast episodes

List a Spotify podcast's episodes by id or podcast URL.

GET/v1/spotify/podcast/episodes
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
podcastIdstringquery

Spotify podcast id, such as `3mliji9352UAk3XnWElnDV`. Pass this or `url`.

min 1 chars · max 128 chars

urlstringquery

Public Spotify podcast URL, such as `https://open.spotify.com/show/3mliji9352UAk3XnWElnDV`. Pass this or `podcastId`.

min 1 chars · max 4096 chars

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 9 chars

Response fields
27

Endpoint-specific response payload.

datalookupStatus
string

Whether the podcast was found.

one of: found, not_found

datapodcastId
stringnullable

Spotify podcast id the episodes belong to when found.

datatotalCount
integernullable

Total number of episodes the podcast has when available.

≥ 0

Episodes on this page in the podcast's own order (newest first for most podcasts), up to 50.

dataepisodes[]episodeId
string

Stable Spotify episode identifier.

min 1 chars

dataepisodes[]title
string

Episode title.

min 1 chars

dataepisodes[]description
stringnullable

Episode description as plain text when available.

dataepisodes[]durationMs
integernullable

Episode duration in milliseconds when available.

≥ 0

dataepisodes[]releaseDate
stringnullable

Release date and time as an ISO 8601 string when available.

dataepisodes[]explicit
boolean

Whether the episode is marked explicit.

dataepisodes[]playable
booleannullable

Whether the episode is playable on Spotify when available.

dataepisodes[]paywalled
booleannullable

Whether the episode is behind a paywall (subscriber only) when available.

Formats the episode is published in (audio, video or both).

any of: audio, video (comma-separated)

dataepisodes[]mediaTypes[]
stringoptional

Format the episode is published in.

one of: audio, video

dataepisodes[]coverArtUrl
stringnullable

Best available square cover image URL when available.

dataepisodes[]previewUrl
stringnullable

Short audio preview URL when available.

dataepisodes[]episodeUrl
string

Canonical public Spotify episode URL.

min 1 chars

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/spotify/podcast/episodes?podcastId=3mliji9352UAk3XnWElnDV" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Spotify podcast episodes.