List Spotify podcast episodes
List a Spotify podcast's episodes by id or podcast URL.
Headers
Get your API keyAPI key (`sfk_...`)
Spotify podcast id, such as `3mliji9352UAk3XnWElnDV`. Pass this or `url`.
min 1 chars · max 128 chars
Public Spotify podcast URL, such as `https://open.spotify.com/show/3mliji9352UAk3XnWElnDV`. Pass this or `podcastId`.
min 1 chars · max 4096 chars
Pass `page.nextCursor` from the previous response to get the next page.
min 1 chars · max 9 chars
Endpoint-specific response payload.
Whether the podcast was found.
one of: found, not_found
Spotify podcast id the episodes belong to when found.
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.
Stable Spotify episode identifier.
min 1 chars
Episode title.
min 1 chars
Episode description as plain text when available.
Episode duration in milliseconds when available.
≥ 0
Release date and time as an ISO 8601 string when available.
Whether the episode is marked explicit.
Whether the episode is playable on Spotify when available.
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)
Format the episode is published in.
one of: audio, video
Best available square cover image URL when available.
Short audio preview URL when available.
Canonical public Spotify episode URL.
min 1 chars
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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.