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

# Retrieve Spotify podcast show metadata

`GET /spotify-podcasts/show`

## Request

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

Returns metadata for one Spotify podcast show by `uri` (default `spotify:show:1QQJ7FElLE0K6CIfZNCxU4`): name, publisher, description, media type, explicit flag, `totalEpisodes`, cover images and Spotify URL. The two `include_` flags request extra content capability and content rating fields when Spotify supplies them.

## Query parameters

- `uri` string
- `include_content_capability_trait` boolean
- `include_episode_content_ratings_v2` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SpotifyShowResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SpotifyShowMetadataResponse
    - `description` string
    - `externalUrl` string
    - `imageUrl` string
    - `images` SpotifyImageAsset[]
      - `height` integer: Image height in pixels.
      - `url` string: URL of the image.
      - `width` integer: Image width in pixels.
    - `isExplicit` boolean
    - `mediaType` string
    - `meta` SpotifyShowMetadataMeta
      - `appVersion` string
      - `fetchedAt` string
      - `operationName` string
    - `name` string
    - `publisher` string
    - `totalEpisodes` integer
    - `type` string
    - `uri` string
  - `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/afac9b012a27?raw)