> ## Documentation Index
> Fetch the complete documentation index at: https://docs.particle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# particle_podcast_get_ratings

> Listener-review ratings for one podcast — aggregate summary, per-platform breakdown, sentiment, and recent reviews.

<Note>
  In the **`podcast_ratings`** category, which is **opt-in** — it is callable by name on any connection, but only advertised on `tools/list` when selected via `?include=podcast_ratings`. See [Tool sets & discovery](/mcp/tool-sets).
</Note>

Listener-review ratings for one podcast: the aggregate summary (average stars, rating count, per-platform breakdown, and an LLM-generated sentiment narrative when available) plus the most recent individual reviews.

Filter the review list by `platform_slug`, `min_stars`, or a `since`/`until` window; the summary always reflects the full corpus. For just the headline numbers on several podcasts at once, [`particle_podcast_resolve`](/mcp/tools/podcasts/podcast-resolve) with `include: ["ratings_summary"]` is cheaper.

## Inputs

| Field           | Type           | Required | Default | Description                                                                         |
| --------------- | -------------- | -------- | ------- | ----------------------------------------------------------------------------------- |
| `podcast_slug`  | string         | yes      | —       | Podcast slug, internal ID, or numeric iTunes ID.                                    |
| `platform_slug` | string         | no       | —       | Restrict the rating list to one platform (e.g. `"apple"`). Omit for every platform. |
| `min_stars`     | integer (1–5)  | no       | —       | Lower bound on the star rating (inclusive).                                         |
| `since`         | string         | no       | —       | Only ratings posted on or after this ISO 8601 date.                                 |
| `until`         | string         | no       | —       | Only ratings posted on or before this ISO 8601 date.                                |
| `limit`         | integer (1–50) | no       | 10      | Ratings per page.                                                                   |
| `cursor`        | string         | no       | —       | Opaque pagination cursor.                                                           |

## Output

A markdown document with `## Ratings for <podcast_slug>` and an `**Overall:**` row (`X.XX stars across N ratings`), then one `BulletKV` per `(platform, locale)` aggregate (`platform/locale: X.XX stars across N ratings`). A `### Listener sentiment` section carries the narrative paragraph when present. A `### Recent reviews` section lists each review as `N★ Title — Author (YYYY-MM-DD)` with the review body indented underneath. When more pages exist, a horizontal rule and a `**Cursor:** <value>` line are appended.

Sample (`podcast_slug="all-in", limit=2`):

```markdown theme={"dark"}
## Ratings for all-in

**Overall:** 4.71 stars across 18432 ratings
- **apple/us:** 4.73 stars across 15210 ratings
- **spotify/us:** 4.62 stars across 3222 ratings

### Listener sentiment

Listeners praise the besties' candor and tech-investing insight; recurring criticism centers on political tangents.

### Recent reviews

- 5★ Best tech podcast — degen_investor (2026-05-28)
    The only show that actually explains the market to me.
- 2★ Too much politics lately — longtime_listener (2026-05-26)
    Used to be about startups, now it's all hot takes.
```

## Example

```text theme={"dark"}
Agent calls: particle_podcast_get_ratings {
  "podcast_slug": "all-in",
  "platform_slug": "apple",
  "min_stars": 1,
  "limit": 20
}
```

## Related

* REST equivalent: [`GET /v1/podcasts/{id}/ratings`](/podcasts/ratings).
* For the headline numbers inline on resolve, use [`particle_podcast_resolve`](/mcp/tools/podcasts/podcast-resolve) with `include: ["ratings_summary"]`.