---
title: "Get an Apple Podcasts show from dataset"
method: GET
path: "/datasets/apple-podcasts-shows/items/{id}"
tags: ["Datasets"]
---

# Get an Apple Podcasts show from dataset

`GET /datasets/apple-podcasts-shows/items/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/apple-podcasts-shows/items/{id}`
- Auth: API key in header `x-api-key`

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.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsApplePodcastsShowResponseDoc
  - `code` integer
  - `data` EsApplePodcastsShowRecord
    - `artist_id` integer
    - `artist_name` string
    - `artist_url` string
    - `artwork_url_600` string
    - `collection_explicitness` string
    - `collection_name` string
    - `content_advisory_rating` string
    - `country` string
    - `crawled_at` string
    - `currency` string
    - `discovery_collection` string
    - `discovery_country` string
    - `discovery_genre_id` integer
    - `discovery_source` string: 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).
    - `feed_url` string
    - `genre_ids` string[]
    - `genres` string[]
    - `id` integer
    - `primary_genre_name` string
    - `quality_checked_at` string
    - `quality_reason` string
    - `quality_state` string: Quality* records the terminal/backfill state without changing the last known crawl snapshot. It is populated only for the targeted repair flow.
    - `release_date` string
    - `run_id` string
    - `schema_version` integer
    - `seed_rank` integer
    - `track_count` integer: TrackCount is the episode count as reported by the iTunes lookup at crawl time.
    - `url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)