Podcast Rankings
tier:premium

List podcast rankings

Returns chart entries from the live ranking snapshot. The most common call needs no parameters — it returns the first page (default 25, max 100 per request) of the US Apple Top Podcasts overall chart, ordered by rank ascending. Charts run to rank 200; paginate with cursor to fetch the rest. Narrow the result with country, category_slug, source, or podcast_id. When podcast_id is set, the response is the podcast's current chart appearances across the matching slots.

get/v1/podcasts/rankings

Request

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

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

source'apple' | 'spotify'

Ranking source platform. Use GET /v1/podcasts/rankings/sources to enumerate available sources.

chart_type'top_podcasts'

Chart variant within the source. Currently only 'top_podcasts' is supported.

countrystring

ISO 3166-1 alpha-2 country code (e.g. 'us', 'gb', 'jp'). Case-insensitive on input; 'uk' is accepted for 'gb'. An unknown code returns 422.

category_slugstring

Category slug (e.g. 'comedy', 'business'). Omit for the overall chart.

podcast_idstring

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.

min_rankinteger

Minimum rank (inclusive). Useful for slicing the chart (e.g. min_rank=11&max_rank=20 for ranks 11–20).

max_rankinteger

Maximum rank (inclusive).

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.