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.
Documentation Index
Fetch the complete documentation index at: https://docs.particle.pro/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
Results per page
1 <= x <= 100Opaque pagination cursor from previous response
Ranking source platform. Use GET /v1/podcasts/rankings/sources to enumerate available sources.
apple, spotify Chart variant within the source. Currently only 'top_podcasts' is supported.
top_podcasts ISO 3166-1 alpha-2 country code (e.g. 'us', 'gb', 'jp'). Case-insensitive on input — normalized to lowercase server-side.
2Category slug (e.g. 'comedy', 'business'). Omit for the overall chart.
Restrict to chart appearances of a single podcast (slug or ID). When set, the chart-slot filters narrow the result; without them every current chart appearance for the podcast is returned across slots.
Minimum rank (inclusive). Useful for slicing the chart (e.g. min_rank=11&max_rank=20 for ranks 11–20).
1 <= x <= 500Maximum rank (inclusive).
1 <= x <= 500