Apple API: Get podcast reviews
Gets a podcast's country-specific rating total and average, plus up to 500 listener reviews sorted by newest or most helpful.
Unofficial. Not affiliated with or endorsed by Apple.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Sort optional
sort Review order, for example most_recent.
most_recent (default)
One of
most_recent,most_helpful.- Country optional
country Country name or two-letter code for ratings and reviews, for example United Kingdom or GB.
United States (default)
- Podcast, required
podcast Podcast name or Apple Podcasts link, for example Crime Junkie or https://podcasts.apple.com/us/podcast/crime-junkie/id1322200189.
Crime Junkie
- Max Results optional
max_results Maximum number of reviews, for example 50.
50 (default)
Whole number from 1 to 500.
Input as JSON
{ "podcast": "Crime Junkie"}Output
{ "reviews": [ { "date": "2026-10-21", "stars": 5, "page_url": "https://podcasts.apple.com/us/podcast/id1322200189" , "review_text": "Found Crime Junkie a few months ago and I haven’t listened to music in my car since! Love listening to Ashley and Britt!!", "review_title": "My Favorite", "reviewer_name": "Tay12yyyy" }, { "date": "2026-10-20", "stars": 5, "page_url": "https://podcasts.apple.com/us/podcast/id1322200189" , "review_text": "This pod is amazing and so well done! Love you both ladies! Ignore the trolls. ✨🖤", "review_title": "AMAZING", "reviewer_name": "A. Hardesky" }, { "date": "2026-10-20", "stars": 5, "page_url": "https://podcasts.apple.com/us/podcast/id1322200189" , "review_text": "Ashley Flowers and Brit, You are both so good at what you do! Keep up the great work. I love you both!", "review_title": "⭐️⭐️⭐️⭐️⭐️", "reviewer_name": "AuspiciousAJS" } ], "podcast_url": "https://podcasts.apple.com/us/podcast/id1322200189" , "podcast_name": "Crime Junkie", "average_rating": 4.7, "number_of_ratings": 365528}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_reviews","input":{"podcast":"Crime Junkie"}}' # 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_reviews" , "input": { "podcast": "Crime Junkie" }})# 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_reviews" , "input": { "podcast": "Crime Junkie" } }), 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_reviews# with {"podcast":"Crime Junkie"}"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": { "sort": { "enum": [ "most_recent", "most_helpful" ], "type": "string", "default": "most_recent", "description": "Review order, for example most_recent." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code for ratings and reviews, for example United Kingdom or GB." }, "podcast": { "type": "string", "description": "Podcast name or Apple Podcasts link, for example Crime Junkie or https://podcasts.apple.com/us/podcast/crime-junkie/id1322200189." }, "max_results": { "type": "integer", "default": 50, "maximum": 500, "minimum": 1, "description": "Maximum number of reviews, for example 50." } }}Output schema
{ "type": "object", "required": [ "podcast_name", "average_rating", "number_of_ratings", "podcast_url", "reviews" ], "properties": { "reviews": { "type": "array", "items": { "type": "object", "required": [ "reviewer_name", "stars", "review_title", "review_text", "date", "page_url" ], "properties": { "date": { "type": [ "string", "null" ], "format": "date" }, "stars": { "type": [ "integer", "null" ] }, "page_url": { "type": "string", "description": "Podcast page on which the listener review can be read." }, "review_text": { "type": [ "string", "null" ] }, "review_title": { "type": [ "string", "null" ] }, "reviewer_name": { "type": [ "string", "null" ] } }, "additionalProperties": false } }, "podcast_url": { "type": "string", "description": "Apple Podcasts show page in the selected country." }, "podcast_name": { "type": "string", "description": "Podcast title." }, "average_rating": { "type": [ "number", "null" ], "description": "Average country-specific rating out of five, or null when unavailable." }, "number_of_ratings": { "type": "integer", "description": "Number of country-specific ratings." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
podcasts.apple.com/get_podcast_reviews- Returns
- podcast name, average rating, number of ratings, show URL, reviews (reviewer, stars, title, text, date)
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_reviews with the inputs above.
Ask your agent
- What are the latest listener reviews for the Crime Junkie podcast in the United States?
- Show me the most helpful reviews for Huberman Lab with their star ratings.
- How do British listeners rate The Rest Is History? Pull the UK average and recent reviews.
- Get the 20 most recent reviews for the Serial podcast on Apple Podcasts, including reviewer names and dates.
- Find the average rating and total number of ratings for My Favorite Murder in Canada, plus its top helpful reviews.
See more
All Apple methodsGets 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_reviewsGets an Apple Podcasts show's details and its newest available episodes, by show name or Apple Podcasts link.
podcasts.apple.com/get_podcastFinds 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_podcastsLists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes.
podcasts.apple.com/list_top_podcastsFinds 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 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_appLists 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_chartsLists 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