Deezer

List Deezer show episodes

List the episodes of a Deezer podcast show, newest first, with paging.

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

API key (`sfk_...`)

Parameters
3
showIdstringrequiredpath

Deezer podcast show id, for example `1000702442`.

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

limitintegeroptionalquery

Items per page, 1 to 100. Default: 50.

≥ 1 · ≤ 100

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.

min 1 chars · max 1000 chars

Response fields
29

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

Episodes, newest first.

dataepisodes[]id
integer

Episode id.

dataepisodes[]title
string

Episode title.

dataepisodes[]url
stringnullable

Episode page URL.

Picture URLs in four sizes.

dataepisodes[]imagesid
stringnullable

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

dataepisodes[]imagessmall
stringnullable

Small image URL (about 56 px).

dataepisodes[]imagesmedium
stringnullable

Medium image URL (about 250 px).

dataepisodes[]imagesbig
stringnullable

Large image URL (about 500 px).

dataepisodes[]imagesxl
stringnullable

Extra-large image URL (about 1000 px).

dataepisodes[]description
stringnullable

Description.

dataepisodes[]durationMs
integernullable

Duration in milliseconds.

dataepisodes[]releasedAt
stringnullable

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

dataepisodes[]available
booleannullable

Whether the episode is available.

dataepisodes[]explicit
booleannullable

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

The show the episode belongs to.

dataepisodes[]showid
integer

Show id.

dataepisodes[]showtitle
stringnullable

Show title.

datatotal
integernullable

Number of episodes in the show.

dataavailable
booleannullable

Whether Deezer makes this show's episodes available. False for a disabled show that still reports a total; `episodes` is then empty.

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

Code example

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

Responses

Episodes of a podcast show.