particle_podcast_get_ratings

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
}

REST equivalent: GET /v1/podcasts/{id}/ratings.
For the headline numbers inline on resolve, use particle_podcast_resolve with include: ["ratings_summary"].

Get started

Tools

particle_podcast_get_ratings

Inputs

Output

Example

​Inputs

​Output

​Example

​Related

Inputs

Output

Example

Related