Endpoint Playground
Returns the curated editorial shelves from podcasts.apple.com/{country}/new (New Shows, New Seasons, New Trailers, Essentials, and other seasonal spotlights). Shelves that merely mirror a Charts Rankings query are omitted here since `/apple-podcasts/charts/rankings` already covers that data.
14 Oct 2026: 6 shelves; 2 fields had a value in every checked item.
Sample value profiles: title: median 10 characters; items: median 20 entries.
curl 'https://api.crawlora.net/api/v1/apple-podcasts/new' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| country | string | No | Two-letter storefront country code |
{
"code": 200,
"msg": "OK",
"data": {
"shelves": [
{
"title": "New Shows",
"items": [
{
"id": 6789198595,
"kind": "podcast",
"name": "Better in Person",
"artist_name": "Freakonomics Radio",
"url": "https://podcasts.apple.com/us/podcast/better-in-person/id6789198595",
"artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/.../mza_.jpg/{w}x{h}bb.{f}",
"genres": [
"Documentary",
"Podcasts",
"Society & Culture"
]
}
]
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.