Skip to main content
GET
/
v1
/
podcasts
/
{id}
/
ratings
/
summary
cURL
curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/{id}/ratings/summary"
{
  "entries": [
    {
      "computed_at": "2023-11-07T05:31:56Z",
      "histogram": {
        "stars_1": 123,
        "stars_2": 123,
        "stars_3": 123,
        "stars_4": 123,
        "stars_5": 123
      },
      "platform_slug": "<string>",
      "rating_average": 123,
      "rating_count": 123,
      "locale": "<string>"
    }
  ],
  "podcast_id": "<string>",
  "combined": {
    "computed_at": "2023-11-07T05:31:56Z",
    "histogram": {
      "stars_1": 123,
      "stars_2": 123,
      "stars_3": 123,
      "stars_4": 123,
      "stars_5": 123
    },
    "platform_slug": "<string>",
    "rating_average": 123,
    "rating_count": 123,
    "locale": "<string>"
  },
  "sentiment": {
    "generated_at": "2023-11-07T05:31:56Z",
    "rating_count_in_window": 123,
    "summary_text": "<string>",
    "locale": "<string>",
    "platform_slug": "<string>",
    "window_end": "2023-11-07T05:31:56Z",
    "window_start": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

​
id
string
required

Podcast slug, internal ID, or numeric iTunes ID.

Response

OK

​
entries
object[] | null
required

One entry per (platform, locale) the podcast has been rated on.

​
podcast_id
string
required

Internal podcast ID.

​
combined
object

Single roll-up across every entry, computed by weighting each entry's average by its rating_count. Null when the podcast has no ratings yet.

​
sentiment
object

Latest LLM-generated narrative summary. Null until enough ratings have accumulated for the popularity-bucket cadence to generate one.