# Particle Pro Podcast Rankings

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

Returns all current chart appearances of a given podcast across sources, countries, and categories.

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/:id/rankings
- Price: $0.03/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-podcast-rankings-c3c57e60
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n9aDYenOXokKv4jvL2dG_

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-podcast-rankings-c3c57e60
```

Example prompt: What are the current chart rankings for the Lex Fridman Podcast — show me every country, category, and source it's appearing in right now.

## When to prefer this

Choose this endpoint when you need comprehensive, multi-source chart data for a specific podcast in real time — including global country-level and category-level breakdowns. It's ideal for competitive analysis, podcast performance monitoring, or verifying a show's reach across international markets. Prefer it over general media analytics tools when the specific focus is podcast chart rankings.

## Known failure modes

- Invalid or unknown podcast ID/slug returns a 404 or empty rankings list
- Podcast exists but has no current chart appearances returns an empty array
- Malformed pagination cursor returns an error or unexpected results
- Rate limiting or payment failure returns a 402 or 429 error
- Network timeout if the rankings data source is temporarily unavailable

## How this service works

List current rankings for a podcast. Returns every live chart appearance of the given podcast — across sources, countries, and categories.

## Output

A list of live chart entries for the specified podcast, each including the ranking source, country, category, chart position, and any associated metadata. Results cover all simultaneous chart appearances across different platforms, regions, and genres.

## 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 (default: all)"
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from previous response"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/particle-pro-podcast-rankings-c3c57e60/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)