---
title: "Search Apple Podcasts episodes"
method: GET
path: "/apple-podcasts/episodes/search"
tags: ["ApplePodcasts"]
---

# Search Apple Podcasts episodes

`GET /apple-podcasts/episodes/search`

## Request

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

Searches Apple Podcasts episodes by `term`, which is required. `country`, `lang`, `limit` and `page` (1-based) refine the search. Each episode has its `title`, `show_name`, `show_id`, `description`, `duration_millis`, `release_date`, `episode_url`, `preview_url`, `feed_url`, genres and artwork.

## Query parameters

- `term` string, required
- `country` string
- `lang` string
- `limit` integer
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplepodcastsEpisodeSearchResponseDoc
  - `code` integer
  - `data` ApplepodcastsPodcastEpisode[]
    - `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.
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `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/afac9b012a27?raw)