---
title: "Retrieve Apple Podcasts show episodes"
method: GET
path: "/apple-podcasts/show/{id}/episodes"
tags: ["ApplePodcasts"]
---

# Retrieve Apple Podcasts show episodes

`GET /apple-podcasts/show/{id}/episodes`

## Request

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

Returns one Apple Podcasts show by its Apple show `id`, together with a list of its episodes. `limit` sets how many episodes to return; `country` and `lang` choose the storefront and language. Episodes have `title`, `description`, `duration_millis`, `release_date`, `episode_url` and `episode_guid`.

## Path parameters

- `id` string, required

## Query parameters

- `country` string
- `lang` string
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplepodcastsShowEpisodesResponseDoc
  - `code` integer
  - `data` ApplepodcastsShowEpisodesResult
    - `episodes` ApplepodcastsPodcastEpisode[]: Episodes of the show.
      - `artwork_url_160` string: URL of the episode artwork image, 160 pixels wide.
      - `artwork_url_60` string: URL of the episode artwork image, 60 pixels wide.
      - `artwork_url_600` string: URL of the episode artwork image, 600 pixels wide.
      - `closed_captioning` string: Closed captioning flag Apple reports for the episode.
      - `content_advisory_rating` string: Content advisory rating Apple gives the episode.
      - `country` string: Storefront country code of the episode.
      - `description` string: Full episode description.
      - `duration_millis` integer: Episode length in milliseconds.
      - `episode_content_type` string: Media type of the episode file.
      - `episode_file_extension` string: File extension of the episode media file.
      - `episode_guid` string: Episode GUID from the show's feed.
      - `episode_url` string: URL of the episode media file.
      - `feed_url` string: URL of the show's RSS feed.
      - `genres` ApplepodcastsGenre[]: Genres the episode is filed under.
        - `id` string: Apple genre id.
        - `name` string: Genre name as Apple Podcasts shows it.
      - `id` integer: Apple Podcasts id of the episode.
      - `preview_url` string: URL of the episode audio or video preview.
      - `release_date` string: Date and time the episode was released, as Apple returns it.
      - `short_description` string: Short episode description.
      - `show_id` integer: Apple Podcasts id of the show the episode belongs to.
      - `show_name` string: Name of the show the episode belongs to.
      - `show_url` string: Apple Podcasts page URL of the show.
      - `title` string: Episode title as shown on Apple Podcasts.
      - `url` string: Apple Podcasts page URL of the episode.
    - `show` ApplepodcastsPodcastShow
      - `artist_id` integer: Apple id of the show's publisher or creator.
      - `artist_name` string: Name of the show's publisher or creator.
      - `artist_url` string: Apple Podcasts page URL of the publisher or creator.
      - `artwork_url_100` string: URL of the show artwork image, 100 pixels wide.
      - `artwork_url_30` string: URL of the show artwork image, 30 pixels wide.
      - `artwork_url_60` string: URL of the show artwork image, 60 pixels wide.
      - `artwork_url_600` string: URL of the show artwork image, 600 pixels wide.
      - `collection_explicitness` string: Explicitness label Apple gives the show collection.
      - `collection_name` string: Show name as listed in the collection.
      - `content_advisory_rating` string: Content advisory rating Apple gives the show.
      - `country` string: Storefront country code of the show.
      - `currency` string: Currency code Apple lists for the show.
      - `feed_url` string: URL of the show's RSS feed.
      - `genre_ids` string[]: Apple genre ids the show is filed under.
      - `genres` string[]: Names of the genres the show is filed under.
      - `id` integer: Apple Podcasts id of the show.
      - `primary_genre_name` string: Name of the show's main genre.
      - `release_date` string: Release date and time Apple lists for the show, as Apple returns it.
      - `track_count` integer: Number of episodes Apple reports for the show.
      - `track_explicitness` string: Explicitness label Apple gives the show's track entry.
      - `track_name` string: Show name as listed on the track entry.
      - `url` string: Apple Podcasts page URL of the show.
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `404`: Show not found
- `429`: Rate limit exceeded
- `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)