# Apple API: List top podcasts > Lists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes. Unofficial. Not affiliated with or endorsed by Apple. - Page: https://fous.com/methods/podcasts.apple.com/list-top-podcasts - Method: `podcasts.apple.com/list_top_podcasts`, version 1 - Website: podcasts.apple.com - Returns: rank, podcast name, episode title, publisher, category, artwork URL, Apple Podcasts URL and ID - 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_shows"` | Chart to list: top_shows or top_episodes. One of "top_shows", "top_episodes". Default "top_shows". | | `country` | string | no | `"United Kingdom"` | Country name or two-letter code, e.g. United Kingdom. Default "United States". | | `category` | string | no | `"True Crime"` | Podcast category, e.g. True Crime; use all for the overall chart. Default "all". | | `max_results` | integer | no | `100` | Maximum chart entries, e.g. 50. Category episode charts show up to 50. Default 50. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "chart": "top_shows", "country": "United Kingdom", "category": "True Crime", "max_results": 100 } ``` Its output: ```json { "top_podcasts": [ { "rank": 1, "category": "True Crime", "publisher": "RedHanded", "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/37/38/73/373873c6-ff52-d2de-945c-3a1aab729c6d/mza_18348784528713052513.jpg/600x600bb.png", "podcast_name": "RedHanded", "episode_title": null, "apple_podcast_id": "1250599915", "apple_podcasts_url": "https://podcasts.apple.com/gb/podcast/redhanded/id1250599915?uo=2" }, { "rank": 2, "category": "True Crime", "publisher": "Apple TV / Plan B / Blanchard House", "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/1f/81/f7/1f81f746-1fb8-b395-fd5f-c14c253d7215/mza_8858033765122678180.jpeg/600x600bb.png", "podcast_name": "Heart", "episode_title": null, "apple_podcast_id": "6805984512", "apple_podcasts_url": "https://podcasts.apple.com/gb/podcast/heart/id6805984512?uo=2" }, { "rank": 3, "category": "True Crime", "publisher": "The Crime Desk", "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/65/94/de/6594de34-89c6-5043-fa28-fd2bf00c5e9c/mza_10325472150443379613.jpeg/600x600bb.png", "podcast_name": "The Trial: Russell Brand", "episode_title": null, "apple_podcast_id": "1653090985", "apple_podcasts_url": "https://podcasts.apple.com/gb/podcast/the-trial-russell-brand/id1653090985?uo=2" } ] } ``` ## 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":"podcasts.apple.com/list_top_podcasts","input":{"chart":"top_shows","country":"United Kingdom","category":"True Crime","max_results":100}}' ``` 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 20 podcast shows in the UK right now? - Show me the current top episodes chart for True Crime podcasts in the United States. - Which podcasts are trending in Germany in the Comedy category? - List the top 50 overall podcast shows in Canada with their publishers. - I want the top 10 Apple Podcasts episodes in Australia for the Business category. ## Input schema ```json { "type": "object", "properties": { "chart": { "enum": [ "top_shows", "top_episodes" ], "type": "string", "default": "top_shows", "description": "Chart to list: top_shows or top_episodes." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code, e.g. United Kingdom." }, "category": { "type": "string", "default": "all", "description": "Podcast category, e.g. True Crime; use all for the overall chart." }, "max_results": { "type": "integer", "default": 50, "maximum": 100, "minimum": 1, "description": "Maximum chart entries, e.g. 50. Category episode charts show up to 50." } } } ``` ## Output schema ```json { "type": "object", "required": [ "top_podcasts" ], "properties": { "top_podcasts": { "type": "array", "items": { "type": "object", "required": [ "rank", "podcast_name", "episode_title", "publisher", "category", "artwork_url", "apple_podcasts_url", "apple_podcast_id" ], "properties": { "rank": { "type": "integer" }, "category": { "type": [ "string", "null" ] }, "publisher": { "type": [ "string", "null" ] }, "artwork_url": { "type": [ "string", "null" ] }, "podcast_name": { "type": [ "string", "null" ] }, "episode_title": { "type": [ "string", "null" ] }, "apple_podcast_id": { "type": [ "string", "null" ] }, "apple_podcasts_url": { "type": [ "string", "null" ] } } } } } } ``` ## See more - [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. - [Apple API: List top App Store charts](https://fous.com/methods/apps.apple.com/list-top-charts.md): Lists ranked iPhone or iPad apps from the public App Store charts for a chart, category, and country. App bundles and apps that are no longer available are left out. - [Apple API: Search podcasts](https://fous.com/methods/podcasts.apple.com/search-podcasts.md): Finds Apple Podcasts shows by name or topic in a country, ordered by search relevance, with ratings when the show page provides them. - [Apple API: Get podcast](https://fous.com/methods/podcasts.apple.com/get-podcast.md): Gets an Apple Podcasts show's details and its newest available episodes, by show name or Apple Podcasts link. - [Apple API: Get podcast reviews](https://fous.com/methods/podcasts.apple.com/get-podcast-reviews.md): Gets a podcast's country-specific rating total and average, plus up to 500 listener reviews sorted by newest or most helpful. - [Apple API: Search apps](https://fous.com/methods/apps.apple.com/search-apps.md): Finds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links. - [Apple API: Get artist](https://fous.com/methods/music.apple.com/get-artist.md): Gets an Apple Music artist profile by name or artist link. The profile includes the latest release, top songs and albums. - [Apple API: Search songs](https://fous.com/methods/music.apple.com/search-songs.md): Searches the Apple Music song catalog by title and artist words, returning matching tracks in relevance order with prices and previews when available. - [All Apple methods](https://fous.com/methods/apple.com.md)