# Particle Pro – List Podcast Ratings

> Particle Pro – List Podcast Ratings is a paid API for AI agents from api.particle.pro, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns paginated user-generated star ratings (1–5) and optional review text for a specified podcast, aggregated from third-party platforms like Apple Podcasts.

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/:id/ratings
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/particle-pro-list-podcast-ratings-e34f4e40
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kx9r4isEiFO2iqVkccN9X

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability particle-pro-list-podcast-ratings-e34f4e40
```

Example prompt: Pull me the most recent listener ratings for the Lex Fridman Podcast from Apple Podcasts in the US, showing only reviews with 4 stars or above, up to 25 results.

## When to prefer this

Use this endpoint when you need structured, filterable listener rating data for a specific podcast — especially when you want to segment by platform (e.g. Apple only), locale (e.g. US storefront), star threshold, or date range. Prefer this over generic podcast search endpoints when the goal is audience sentiment analysis, sponsor due diligence, or monitoring listener reactions over time.

## Known failure modes

- Unknown podcast ID or slug returns 404 not found
- Invalid platform_slug returns 400 bad request
- Invalid ISO 8601 date format for since/until returns 400
- Exhausted pagination returns empty results with no cursor
- Rate limiting or payment failure returns 402 or 429

## How this service works

List ratings for a podcast. Returns user-generated ratings (1-5 stars plus optional review text) captured from third-party platforms.

## Output

A paginated list of rating objects, each containing a star value (1–5), optional review text, the source platform (e.g. 'apple'), locale, and a posted_at timestamp. Includes an opaque cursor for fetching the next page of results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Podcast slug (e.g. 'the-daily', 'lex-fridman-podcast'), internal ID, or numeric iTunes ID."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "format": "int64",
       "description": "Results per page"
      },
      "since": {
       "type": "string",
       "description": "Lower bound on posted_at (ISO 8601)."
      },
      "until": {
       "type": "string",
       "description": "Upper bound on posted_at (ISO 8601)."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from previous response"
      },
      "locale": {
       "type": "string",
       "description": "Restrict to one platform-specific locale (e.g. Apple storefront 'us'). Omit to return ratings across every locale."
      },
      "min_stars": {
       "type": "integer",
       "format": "int64",
       "description": "Lower bound on the star rating (inclusive)."
      },
      "platform_slug": {
       "type": "string",
       "description": "Restrict to ratings from one platform (e.g. 'apple'). Omit to return ratings from every platform."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/particle-pro-list-podcast-ratings-e34f4e40/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.particle.pro](https://www.zero.xyz/host/api.particle.pro/llms.txt)