ToolAssay

List podcast rankings

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

Answeringour last check, 2026-09-24
1 of 1checks answered this week
198 msmedian answer time
$0.03listed price per call
$0.03price it asked us

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://api.particle.pro/v1/podcasts/rankings

CategoryEverything else
Provider hostapi.particle.pro
Networkseip155:8453
Payment schemesexact
Self-reported calls, 30 days2 from 1 payers (the provider's figure, not ours)

Our checks, last 30 days

DayResultHTTPAskedTime
2026-09-24 valid payment request 402$0.03 198 ms

Example input (from the provider)

{
  "method": "GET",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "category_slug": {
              "description": "Category slug (e.g. 'comedy', 'business'). Omit for the overall chart.",
              "type": "string"
            },
            "chart_type": {
              "description": "Chart variant within the source. Currently only 'top_podcasts' is supported.",
              "enum": [
                "top_podcasts"
              ],
              "type": "string"
            },
            "country": {
              "description": "ISO 3166-1 alpha-2 country code (e.g. 'us', 'gb', 'jp'). Case-insensitive on input \u2014 normalized to lowercase server-side.",
              "type": "string"
            },
            "cursor": {
              "description": "Opaque pagination cursor from previous response",
              "type": "string"
            },
            "limit": {
              "description": "Results per page",
              "format": "int64",
              "type": "integer"
            },
            "max_rank": {
              "description": "Maximum rank (inclusive).",
              "format": "int64",
              "type": "integer"
            },
            "min_rank": {
              "description": "Minimum rank (inclusive). Useful for slicing the chart (e.g. min_rank=11&max_rank=20 for ranks 11\u201320).",
              "format": "int64",
              "type": "integer"
            },
            "podcast_id": {
              "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.",
              "type": "string"
            },
            "source": {
              "description": "Ranking source platform. Use GET /v1/podcasts/rankings/sources to enumerate available sources.",
              "enum": [
                "apple",
                "spotify"
              ],
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON