> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/spotify/podcast>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/spotify/podcast.mdx>

---

# Spotify Podcast API

A podcast's details and listener rating from its Spotify id or share link.

`GET /v1/spotify/podcast` takes `podcastId` or a public `url` (`https://open.spotify.com/show/…`; Spotify calls podcasts shows). A found podcast returns `data.podcast` with `title`, `publisher`, `description`, `coverArtUrl`, `podcastUrl`, `mediaType` (audio, video or mixed), `explicit`, `playable`, `topics` and `rating` (average out of 5 and the number of ratings, when Spotify shows one).

Check `data.lookupStatus` first: an id that does not resolve answers `not_found`. For the episodes, call `GET /v1/spotify/podcast/episodes` with the same id.

## Request

- **Endpoint:** `GET /v1/spotify/podcast`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by podcast id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/spotify/podcast/get)
- **Platform page:** [/platforms/spotify](https://www.socialfetch.dev/platforms/spotify)

## FAQ

### How do I get Spotify podcast details through an API?

Call GET /v1/spotify/podcast with your Social Fetch API key (x-api-key) and either podcastId or a public open.spotify.com/show/… url. Read data.lookupStatus, then data.podcast.

### How much does the Spotify Podcast API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

### Does the response include the podcast's episodes?

No. This route returns the podcast itself. List its episodes with GET /v1/spotify/podcast/episodes, 50 a page.

### Why do Spotify podcast URLs say show?

Spotify calls podcasts shows, so a podcast's public link is open.spotify.com/show/{id}. Pass that URL, or the id after /show/, as podcastId.
