# Particle Pro – List Podcast Ranking Categories

> Particle Pro – List Podcast Ranking Categories 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 every podcast ranking category currently in the dataset, optionally filtered by source (Apple or Spotify).

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/rankings/categories
- 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-ranking-categories-c873e77c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gSNnHzpfeuTpnciV309ZE

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-ranking-categories-c873e77c
```

Example prompt: What podcast ranking categories are currently tracked on Particle Pro for Apple podcasts? Show me all of them.

## When to prefer this

Use this endpoint when you need to discover or enumerate the podcast ranking categories tracked by Particle Pro before querying rankings within a specific category. It is the appropriate first step when building a podcast chart browser, populating a category filter dropdown, or checking which genres are tracked for a given source (Apple or Spotify).

## Known failure modes

- Invalid source enum value returns a 400 validation error
- Invalid cursor string causes a 400 or 422 pagination error
- No categories available returns an empty list rather than an error
- Rate limiting or payment failure (402) if credit is insufficient

## How this service works

List ranking categories. Returns every category currently represented in the rankings dataset, optionally restricted to a single source.

## Output

A list of category names (and associated metadata) currently represented in the podcast rankings dataset. May include pagination cursor for fetching additional results if the list is long. Filterable to Apple or Spotify categories only.

## 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 (default: all)"
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from previous response"
      },
      "source": {
       "enum": [
        "apple",
        "spotify"
       ],
       "type": "string",
       "description": "Restrict the listing to one source. Omit to return categories with current data from any source."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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