Apple API: Search podcasts
Finds Apple Podcasts shows by name or topic in a country, ordered by search relevance, with ratings when the show page provides them.
Unofficial. Not affiliated with or endorsed by Apple.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Query, required
query Podcast name or topic to search for, such as Huberman or personal finance.
Huberman
- Country optional
country Country name or two-letter country code, such as United States or GB.
United States (default)
- Max Results optional
max_results Maximum number of shows to return, such as 20. The public search currently provides at most 100.
20 (default)
Whole number from 1 to 200.
Input as JSON
{ "query": "Huberman"}Output
{ "podcasts": [ { "publisher": "Scicomm Media", "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/9a/d3/19/9ad31912-0b5a-a16e-2d7c-9fd074698b9c/mza_8994222203629500925.jpg/600x600bb.jpg" , "podcast_name": "Huberman Lab", "rating_count": 28049, "rss_feed_url": "https://feeds.megaphone.fm/hubermanlab" , "episode_count": 452, "main_category": "Health & Fitness", "average_rating": 4.8, "apple_podcast_id": "1545953110", "apple_podcasts_url": "https://podcasts.apple.com/us/podcast/huberman-lab/id1545953110?uo=4" , "latest_episode_date": "2026-10-22" }, { "publisher": "Erik Huberman", "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts112/v4/b8/79/0b/b8790bb4-6c94-ae24-4830-6fda77fb9663/mza_6767486214087564093.jpeg/600x600bb.jpg" , "podcast_name": "HawkeTalk", "rating_count": 440, "rss_feed_url": "https://feeds.acast.com/public/shows/637de88074e2da0012a3bfca" , "episode_count": 238, "main_category": "Business News", "average_rating": 4.9, "apple_podcast_id": "1534940129", "apple_podcasts_url": "https://podcasts.apple.com/us/podcast/hawketalk/id1534940129?uo=4" , "latest_episode_date": "2026-07-09" }, { "publisher": "Michelle Grosser – Inspired by Mel Robbins, Dr. Andrew Huberman, and Dr. Becky Kennedy", "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/ba/96/c4/ba96c4c3-894f-dd27-e480-21679fbc47e2/mza_12673735177242970332.jpg/600x600bb.jpg" , "podcast_name": "High Capacity – Nervous System Regulation, Stress Management, Burnout Recovery, Somatic Tools, Anxiety, Boundaries, Overwhe", "rating_count": 528, "rss_feed_url": "https://rss.buzzsprout.com/2302784.rss" , "episode_count": 500, "main_category": "Parenting", "average_rating": 4.9, "apple_podcast_id": "1621946084", "apple_podcasts_url": "https://podcasts.apple.com/us/podcast/high-capacity-nervous-system-regulation-stress-management/id1621946084?uo=4" , "latest_episode_date": "2026-10-20" } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"podcasts.apple.com/search_podcasts","input":{"query":"Huberman"}}' # 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/search_podcasts" , "input": { "query": "Huberman" }})# 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/search_podcasts" , "input": { "query": "Huberman" } }), 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/search_podcasts# with {"query":"Huberman"}"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": [ "query" ], "properties": { "query": { "type": "string", "minLength": 1, "description": "Podcast name or topic to search for, such as Huberman or personal finance." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter country code, such as United States or GB." }, "max_results": { "type": "integer", "default": 20, "maximum": 200, "minimum": 1, "description": "Maximum number of shows to return, such as 20. The public search currently provides at most 100." } }}Output schema
{ "type": "object", "required": [ "podcasts" ], "properties": { "podcasts": { "type": "array", "items": { "type": "object", "required": [ "podcast_name", "publisher", "main_category", "episode_count", "average_rating", "rating_count", "latest_episode_date", "artwork_url", "apple_podcasts_url", "apple_podcast_id", "rss_feed_url" ], "properties": { "publisher": { "type": [ "string", "null" ], "description": "Publisher or creator." }, "artwork_url": { "type": [ "string", "null" ], "description": "Show artwork link." }, "podcast_name": { "type": "string", "description": "Name of the show." }, "rating_count": { "type": [ "integer", "null" ], "description": "Number of listener ratings, when shown." }, "rss_feed_url": { "type": [ "string", "null" ], "description": "Show RSS feed link, when available." }, "episode_count": { "type": [ "integer", "null" ], "description": "Number of episodes listed for the show." }, "main_category": { "type": [ "string", "null" ], "description": "Main podcast category." }, "average_rating": { "type": [ "number", "null" ], "description": "Average listener rating out of 5, when shown." }, "apple_podcast_id": { "type": [ "string", "null" ], "description": "Apple Podcasts show ID." }, "apple_podcasts_url": { "type": "string", "description": "Apple Podcasts show page link." }, "latest_episode_date": { "type": [ "string", "null" ], "description": "Most recent episode date in YYYY-MM-DD, when known." } } }, "description": "Shows in search relevance order." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
podcasts.apple.com/search_podcasts- Returns
- podcast name, publisher, category, episode count, rating, artwork, Apple and RSS links
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/search_podcasts with the inputs above.
Ask your agent
- Find podcasts about personal finance for listeners in the UK, ranked by relevance, with ratings and episode counts
- I need true crime podcasts available in the United States, top 15 results with publisher names
- Search Apple Podcasts for Huberman and show me the matching shows with their RSS feed links
- What podcasts cover beginner Spanish lessons in Canada? Give me up to 50 results
- Look up shows named The Daily or similar news podcasts in Germany and list their categories and artwork
See more
All Apple methodsFinds 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_appsGets an Apple Podcasts show's details and its newest available episodes, by show name or Apple Podcasts link.
podcasts.apple.com/get_podcastSearches the Apple Music song catalog by title and artist words, returning matching tracks in relevance order with prices and previews when available.
music.apple.com/search_songsLists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes.
podcasts.apple.com/list_top_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 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.
music.apple.com/list_top_chartsGets 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_reviewsLists 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.
apps.apple.com/list_top_charts