Endpoint Playground
Test Crawlora's Apple Podcasts Charts Rankings API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
curl "https://api.crawlora.net/api/v1/apple-podcasts/charts/rankings?chart=top&type=podcasts&genre=1303&country=us&limit=24" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| chart | string | No | top | Chart algorithm. Allowed values: `top`, `top-subscriber`, `top-series`. Default `top`. |
| type | string | No | podcasts | Entity type. Allowed values: `podcasts`, `podcast-episodes`, `podcast-channels`. Default `podcasts`. |
| genre | integer | No | 1303 | Optional Apple Podcasts genre ID to filter the chart, e.g. 1303 for Comedy |
| country | string | No | us | Two-letter storefront country code |
| limit | integer | No | 24 | 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"
}
]
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
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.
{
"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"
}
]
}
}curl "https://api.crawlora.net/api/v1/apple-podcasts/charts/rankings" \
-H "x-api-key: $CRAWLORA_API_KEY"