Datasets API endpoint
Returns one Apple Podcasts show from the dataset by its numeric show `id`. The record has show and artist names, genres, country, episode count (`track_count`), release date, feed URL, artwork and Apple URL. An id not in the dataset returns 404.
/datasets/apple-podcasts-shows/items/{id}Returns one crawled Apple Podcasts show record by id (the document id) from dataset id enum value apple-podcasts-shows. Returns 404 when the id is absent from the dataset.
Path parameters:
id (required) — Apple Podcasts numeric show id, e.g. 173001861.| Field | In the sample | Value in the sample |
|---|---|---|
| id | Has a value | |
| artist_id | Has a value | |
| artist_name | Has a value | |
| artist_url | Has a value | podcasts.apple.com |
| collection_name | Has a value | |
| url | Has a value | podcasts.apple.com |
| feed_url | Has a value | feeds.feedburner.com |
| artwork_url_600 | Has a value | is1-ssl.mzstatic.com |
| release_date | Has a value | 2025-12-22 |
| collection_explicitness | Has a value | |
| track_count | Has a value | 12 |
| country | Has a value | |
| currency | Has a value | |
| primary_genre_name | Has a value | |
| genre_ids | Has a value | |
| genres | Has a value | 2 entries |
| content_advisory_rating | Has a value | |
| discovery_source | Has a value | |
| discovery_country | Has a value | |
| discovery_genre_id | Has a value | |
| discovery_collection | Has a value | |
| seed_rank | Has a value | 0 |
| run_id | Has a value | |
| crawled_at | Has a value | 2026-07-22 |
| schema_version | Has a value |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Apple Podcasts numeric show id (e.g. 173001861) | 173001861 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/apple-podcasts-shows/items/173001861" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": 173001861,
"artist_name": "Dan Carlin",
"collection_name": "Dan Carlin's Hardcore History",
"feed_url": "https://feeds.example.com/hardcorehistory",
"track_count": 75,
"country": "USA",
"primary_genre_name": "History",
"genre_ids": [
"1301",
"1487"
],
"genres": [
"Arts",
"History"
],
"discovery_source": "chart",
"discovery_country": "us",
"discovery_genre_id": 1487,
"discovery_collection": "toppodcasts",
"seed_rank": 3,
"run_id": "apple-podcasts-20260721",
"crawled_at": "2026-07-21T00:00:00Z",
"schema_version": 1
}
}Request schema
No body schema
Response schema
#/definitions/datasets.applePodcastsShowResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | es.ApplePodcastsShowRecord | No | ||||
| data.artist_id | integer | No | ||||
| data.artist_name | string | No | ||||
| data.artist_url | string | No | ||||
| data.artwork_url_600 | string | No | ||||
| data.collection_explicitness | string | No | ||||
| data.collection_name | string | No | ||||
| data.content_advisory_rating | string | No | ||||
| data.country | string | No | ||||
| data.crawled_at | string | No | ||||
| data.currency | string | No | ||||
| data.discovery_collection | string | No | ||||
| data.discovery_country | string | No | ||||
| data.discovery_genre_id | integer | No | ||||
| data.discovery_source | string | No | DiscoverySource is "chart", "search" (show-search term sweep), or "episode_search" (episode-search term sweep, M6 — the parent show of a matching episode). DiscoveryCountry/DiscoveryGenreID/DiscoveryCollection record which chart grid cell first surfaced this show (empty genre id/collection for either search-sweep source). | |||
| data.feed_url | string | No | ||||
| data.genre_ids | array | No | ||||
| data.genres | array | No | ||||
| data.id | integer | No | ||||
| data.primary_genre_name | string | No | ||||
| data.quality_checked_at | string | No | ||||
| data.quality_reason | string | No | ||||
| data.quality_state | string | No | Quality* records the terminal/backfill state without changing the last known crawl snapshot. It is populated only for the targeted repair flow. | |||
| data.release_date | string | No | ||||
| data.run_id | string | No | ||||
| data.schema_version | integer | No | ||||
| data.seed_rank | integer | No | ||||
| data.track_count | integer | No | TrackCount is the episode count as reported by the iTunes lookup at crawl time. | |||
| data.url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/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/datasets/apple-podcasts-shows/items/173001861" \
-H "x-api-key: $CRAWLORA_API_KEY"