Spotify · Guide

How to get Spotify podcast

TL;DR

To get Spotify podcast, sign up for a free Captapi key, then send one GET request to /v1/spotify/podcast with your input. You get clean JSON back in seconds for 1 credit per call — no OAuth, scraping or platform SDKs. Spotify podcast show — publisher, rating, topics, explicit flag, and totalEpisodes as clean JSON.

Get your free API key API reference

How to get Spotify podcast (step by step)

1
Get a free API key
Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.
2
Call the Spotify Podcast API
Send an authenticated GET request to /v1/spotify/podcast with your input. No OAuth, no scraping setup.
3
Read the JSON response
Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/spotify/podcast?url=https%3A%2F%2Fopen.spotify.com%2Fshow%2F4rOoJ6Egrf8K2IrywzwOMk" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "platform": "spotify",
    "type": "podcast",
    "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
    "url": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
    "name": "The Joe Rogan Experience",
    "description": "The official podcast of comedian Joe Rogan.",
    "image": "https://i.scdn.co/image/ab6765630000ba8a913317cdfae64a2585aa0f36",
    "totalEpisodes": 2731,
    "id": "4rOoJ6Egrf8K2IrywzwOMk",
    "publisher": {
      "name": "Joe Rogan"
    },
    "rating": {
      "average": 4.6556989281194445,
      "totalRatings": 952065
    },
    "topics": [
      {
        "title": "Comedy",
        "uri": "spotify:genre:0JQ5DAqbMKFNr6gDrHHVKL"
      }
    ],
    "contentRating": "EXPLICIT",
    "contentRatingLabels": [
      "EXPLICIT"
    ],
    "explicit": true,
    "mediaType": "MIXED",
    "htmlDescription": "<p>The official podcast of comedian Joe Rogan.</p>",
    "playable": true,
    "consumptionOrder": "EPISODIC",
    "showTypes": [
      "SHOW_TYPE_EXCLUSIVE"
    ]
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

Name	Type	Required	Description
url	url	Yes	Spotify show/podcast URL, URI, or ID (e.g. https://open.spotify.com/show/…). Not an artist URL.
cache	boolean	No	Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits.

Frequently asked questions

What does the Spotify Podcast API do?

The Spotify Podcast API lets you fetch full metadata and key stats from a public Spotify podcast using one GET request to /v1/spotify/podcast. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Spotify Podcast API cost?

Each successful call costs 1 credit. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a Spotify API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is publisher the same as the podcast hosts?

No. publisher.name is the show's publisher (e.g. Hubspot). Hosts are a different concept — Captapi does not stuff publisher into artists[] the way a music schema would.

What does rating mean on a podcast?

rating is an object: rating.average is Spotify's show score (about 0–5) and rating.totalRatings is how many people voted. It's the main numeric quality signal for podcast research on this endpoint — not on Spotify's free Web API.

Why is there no limit parameter?

This endpoint returns a single show. For the episode list, use /spotify/podcast-episodes (limit + cursor).

Is the Spotify Podcast API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

Ready to get Spotify podcast?

Start free with 100 credits — no credit card required.

Get your free API key