Skip to main content
GET
cURL

Authorizations

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 chart debuts, 'exit' for podcasts that fell off, 'all' returns every change type.

Available options:
all,
up,
down,
new,
exit
limit
integer<int64>
default:25

Maximum number of movers to return.

Required range: 1 <= x <= 100

Response

OK

data
object[] | null
required

List of results

has_more
boolean
required

Whether more results exist

cursor
string

Pass to next request for more results