# Particle Pro Podcast Rankings History

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

Returns historical chart ranking entries for a specific podcast across Apple and/or Spotify charts, filterable by date range, country, and category.

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/:id/rankings/history
- Price: $0.04/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-history-af2813e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KVfSYuYBoxS0MBEGefcYx

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-history-af2813e0
```

Example prompt: Show me the historical Apple podcast chart rankings for the podcast with ID 'serial' in the US between January 1, 2024 and June 30, 2024, limited to 50 results per page.

## When to prefer this

Use this endpoint when you need time-series chart ranking data for a specific podcast, especially for longitudinal trend analysis, competitive benchmarking, or auditing a show's historical chart performance. Prefer this over real-time ranking endpoints when the goal is historical analysis over a date range rather than current standings.

## Known failure modes

- Invalid or unknown podcast ID/slug returns a 404 not found error
- Malformed ISO 8601 date strings for 'since' or 'until' result in a 400 validation error
- Unsupported country code returns no results or a 400 error
- Invalid source enum value (not 'apple' or 'spotify') causes a 400 bad request
- Expired or invalid pagination cursor may return an error or empty results
- Payment not received via x402 results in a 402 Payment Required response

## How this service works

Get historical rankings for a podcast. Returns the historical rank entries for a podcast across one or more chart slots.

## Output

A paginated list of historical rank entries for the specified podcast, each including the chart position, captured timestamp, source platform (Apple or Spotify), country, chart type, and category. Responses include a 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Podcast slug, 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 captured_at (ISO 8601)."
      },
      "until": {
       "type": "string",
       "description": "Upper bound on captured_at (ISO 8601)."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from previous response"
      },
      "source": {
       "enum": [
        "apple",
        "spotify"
       ],
       "type": "string",
       "description": "Restrict to one source."
      },
      "country": {
       "type": "string",
       "description": "Restrict to one country (ISO 3166-1 alpha-2; case-insensitive on input)."
      },
      "chart_type": {
       "enum": [
        "top_podcasts"
       ],
       "type": "string",
       "description": "Restrict to one chart type."
      },
      "category_slug": {
       "type": "string",
       "description": "Restrict to one category slug. Omit to include every category."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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