Spotify

Podcast / Episodes

per_call

Returns a podcast show record — name, publisher, description, language, total episodes and artwork — and a paginated list of its episodes with titles, descriptions, durations, explicit flags and release dates. Use it for podcast research, guest tracking and monitoring publishing cadence across a show catalog.

Endpoint

GET /v1/spotify/podcast-episodes

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

optional

string

The Spotify show ID. Required unless `url` is supplied.

url

optional

string

The public Spotify show URL. Required unless `id` is supplied.

cursor

optional

string

Pagination cursor returned by a previous response.

Example request

Sandbox calls return deterministic sample data in the live payload shape.

curl

curl "https://api.fastfetchz.com/v1/spotify/podcast-episodes?id=4rOoJ6Egrf8K2IrywzwOMk" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json

{
  "success": true,
  "service": {
    "platform": "Spotify",
    "name": "Podcast / Episodes",
    "slug": "podcast-episodes"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "show": {
      "id": "4rOoJ6Egrf8K2IrywzwOMk",
      "name": "The Joe Rogan Experience",
      "publisher": "Joe Rogan",
      "description": "Long form conversations with a wide range of guests.",
      "language": "en",
      "total_episodes": 2284,
      "explicit": true,
      "image_url": "https://cdn.example.com/spotify/show/jre.jpg"
    },
    "episodes": [
      {
        "id": "5rXvUmR3fFZgFhQ1MtBW9E",
        "name": "#2210 - Sample Guest",
        "description": "A sandbox episode description.",
        "duration_ms": 10812000,
        "explicit": true,
        "release_date": "2026-08-22"
      },
      {
        "id": "1TDhaMuoAvRhLnGRfVfLxA",
        "name": "#2209 - Another Guest",
        "description": "A sandbox episode description.",
        "duration_ms": 8940000,
        "explicit": true,
        "release_date": "2026-08-19"
      }
    ],
    "paging": {
      "has_more": true,
      "next_cursor": "cursor_20"
    },
    "requested": "nasa"
  }
}

Error codes

StatusCodeMeaning

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.

402insufficient_creditsYour balance is below the cost of the call. Top up to continue.

403account_suspended / key_revokedThe account is suspended or the key was revoked.

429rate_limitedThe key exceeded its monthly cap or the burst limit. Retry later.

500upstream_errorUnexpected failure while fulfilling the request. Not charged.