# 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.

- Page: https://fous.com/methods/podcasts.apple.com/get-podcast-reviews
- Method: `podcasts.apple.com/get_podcast_reviews`, version 1
- Website: podcasts.apple.com
- Returns: podcast name, average rating, number of ratings, show URL, reviews (reviewer, stars, title, text, date)
- 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 |
|---|---|---|---|---|
| `sort` | string | no |  | Review order, for example most_recent. One of "most_recent", "most_helpful". Default "most_recent". |
| `country` | string | no |  | Country name or two-letter code for ratings and reviews, for example United Kingdom or GB. Default "United States". |
| `podcast` | string | yes | `"Crime Junkie"` | Podcast name or Apple Podcasts link, for example Crime Junkie or https://podcasts.apple.com/us/podcast/crime-junkie/id1322200189. |
| `max_results` | integer | no |  | Maximum number of reviews, for example 50. Default 50. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "podcast": "Crime Junkie"
}
```

Its output:

```json
{
  "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
}
```

## 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/get_podcast_reviews","input":{"podcast":"Crime Junkie"}}'
```

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 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.

## Input schema

```json
{
  "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

```json
{
  "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
}
```

## See more

- [Apple API: Get app reviews](https://fous.com/methods/apps.apple.com/get-app-reviews.md): Gets customer reviews for an iPhone or iPad app, found by name or App Store link, from the selected country's App Store.
- [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: 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: 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.
- [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 App Store app](https://fous.com/methods/apps.apple.com/get-app.md): Gets 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.
- [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.
- [All Apple methods](https://fous.com/methods/apple.com.md)
