ApplePodcasts

Retrieve Apple Podcasts chart rankings by algorithm, type, and genre

Returns Apple Podcasts chart rankings from the modern podcasts.apple.com charts page, covering chart algorithms (top, top-subscriber, top-series) crossed with entity types (podcasts, podcast-episodes, podcast-channels) and an optional genre filter. A richer, differently-sourced capability than the legacy RSS-based /apple-podcasts/charts endpoint.

get/apple-podcasts/charts/rankings

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/apple-podcasts/charts/rankings
  • Auth: API key in header x-api-key

Query parameters

chartstring

Chart algorithm. Allowed values: top, top-subscriber, top-series. Default top.

typestring

Entity type. Allowed values: podcasts, podcast-episodes, podcast-channels. Default podcasts.

genreinteger

Optional Apple Podcasts genre ID to filter the chart, e.g. 1303 for Comedy

countrystring

Two-letter storefront country code

limitinteger

Number of chart entries to return, default 24, max 200

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

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