Podcast Ratings
tier:standard

List ratings for a podcast

Returns user-generated ratings (1-5 stars plus optional review text) captured from third-party platforms. Today's source is Apple Podcasts, walked across the Anglophone storefronts (us, gb, ca, au, nz, ie). Newest ratings first; paginate with cursor. Filter by platform_slug, locale, min_stars, or a date window on since/until.

get/v1/podcasts/{id}/ratings

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/{id}/ratings
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

Podcast slug (e.g. 'the-daily', 'lex-fridman-podcast'), internal ID, or numeric iTunes ID.

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

platform_slugstring

Restrict to ratings from one platform (e.g. 'apple'). Omit to return ratings from every platform.

localestring

Restrict to one platform-specific locale (e.g. Apple storefront 'us'). Omit to return ratings across every locale.

min_starsinteger

Lower bound on the star rating (inclusive).

sincestring

Lower bound on posted_at (ISO 8601).

Example:2026-01-01T00:00:00Z
untilstring

Upper bound on posted_at (ISO 8601).

Example:2026-06-01T00:00:00Z

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

No recorded changes to this operation across all 2 revisions of this API.