# Spotify API: List top podcasts > Lists Spotify's top or trending podcasts for a country in chart order, with rank, movement, publisher, artwork and Spotify link. Category charts exist only for some countries. Unofficial. Not affiliated with or endorsed by Spotify. - Page: https://fous.com/methods/open.spotify.com/list-top-podcasts - Method: `open.spotify.com/list_top_podcasts`, version 1 - Website: open.spotify.com - Returns: rank, movement, places_moved, podcast name, publisher, cover image URL, Spotify URL - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `chart` | string | no | `"top_podcasts"` | Top podcasts or trending podcasts; for example, trending. Defaults to top_podcasts. One of "top_podcasts", "trending". Default "top_podcasts". | | `country` | string | no | `"United States"` | Country name or two-letter code, such as United States or US. Defaults to United States. Default "United States". | | `category` | string | no | `"Comedy"` | Top podcast category, such as Comedy, True Crime, or Business. Use all for the overall chart. Only applies to top_podcasts. Default "all". | | `max_results` | integer | no | `5` | Maximum podcasts to return, from 1 to 50; for example, 10. Defaults to 50. Default 50. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "chart": "top_podcasts", "country": "United States", "category": "Comedy", "max_results": 5 } ``` Its output: ```json { "podcasts": [ { "rank": 1, "movement": "same", "publisher": "Joe Rogan", "spotify_url": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk", "places_moved": 0, "podcast_name": "The Joe Rogan Experience", "cover_image_url": "https://i.scdn.co/image/ab67656300005f1fe7c95712f4940a9bf439467e" }, { "rank": 2, "movement": "same", "publisher": "The Ringer", "spotify_url": "https://open.spotify.com/show/1z20EiwuKoDiftKxMVLde1", "places_moved": 0, "podcast_name": "Good Hang with Amy Poehler", "cover_image_url": "https://i.scdn.co/image/ab67656300005f1faee1957f2176b367c36be8e6" }, { "rank": 3, "movement": "same", "publisher": "Theo Von", "spotify_url": "https://open.spotify.com/show/6PwE1CIZsgfrhX6Bw96PUN", "places_moved": 0, "podcast_name": "This Past Weekend w/ Theo Von", "cover_image_url": "https://i.scdn.co/image/ab67656300005f1f3c4685e830e0ce8b0597e6aa" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"open.spotify.com/list_top_podcasts","input":{"chart":"top_podcasts","country":"United States","category":"Comedy","max_results":5}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What are the top 10 podcasts in Germany right now? - Show me the trending podcasts in Japan on Spotify, with their rank changes. - I need the current top True Crime podcasts in the US, limited to 20 results. - Which podcasts are climbing fastest on the Spotify chart in Brazil? - Give me the overall top 50 podcast chart for the UK, including publisher names and cover art. ## Input schema ```json { "type": "object", "required": [], "properties": { "chart": { "enum": [ "top_podcasts", "trending" ], "type": "string", "default": "top_podcasts", "description": "Top podcasts or trending podcasts; for example, trending. Defaults to top_podcasts." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code, such as United States or US. Defaults to United States." }, "category": { "type": "string", "default": "all", "description": "Top podcast category, such as Comedy, True Crime, or Business. Use all for the overall chart. Only applies to top_podcasts." }, "max_results": { "type": "integer", "default": 50, "maximum": 50, "minimum": 1, "description": "Maximum podcasts to return, from 1 to 50; for example, 10. Defaults to 50." } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "podcasts" ], "properties": { "podcasts": { "type": "array", "items": { "type": "object", "required": [ "rank", "movement", "places_moved", "podcast_name", "publisher", "cover_image_url", "spotify_url" ], "properties": { "rank": { "type": "integer" }, "movement": { "enum": [ "up", "down", "new", "same" ], "type": "string" }, "publisher": { "type": [ "string", "null" ] }, "spotify_url": { "type": "string" }, "places_moved": { "type": [ "integer", "null" ], "description": "Zero when unchanged; null if the chart does not publish a number." }, "podcast_name": { "type": "string" }, "cover_image_url": { "type": [ "string", "null" ] } }, "additionalProperties": false }, "description": "Podcasts in chart order." } }, "additionalProperties": false } ``` ## See more - [Spotify API: Search music](https://fous.com/methods/spotify.com/search-music.md): Searches Spotify for songs, artists, albums, playlists or podcasts by keywords and returns them in Spotify's result order. Songs and albums include a release date when Spotify gives a full date. - [Spotify API: Get song](https://fous.com/methods/open.spotify.com/get-song.md): Finds a Spotify song by title (optionally narrowed by artist), track link, URI or track ID and returns its public play count and details. Without an artist, the most-played exact title match wins. Previews and ISRC may be unavailable for some tracks. - [Spotify API: Get artist](https://fous.com/methods/open.spotify.com/get-artist.md): Gets a Spotify artist's public profile from their name, artist link or ID: listeners, followers, world rank, top cities, popular tracks, latest release and release counts. - [Spotify API: Get album](https://fous.com/methods/open.spotify.com/get-album.md): Gets a Spotify album by name (optionally with the artist), album link or album ID, with its details and ordered track list including play counts. - [Apple API: List top podcasts](https://fous.com/methods/podcasts.apple.com/list-top-podcasts.md): Lists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes. - [Google API: List Google Play top charts](https://fous.com/methods/play.google.com/list-top-charts.md): Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category. - [Deezer API: List top charts](https://fous.com/methods/deezer.com/list-top-charts.md): Lists current worldwide top tracks, albums or artists on Deezer in chart order, or tracks from Deezer's official Top playlist. - [Apple API: List top charts](https://fous.com/methods/music.apple.com/list-top-charts.md): Lists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results. - [All Spotify methods](https://fous.com/methods/spotify.com.md)