---
title: "Retrieve Spotify podcast show episodes"
method: GET
path: "/spotify-podcasts/show/episodes"
tags: ["SpotifyPodcasts"]
---

# Retrieve Spotify podcast show episodes

`GET /spotify-podcasts/show/episodes`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/spotify-podcasts/show/episodes`
- Auth: API key in header `x-api-key`

Returns the episodes of a Spotify podcast by show URI, with `offset` and `limit` (1-50). Each episode has its name, description, release date, duration in milliseconds, explicit and playable flags, Spotify URI, external URL and images; `total` gives the show's episode count.

## Query parameters

- `uri` string
- `offset` integer
- `limit` integer
- `include_episode_content_ratings_v2` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SpotifyShowEpisodesResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SpotifyPodcastEpisodesResponse
    - `episodes` SpotifyPodcastEpisodeSummary[]: Episodes returned for the show.
      - `description` string: Description text of the episode.
      - `durationMs` integer: Episode length in milliseconds.
      - `externalUrl` string: Link to the episode on open.spotify.com.
      - `imageUrl` string: URL of the main cover image for the episode.
      - `images` SpotifyImageAsset[]: Cover images available for the episode, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `isExplicit` boolean: Whether Spotify marks the episode as explicit.
      - `isPlayable` boolean: Whether the episode can be played.
      - `name` string: Episode title as Spotify shows it.
      - `releaseDate` string: Date the episode was released, as Spotify returns it.
      - `type` string: Kind of item as Spotify labels it, for example `Episode`.
      - `uri` string: Spotify URI of the episode.
    - `limit` integer: Maximum number of episodes requested.
    - `meta` SpotifyPodcastEpisodesMeta
      - `appVersion` string: Version of the Spotify web player the data was read from.
      - `fetchedAt` string: Time the data was fetched, in UTC (RFC 3339).
      - `operationName` string: Name of the Spotify web player operation that returned the data.
    - `offset` integer: Position of the first episode returned.
    - `total` integer: Total number of episodes the show has on Spotify.
    - `uri` string: Spotify URI of the show whose episodes are listed.
  - `msg` unknown

## Other responses

- `400`: Missing or invalid parameters
- `429`: Rate limit exceeded
- `503`: Spotify upstream request failed

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)