Endpoint Playground
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.
14 Oct 2026: 24 items; 9 fields had a value in every checked item.
Sample value profiles: release_date: 2026-10-06 to 2026-11-04; rank: 1 to 24, median 12; name: “The Daily” and 23 other values.
curl 'https://api.crawlora.net/api/v1/apple-podcasts/charts/rankings' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| chart | string | No | Chart algorithm. Allowed values: `top`, `top-subscriber`, `top-series`. Default `top`. | |
| type | string | No | Entity type. Allowed values: `podcasts`, `podcast-episodes`, `podcast-channels`. Default `podcasts`. | |
| genre | integer | No | Optional Apple Podcasts genre ID to filter the chart, e.g. 1303 for Comedy | |
| country | string | No | Two-letter storefront country code | |
| limit | integer | No | Number of chart entries to return, default 24, max 200 |
{
"code": 200,
"msg": "OK",
"data": {
"display_name": "Top Shows",
"chart": "top",
"type": "podcasts",
"items": [
{
"rank": 1,
"id": 1200361736,
"kind": "podcast",
"name": "The Daily",
"artist_name": "The New York Times",
"url": "https://podcasts.apple.com/us/podcast/the-daily/id1200361736",
"artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/.../mza_.jpg/{w}x{h}bb.{f}",
"genres": [
"Daily News",
"Podcasts",
"News"
],
"release_date": "2026-07-21T09:45:00Z"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.