# Particle Pro Podcast Rankings Summary

> Particle Pro Podcast Rankings Summary 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 an aggregated snapshot of a podcast's current chart presence, including distinct chart slots, sources, countries, categories, and its best (lowest) rank.

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/:id/rankings/summary
- 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-summary-f72dacef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3Oh7SRWJSo1wXavGKSnpm

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-summary-f72dacef
```

Example prompt: Can you give me a chart summary for the podcast with ID 'serial' — how many charts is it on, which countries, and what's its best rank right now?

## When to prefer this

Choose this endpoint when you need a fast, single-call aggregate view of a podcast's chart presence rather than iterating through individual chart entries. Ideal for dashboards, competitive benchmarking, or media buying decisions where a high-level chart footprint (breadth of countries, sources, categories, and best rank) is more useful than granular per-chart data.

## Known failure modes

- Unknown podcast ID or slug returns 404
- Invalid or malformed ID format may return 400
- Podcast not currently on any charts may return empty/zero counts
- Rate limiting or payment failure (x402 protocol) returns 402
- Temporary upstream data unavailability returns 503

## How this service works

Summarize a podcast's chart presence. Returns a one-call aggregate of the podcast's current chart presence: the number of distinct chart slots, sources, countries, and categories it appears on, plus the single best (lowest-numbered) rank it

## Output

A single aggregated object containing: the total number of distinct chart slots the podcast occupies, the number of unique chart sources it appears on, the number of countries where it charts, the number of categories it ranks in, and its single best (lowest-numbered) rank across all charts.

## 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, internal ID, or numeric iTunes ID."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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