SpotifyPodcasts

Retrieve Spotify podcast charts

Returns Spotify podcast chart rankings from podcastcharts.byspotify.com. The chart and region parameters are validated against Spotify's supported podcast chart slugs and countries. Category charts are available only in au, br, de, gb, mx, se, and us.

get/spotify-podcasts/charts

Request

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

Query parameters

chart'top-podcasts' | 'top-episodes' | 'trending' | 'arts' | 'business' | 'comedy' | 'education' | 'fiction' | 'health-fitness' | 'history' | 'leisure' | 'music' | 'news' | 'religion-spirituality' | 'science' | 'society-culture' | 'sports' | 'technology' | 'true-crime' | 'tv-film'

Chart slug. Allowed: top-podcasts, top-episodes, trending, arts, business, comedy, education, fiction, health-fitness, history, leisure, music, news, religion-spirituality, science, society-culture, sports, technology, true-crime, tv-film

region'ar' | 'au' | 'at' | 'br' | 'ca' | 'cl' | 'co' | 'dk' | 'fi' | 'fr' | 'de' | 'in' | 'id' | 'ie' | 'it' | 'jp' | 'mx' | 'nz' | 'no' | 'ph' | 'pl' | 'es' | 'se' | 'nl' | 'gb' | 'us'

Two-letter region code. Allowed: ar, au, at, br, ca, cl, co, dk, fi, fr, de, in, id, ie, it, jp, mx, nz, no, ph, pl, es, se, nl, gb, us

limitinteger

Result limit, clamped to 1-100

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "chart": "top-podcasts",
    "chartName": "Top Podcasts",
    "chartType": "chart",
    "items": [
      {
        "description": "The official podcast of comedian Joe Rogan.",
        "episodeDescription": "A representative chart episode.",
        "episodeExternalUrl": "https://open.spotify.com/episode/2C2Y5kNq7qCVOVhbA0G3os",
        "episodeImageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "episodeName": "Example episode",
        "episodeUri": "spotify:episode:2C2Y5kNq7qCVOVhbA0G3os",
        "externalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "imageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "name": "The Joe Rogan Experience",
        "publisher": "Joe Rogan",
        "rank": 1,
        "rankMove": "UNCHANGED",
        "showDescription": "The official podcast of comedian Joe Rogan.",
        "showExternalUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk",
        "showImageUrl": "https://i.scdn.co/image/ab67656300005f1f54e6837957803d762a3f4d2b",
        "showName": "The Joe Rogan Experience",
        "showPublisher": "Joe Rogan",
        "showUri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
        "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk"
      }
    ],
    "limit": 100,
    "meta": {
      "count": 100,
      "fetchedAt": "2026-05-13T20:41:13Z",
      "sourceUrl": "https://podcastcharts.byspotify.com/api/charts/top-podcasts?region=us"
    },
    "region": "us",
    "regionName": "United States"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.