particle_podcast_get_ratings

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

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.

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 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):

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

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.
• For the headline numbers inline on resolve, use particle_podcast_resolve with include: ["ratings_summary"].