ApplePodcasts API endpoint
Returns the "You Might Also Like" rail for a single show, sourced from the modern podcasts.apple.com show page's listener-cohort recommendation data.
/apple-podcasts/show/{id}/relatedMCP tool: apple_podcasts_show_related
Query parameters:
country — two-letter storefront country code. Default us.limit — number of related shows to return, default 20, max 50.| Field | Filled in, of 15 checked | Values in the sample |
|---|---|---|
| id | 15 | |
| name | 15 | “Common Sense with Dan Carlin” and 14 other values |
| artist_name | 15 | “Dan Carlin” and 13 other values |
| url | 15 | podcasts.apple.com |
| artwork_url | 15 | is1-ssl.mzstatic.com |
| genres | 15 | median 3 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Apple Podcasts show ID | 173001861 | |
| country | string | No | Two-letter storefront country code | us | |
| limit | integer | No | Number of related shows to return, default 20, max 50 | 20 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/apple-podcasts/show/173001861/related?country=us&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"show_id": 1886587874,
"shows": [
{
"id": 1748194675,
"name": "选修课 Universus",
"artist_name": "Zhichen Zhao",
"url": "https://podcasts.apple.com/us/podcast/%E9%80%89%E4%BF%AE%E8%AF%BE-universus/id1748194675",
"artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/.../mza_.jpg/{w}x{h}bb.{f}",
"genres": [
"Society & Culture",
"Podcasts",
"Education"
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/applepodcasts.relatedShowsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | applepodcasts.RelatedShowsResult | No | ||||
| data.show_id | integer | No | Apple Podcasts id of the show the recommendations are for. | |||
| data.shows | array | No | Shows listed under You Might Also Like for the requested show. | |||
| data.shows[].artist_name | string | No | Name of the related show's publisher or creator. | |||
| data.shows[].artwork_url | string | No | Artwork URL template. Replace `{w}`, `{h}` and `{f}` with the width, height and image format you want. | |||
| data.shows[].genres | array | No | Genre names the related show is filed under. | |||
| data.shows[].id | integer | No | Apple Podcasts id of the related show. | |||
| data.shows[].name | string | No | Name of the related show. | |||
| data.shows[].url | string | No | Apple Podcasts page URL of the related show. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Missing or invalid parameters | #/definitions/app.Response |
| 404 | Show not found | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/apple-podcasts/show/173001861/related?country=us&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"