Apple API: Get podcast
Gets an Apple Podcasts show's details and its newest available episodes, by show name or Apple Podcasts link.
Unofficial. Not affiliated with or endorsed by Apple.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Country optional
country Country name or two-letter code for listings and ratings, such as United States or GB.
United States (default)
- Podcast, required
podcast Podcast name or Apple Podcasts show link, such as The Daily.
The Daily
- Max Episodes optional
max_episodes Maximum number of recent episodes to return, such as 20.
20 (default)
Whole number from 1 to 300.
Input as JSON
{ "podcast": "The Daily"}Output
{ "name": "The Daily", "category": "Daily News", "episodes": [ { "title": "The Battle Over Black Representation in the South", "length": "29 min", "description": "The approach to this year’s midterms has brought two hugely consequential changes to voting for Black Americans: the gutting of the Voting Rights Act, and redistricting. In the wake of those actions, efforts are underway to mobilize Black voters in the South. In Mississippi, the Senate battle is bei…", "episode_url": null, "release_date": "2026-10-23", "audio_file_url": "https://dts.podtrac.com/redirect.mp3/pdst.fm/e/pfx.vpixl.com/6qj4J/pscrb.fm/rss/p/tracking.swap.fm/track/4jdbJYYRKqK96EGqOzQb/nyt.simplecastaudio.com/03d8b493-87fc-4bd1-931f-8a8e9b945d8a/episodes/60ffceb7-687b-4c09-b075-cd86e8bd477f/audio/128/default.mp3?aid=rss_feed&awCollectionId=03d8b493-87fc-4bd…" , "length_seconds": 1775 }, { "title": "The Election That Will Define Israel’s Future", "length": "33 min", "description": "Israelis head to the polls next week. On the ballot is the future of a country that has become isolated on the world stage, because of both its war in Gaza and a growing outcry over settler violence in the West Bank. David M. Halbfinger, the Jerusalem bureau chief for The New York Times, explains ho…", "episode_url": "https://podcasts.apple.com/us/podcast/the-election-that-will-define-israels-future/id1200361736?i=1000797595841" , "release_date": "2026-10-22", "audio_file_url": "https://dts.podtrac.com/redirect.mp3/pdst.fm/e/pfx.vpixl.com/6qj4J/pscrb.fm/rss/p/tracking.swap.fm/track/4jdbJYYRKqK96EGqOzQb/nyt.simplecastaudio.com/03d8b493-87fc-4bd1-931f-8a8e9b945d8a/episodes/4d142ed1-ec9d-470b-b52b-ba35e33fedf6/audio/128/default.mp3?aid=rss_feed&awCollectionId=03d8b493-87fc-4bd…" , "length_seconds": 2032 }, { "title": "Is This Economy as Awful as Voters Think? We Ask Our Expert.", "length": "32 min", "description": "The economy is one of the most important issues for voters in the midterm elections. President Trump has been trying to persuade Americans that they are wrong to be frustrated about the cost of living. Ben Casselman, the chief economics correspondent for The New York Times, explains what the latest …", "episode_url": "https://podcasts.apple.com/us/podcast/is-this-economy-as-awful-as-voters-think-we-ask-our-expert/id1200361736?i=1000797417699" , "release_date": "2026-10-21", "audio_file_url": "https://dts.podtrac.com/redirect.mp3/pdst.fm/e/pfx.vpixl.com/6qj4J/pscrb.fm/rss/p/tracking.swap.fm/track/4jdbJYYRKqK96EGqOzQb/nyt.simplecastaudio.com/03d8b493-87fc-4bd1-931f-8a8e9b945d8a/episodes/93fe65fc-d93d-490d-b13f-c5a17049a898/audio/128/default.mp3?aid=rss_feed&awCollectionId=03d8b493-87fc-4bd…" , "length_seconds": 1949 } ], "publisher": "The New York Times", "podcast_id": "1200361736", "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/ab/64/66/ab6466a9-9a7d-e20e-7a3d-bc5be37d29ce/mza_15084852813176276273.jpg/1200x1200bb.jpg" , "description": "This is what the news should sound like. The biggest stories of our time, told by the best journalists in the world. Hosted by Michael Barbaro, Rachel Abrams and Natalie Kitroeff. Twenty minutes a day, six days a week, ready by 6 a.m. Subscribe today at nytimes.com/podcasts or on Apple Podcasts, Spo…" , "website_url": "https://www.nytimes.com/the-daily" , "rating_count": 106007, "rss_feed_url": "https://feeds.simplecast.com/Sl5CSM3S" , "average_rating": 4.3, "update_frequency": "Updated Daily", "apple_podcasts_url": "https://podcasts.apple.com/us/podcast/the-daily/id1200361736" }Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"podcasts.apple.com/get_podcast","input":{"podcast":"The Daily"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "podcasts.apple.com/get_podcast" , "input": { "podcast": "The Daily" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "podcasts.apple.com/get_podcast" , "input": { "podcast": "The Daily" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run podcasts.apple.com/get_podcast# with {"podcast":"The Daily"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "podcast" ], "properties": { "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code for listings and ratings, such as United States or GB." }, "podcast": { "type": "string", "minLength": 1, "description": "Podcast name or Apple Podcasts show link, such as The Daily." }, "max_episodes": { "type": "integer", "default": 20, "maximum": 300, "minimum": 1, "description": "Maximum number of recent episodes to return, such as 20." } }}Output schema
{ "type": "object", "required": [ "name", "apple_podcasts_url", "episodes" ], "properties": { "name": { "type": "string" }, "category": { "type": [ "string", "null" ] }, "episodes": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": [ "string", "null" ] }, "length": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "episode_url": { "type": [ "string", "null" ] }, "release_date": { "type": [ "string", "null" ] }, "audio_file_url": { "type": [ "string", "null" ] }, "length_seconds": { "type": [ "integer", "null" ] } } } }, "publisher": { "type": [ "string", "null" ] }, "podcast_id": { "type": [ "string", "null" ] }, "artwork_url": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "website_url": { "type": [ "string", "null" ] }, "rating_count": { "type": [ "integer", "null" ] }, "rss_feed_url": { "type": [ "string", "null" ] }, "average_rating": { "type": [ "number", "null" ] }, "update_frequency": { "type": [ "string", "null" ] }, "apple_podcasts_url": { "type": "string" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
podcasts.apple.com/get_podcast- Returns
- name, publisher, description, category, rating, website, artwork, feed URL, episodes
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method podcasts.apple.com/get_podcast with the inputs above.
Ask your agent
- I want the details and latest episodes of the podcast Serial, including its publisher and feed URL.
- Can you pull up the Apple Podcasts show The Daily and list its 10 newest episodes?
- Get me the description, category, and rating for the Huberman Lab podcast in the GB store.
- Look up this Apple Podcasts link and give me the show's artwork, website, and recent episodes: https://podcasts.apple.com/us/podcast/radiolab/id79112081
- What's the latest from the podcast Hard Fork on apple.com? I need the newest 5 episodes and the RSS feed.
See more
All Apple methodsFinds Apple Podcasts shows by name or topic in a country, ordered by search relevance, with ratings when the show page provides them.
podcasts.apple.com/search_podcastsGets a podcast's country-specific rating total and average, plus up to 500 listener reviews sorted by newest or most helpful.
podcasts.apple.com/get_podcast_reviewsLists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes.
podcasts.apple.com/list_top_podcastsGets an iPhone or iPad app's public App Store listing by name or link. You can narrow it by developer and country. In-app purchases are included when the page lists them.
apps.apple.com/get_appGets an Apple Music artist profile by name or artist link. The profile includes the latest release, top songs and albums.
music.apple.com/get_artistGets customer reviews for an iPhone or iPad app, found by name or App Store link, from the selected country's App Store.
apps.apple.com/get_app_reviewsFinds an Apple Music album by title and optional artist, or by album link, and returns its matched release, purchase details and tracks in order.
music.apple.com/get_albumFinds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links.
apps.apple.com/search_apps