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

# Retrieve Spotify podcast episode details

`GET /spotify-podcasts/episode`

## Request

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

Returns public episode metadata. Provide either uri or id; defaults to a known public episode when omitted.

## Query parameters

- `uri` string
- `id` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SpotifyEpisodeResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SpotifyPodcastEpisodeResponse
    - `description` string: Plain-text description of the episode.
    - `durationMs` integer: Episode length in milliseconds.
    - `externalUrl` string: Link to the episode on open.spotify.com.
    - `htmlDescription` string: Description of the episode with its HTML formatting.
    - `id` string: Spotify ID of the episode.
    - `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.
    - `isPaywallContent` boolean: Whether the episode is paywalled content.
    - `isPlayable` boolean: Whether the episode can be played.
    - `mediaTypes` string[]: Media types the episode is available in, for example `AUDIO`.
    - `meta` SpotifyPodcastEpisodeMeta
      - `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.
      - `sourceUrl` string: URL the data was read from.
    - `name` string: Episode title as Spotify shows it.
    - `playabilityReason` string: Reason code Spotify gives for the episode's playability, for example `PLAYABLE`.
    - `previewAudioUrl` string: URL of an audio preview of the episode.
    - `previewAudioUrls` string[]: URLs of the audio previews available for the episode.
    - `previewVideoUrl` string: URL of a video preview of the episode.
    - `releaseDate` string: Date the episode was released, as Spotify returns it.
    - `releaseDatePrecision` string: How precise the release date is, for example `DAY`.
    - `shareUrl` string: Link to the episode that Spotify offers for sharing.
    - `show` SpotifyPodcastEpisodeShowSummary
      - `description` string: Description text of the show.
      - `externalUrl` string: Link to the show on open.spotify.com.
      - `id` string: Spotify ID of the show.
      - `imageUrl` string: URL of the main cover image for the show.
      - `images` SpotifyImageAsset[]: Cover images available for the show, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `mediaType` string: Kind of media the show carries, for example `MIXED`.
      - `name` string: Show title as Spotify shows it.
      - `publisher` string: Name of the show's publisher.
      - `showTypes` string[]: Show type labels Spotify assigns, for example `PODCAST`.
      - `type` string: Kind of item as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the show.
    - `transcriptCount` integer: Number of transcripts Spotify has for the episode.
    - `type` string: Kind of item as Spotify labels it, for example `Episode`.
    - `unplayabilityReasons` string[]: Reasons the episode cannot be played, such as `not_available_in_region`.
    - `uri` string: Spotify URI of the episode.
    - `videoThumbnailUrl` string: URL of the video thumbnail for the episode.
    - `videoThumbnails` SpotifyImageAsset[]: Video thumbnails 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.
  - `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)