List ranking movers

Returns the chart entries whose rank changed between the live snapshot and the comparison snapshot window_days ago. Use the change filter to focus on entries (new), departures (exit), or directional moves (up / down). Most entries are established shows returning to the chart; debut keeps only shows on this chart slot for the first time since tracking began (May 2026), and reentry keeps the returning ones. Each new row says which it is in debut, with first_charted_at, and a debut whose full back catalog is indexed carries first_episode_published_at, which separates a brand-new show from a new season of an old one. Stable rows are excluded.

GET /v1/podcasts/rankings/movers

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/rankings/movers?source=apple&chart_type=top_podcasts&country=us&window_days=1&change=all&limit=25"

200

{
  "data": [
    {
      "captured_at": "2023-11-07T05:31:56Z",
      "change": "up",
      "chart_type": "top_podcasts",
      "external_id": "<string>",
      "id": "<string>",
      "is_current": true,
      "rank": 123,
      "show": {
        "name": "<string>",
        "content_advisory_rating": "<string>",
        "description": "<string>",
        "feed_url": "<string>",
        "genres": [
          {
            "external_id": "<string>",
            "name": "<string>"
          }
        ],
        "image_url": "<string>",
        "language": "<string>",
        "latest_release_date": "2023-11-07T05:31:56Z",
        "publisher": "<string>",
        "total_episodes": 123
      },
      "source": "apple",
      "category": {
        "name": "<string>",
        "slug": "<string>",
        "external_id": "<string>",
        "parent_slug": "<string>"
      },
      "channel_subscriber_count": 123,
      "chart_total": 123,
      "country": "<string>",
      "debut": true,
      "delta": 123,
      "external_url": "<string>",
      "first_charted_at": "2023-11-07T05:31:56Z",
      "first_episode_published_at": "2023-11-07T05:31:56Z",
      "growth_indicator": "<string>",
      "podcast": {
        "id": "<string>",
        "title": "<string>",
        "best_rank": {
          "captured_at": "2023-11-07T05:31:56Z",
          "chart_type": "top_podcasts",
          "rank": 123,
          "source": "apple",
          "category_slug": "<string>",
          "country": "<string>"
        },
        "image_url": "<string>",
        "popularity": 123,
        "publisher": {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>"
        },
        "slug": "<string>"
      },
      "previous_rank": 123,
      "previous_snapshot": {
        "captured_at": "2023-11-07T05:31:56Z",
        "chart_type": "top_podcasts",
        "external_id": "<string>",
        "id": "<string>",
        "is_current": true,
        "rank": 123,
        "show": {
          "name": "<string>",
          "content_advisory_rating": "<string>",
          "description": "<string>",
          "feed_url": "<string>",
          "genres": [
            {
              "external_id": "<string>",
              "name": "<string>"
            }
          ],
          "image_url": "<string>",
          "language": "<string>",
          "latest_release_date": "2023-11-07T05:31:56Z",
          "publisher": "<string>",
          "total_episodes": 123
        },
        "source": "apple",
        "category": {
          "name": "<string>",
          "slug": "<string>",
          "external_id": "<string>",
          "parent_slug": "<string>"
        },
        "channel_subscriber_count": 123,
        "chart_total": 123,
        "country": "<string>",
        "external_url": "<string>",
        "growth_indicator": "<string>",
        "podcast": {
          "id": "<string>",
          "title": "<string>",
          "best_rank": {
            "captured_at": "2023-11-07T05:31:56Z",
            "chart_type": "top_podcasts",
            "rank": 123,
            "source": "apple",
            "category_slug": "<string>",
            "country": "<string>"
          },
          "image_url": "<string>",
          "popularity": 123,
          "publisher": {
            "id": "<string>",
            "name": "<string>",
            "slug": "<string>"
          },
          "slug": "<string>"
        },
        "previous_rank": 123,
        "reach_pct": 123,
        "source_updated_at": "2023-11-07T05:31:56Z",
        "view_count": 123,
        "weekly_avg_downloads": 123
      },
      "reach_pct": 123,
      "source_updated_at": "2023-11-07T05:31:56Z",
      "view_count": 123,
      "weekly_avg_downloads": 123
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Query Parameters

source · enum<string> · default: apple

Ranking source platform.

Available options: apple, spotify

chart_type · enum<string> · default: top_podcasts

Chart variant within the source.

Available options: top_podcasts

country · string · default: us

ISO 3166-1 alpha-2 country code; case-insensitive on input.

Required string length: 2

category_slug · string

Category slug. Omit for the overall chart.

window_days · integer<int64> · default: 1

Comparison window in days. The comparison snapshot is the most recent retired snapshot closest to (now - window_days). Default is 1 (vs. yesterday).

Required range: 1 <= x <= 30

change · enum<string> · default: all

Filter by change type. 'up' / 'down' for podcasts whose rank moved, 'new' for every podcast that entered the chart (debuts and returning shows), 'debut' for podcasts on this chart slot for the first time since tracking began (May 2026), 'reentry' for returning shows, 'exit' for podcasts that fell off, 'all' returns every change type. 'new' rows carry 'debut' and 'first_charted_at' whichever filter selected them.

Available options: all, up, down, new, debut, reentry, exit

limit · integer<int64> · default: 25

Results per page

Required range: 1 <= x <= 100

cursor · string

Opaque pagination cursor from previous response

Response

200

application/json

OK

data · object[] · required

List of results

Show child attributes

has_more · boolean · required

Whether more results exist

cursor · string

Pass to next request for more results