Spotify

Get Spotify podcast

Get a Spotify podcast by id or podcast URL.

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

API key (`sfk_...`)

Parameters
2
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

Response fields
24

Endpoint-specific response payload.

datalookupStatus
string

Whether the podcast was found.

one of: found, not_found

Podcast details when available.

datapodcastplatform
string

Platform for this podcast.

one of: spotify

datapodcastpodcastId
string

Stable Spotify podcast identifier.

min 1 chars

datapodcasttitle
string

Podcast title.

min 1 chars

datapodcastpublisher
stringnullable

Podcast publisher when available.

datapodcastdescription
stringnullable

Podcast description as plain text when available.

datapodcastcoverArtUrl
stringnullable

Best available square cover image URL when available.

datapodcastpodcastUrl
string

Canonical public Spotify podcast URL.

min 1 chars

datapodcastmediaType
string

Media format: audio, video, mixed (audio and video episodes) or unknown.

one of: audio, video, mixed, unknown

datapodcastexplicit
boolean

Whether the podcast is marked explicit.

datapodcastplayable
booleannullable

Whether the podcast is playable on Spotify when available.

Topics Spotify lists for the podcast (may be empty).

datapodcasttopics[]
stringoptional

min 1 chars

Listener rating when Spotify shows one.

datapodcastratingaverage
number

Average listener rating out of 5.

≥ 0 · ≤ 5

datapodcastratingcount
integer

Number of listener ratings.

≥ 0

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?podcastId=3mliji9352UAk3XnWElnDV" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Spotify podcast.