# Particle Pro – List Podcast Ranking Countries

> Particle Pro – List Podcast Ranking Countries 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 country currently represented in the podcast rankings dataset, optionally filtered to Apple or Spotify as the source.

## Facts

- Endpoint: GET https://api.particle.pro/v1/podcasts/rankings/countries
- 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-countries-d6627d29
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o5vCUCUxOvD7xqq4pT-uC

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-countries-d6627d29
```

Example prompt: Can you pull up all the countries currently covered in the Particle Pro podcast rankings dataset, restricted to Spotify only?

## When to prefer this

Use this endpoint when you need to discover which countries are available before querying country-specific podcast rankings, or when building a UI that lists supported markets. It is the correct starting point for any geographic scoping of podcast chart data on Particle Pro, especially when you need to filter by Apple or Spotify specifically.

## Known failure modes

- Invalid source value (not 'apple' or 'spotify') returns a 400 error
- Invalid cursor token returns a 400 or 422 error
- Empty result set if no countries are currently indexed
- Payment failure via x402 protocol returns 402 if USDC not provided
- Rate limiting may return 429 if called excessively

## How this service works

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

## Output

A list of countries (with country codes and/or names) currently represented in the podcast rankings dataset. If a source filter (apple or spotify) is provided, only countries with data from that source are returned. Supports pagination via cursor and limit parameters.

## 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 countries 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-countries-d6627d29/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)