# 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 a live snapshot of podcast chart rankings from Apple or Spotify, filterable by country, category, rank range, and specific podcast.

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/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-0813c92d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f3UiAoSwGVirWgocW-xdN

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-0813c92d
```

Example prompt: Pull the current top 20 comedy podcasts ranking on Apple for the US from Particle Pro's live chart snapshot.

## When to prefer this

Use this endpoint when you need live, ranked chart data for podcasts from Apple or Spotify, especially when you want to filter by country, category, or rank range. Prefer this over general podcast search endpoints when the goal is chart position or trend monitoring rather than content discovery by keyword.

## Known failure modes

- Invalid country code returns a 400 or empty result set
- Unsupported source platform value returns a validation error
- Requesting a podcast_id not currently on any chart returns an empty list
- Invalid or expired pagination cursor returns an error or unexpected results
- Rate limiting or payment failure (402) if x402 payment is not properly handled
- category_slug typo returns empty results silently

## How this service works

List podcast rankings. Returns chart entries from the live ranking snapshot.

## Output

A paginated list of chart entries from the live ranking snapshot, each containing the podcast's rank position, chart type, source platform (Apple or Spotify), country, and category. Includes an opaque pagination cursor for retrieving subsequent pages 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "format": "int64",
       "description": "Results per page"
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from previous response"
      },
      "source": {
       "enum": [
        "apple",
        "spotify"
       ],
       "type": "string",
       "description": "Ranking source platform. Use GET /v1/podcasts/rankings/sources to enumerate available sources."
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 country code (e.g. 'us', 'gb', 'jp'). Case-insensitive on input — normalized to lowercase server-side."
      },
      "max_rank": {
       "type": "integer",
       "format": "int64",
       "description": "Maximum rank (inclusive)."
      },
      "min_rank": {
       "type": "integer",
       "format": "int64",
       "description": "Minimum rank (inclusive). Useful for slicing the chart (e.g. min_rank=11&max_rank=20 for ranks 11–20)."
      },
      "chart_type": {
       "enum": [
        "top_podcasts"
       ],
       "type": "string",
       "description": "Chart variant within the source. Currently only 'top_podcasts' is supported."
      },
      "podcast_id": {
       "type": "string",
       "description": "Restrict to chart appearances of a single podcast (slug, internal ID, or numeric iTunes ID). When set, the chart-slot filters narrow the result; without them every current chart appearance for the podcast is returned across slots."
      },
      "category_slug": {
       "type": "string",
       "description": "Category slug (e.g. 'comedy', 'business'). Omit for the overall chart."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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