Podcast Rankings
tier:premium

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 debuts (new), departures (exit), or directional moves (up / down). Stable rows are excluded.

get/v1/podcasts/rankings/movers

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/rankings/movers
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

source'apple' | 'spotify'

Ranking source platform.

chart_type'top_podcasts'

Chart variant within the source.

countrystring

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

category_slugstring

Category slug. Omit for the overall chart.

window_daysinteger

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

change'all' | 'up' | 'down' | 'new' | 'exit'

Filter by change type. 'up' / 'down' for podcasts whose rank moved, 'new' for chart debuts, 'exit' for podcasts that fell off, 'all' returns every change type.

limitinteger

Maximum number of movers to return.

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

No recorded changes to this operation across all 2 revisions of this API.