Deezer

Get Deezer episode

Get a Deezer podcast episode with the publisher's own audio link.

GET/v1/deezer/episodes/{episodeId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
episodeIdstringrequiredpath

Deezer podcast episode id, for example `871770701`.

pattern: ^[1-9]\d{0,11}$

Response fields
27

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

The episode when found; otherwise null.

dataepisodeid
integer

Episode id.

dataepisodetitle
string

Episode title.

dataepisodeurl
stringnullable

Episode page URL.

Picture URLs in four sizes.

dataepisodeimagesid
stringnullable

Image identifier; every size URL is built from it. Null when the item has no picture of its own.

dataepisodeimagessmall
stringnullable

Small image URL (about 56 px).

dataepisodeimagesmedium
stringnullable

Medium image URL (about 250 px).

dataepisodeimagesbig
stringnullable

Large image URL (about 500 px).

dataepisodeimagesxl
stringnullable

Extra-large image URL (about 1000 px).

dataepisodedescription
stringnullable

Description.

dataepisodedurationMs
integernullable

Duration in milliseconds.

dataepisodereleasedAt
stringnullable

When the episode was released (ISO-8601, UTC).

dataepisodeavailable
booleannullable

Whether the episode is available.

dataepisodeexplicit
booleannullable

Whether the show the episode belongs to is marked explicit (Deezer flags it per show).

The show the episode belongs to.

dataepisodeshowid
integer

Show id.

dataepisodeshowtitle
stringnullable

Show title.

dataepisodeaudioUrl
stringnullable

The publisher's own audio file, as Deezer links it. Often goes through a tracking redirect.

dataepisodeshowTitle
stringnullable

Title of the show.

dataepisodeisDirectStream
booleannullable

Whether the audio link is the publisher's file.

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

Code example

curl "https://api.socialfetch.dev/v1/deezer/episodes/526673645" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Podcast episode.