curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/{id}/ratings?limit=25"{
"data": [
{
"id": "<string>",
"platform_rating_id": "<string>",
"platform_slug": "<string>",
"stars": 3,
"author_display_name": "<string>",
"author_uri": "<string>",
"body": "<string>",
"link_href": "<string>",
"locale": "<string>",
"posted_at": "2023-11-07T05:31:56Z",
"title": "<string>"
}
],
"has_more": true,
"cursor": "<string>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}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.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/{id}/ratings?limit=25"{
"data": [
{
"id": "<string>",
"platform_rating_id": "<string>",
"platform_slug": "<string>",
"stars": 3,
"author_display_name": "<string>",
"author_uri": "<string>",
"body": "<string>",
"link_href": "<string>",
"locale": "<string>",
"posted_at": "2023-11-07T05:31:56Z",
"title": "<string>"
}
],
"has_more": true,
"cursor": "<string>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Path Parameters
Podcast slug (e.g. 'the-daily', 'lex-fridman-podcast'), internal ID, or numeric iTunes ID.
Query Parameters
Results per page
1 <= x <= 100Opaque pagination cursor from previous response
Restrict to ratings from one platform (e.g. 'apple'). Omit to return ratings from every platform.
Restrict to one platform-specific locale (e.g. Apple storefront 'us'). Omit to return ratings across every locale.
Lower bound on the star rating (inclusive).
1 <= x <= 5Lower bound on posted_at (ISO 8601).
"2026-01-01T00:00:00Z"
Upper bound on posted_at (ISO 8601).
"2026-06-01T00:00:00Z"
Was this page helpful?