# Apple API: Search podcasts

> Finds Apple Podcasts shows by name or topic in a country, ordered by search relevance, with ratings when the show page provides them.

Unofficial. Not affiliated with or endorsed by Apple.

- Page: https://fous.com/methods/podcasts.apple.com/search-podcasts
- Method: `podcasts.apple.com/search_podcasts`, version 1
- Website: podcasts.apple.com
- Returns: podcast name, publisher, category, episode count, rating, artwork, Apple and RSS links
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `query` | string | yes | `"Huberman"` | Podcast name or topic to search for, such as Huberman or personal finance. |
| `country` | string | no |  | Country name or two-letter country code, such as United States or GB. Default "United States". |
| `max_results` | integer | no |  | Maximum number of shows to return, such as 20. The public search currently provides at most 100. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "query": "Huberman"
}
```

Its output:

```json
{
  "podcasts": [
    {
      "publisher": "Scicomm Media",
      "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/9a/d3/19/9ad31912-0b5a-a16e-2d7c-9fd074698b9c/mza_8994222203629500925.jpg/600x600bb.jpg",
      "podcast_name": "Huberman Lab",
      "rating_count": 28049,
      "rss_feed_url": "https://feeds.megaphone.fm/hubermanlab",
      "episode_count": 452,
      "main_category": "Health & Fitness",
      "average_rating": 4.8,
      "apple_podcast_id": "1545953110",
      "apple_podcasts_url": "https://podcasts.apple.com/us/podcast/huberman-lab/id1545953110?uo=4",
      "latest_episode_date": "2026-10-22"
    },
    {
      "publisher": "Erik Huberman",
      "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts112/v4/b8/79/0b/b8790bb4-6c94-ae24-4830-6fda77fb9663/mza_6767486214087564093.jpeg/600x600bb.jpg",
      "podcast_name": "HawkeTalk",
      "rating_count": 440,
      "rss_feed_url": "https://feeds.acast.com/public/shows/637de88074e2da0012a3bfca",
      "episode_count": 238,
      "main_category": "Business News",
      "average_rating": 4.9,
      "apple_podcast_id": "1534940129",
      "apple_podcasts_url": "https://podcasts.apple.com/us/podcast/hawketalk/id1534940129?uo=4",
      "latest_episode_date": "2026-07-09"
    },
    {
      "publisher": "Michelle Grosser – Inspired by Mel Robbins, Dr. Andrew Huberman, and Dr. Becky Kennedy",
      "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/ba/96/c4/ba96c4c3-894f-dd27-e480-21679fbc47e2/mza_12673735177242970332.jpg/600x600bb.jpg",
      "podcast_name": "High Capacity – Nervous System Regulation, Stress Management, Burnout Recovery, Somatic Tools, Anxiety, Boundaries, Overwhe",
      "rating_count": 528,
      "rss_feed_url": "https://rss.buzzsprout.com/2302784.rss",
      "episode_count": 500,
      "main_category": "Parenting",
      "average_rating": 4.9,
      "apple_podcast_id": "1621946084",
      "apple_podcasts_url": "https://podcasts.apple.com/us/podcast/high-capacity-nervous-system-regulation-stress-management/id1621946084?uo=4",
      "latest_episode_date": "2026-10-20"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"podcasts.apple.com/search_podcasts","input":{"query":"Huberman"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find podcasts about personal finance for listeners in the UK, ranked by relevance, with ratings and episode counts
- I need true crime podcasts available in the United States, top 15 results with publisher names
- Search Apple Podcasts for Huberman and show me the matching shows with their RSS feed links
- What podcasts cover beginner Spanish lessons in Canada? Give me up to 50 results
- Look up shows named The Daily or similar news podcasts in Germany and list their categories and artwork

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Podcast name or topic to search for, such as Huberman or personal finance."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter country code, such as United States or GB."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of shows to return, such as 20. The public search currently provides at most 100."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "podcasts"
  ],
  "properties": {
    "podcasts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "podcast_name",
          "publisher",
          "main_category",
          "episode_count",
          "average_rating",
          "rating_count",
          "latest_episode_date",
          "artwork_url",
          "apple_podcasts_url",
          "apple_podcast_id",
          "rss_feed_url"
        ],
        "properties": {
          "publisher": {
            "type": [
              "string",
              "null"
            ],
            "description": "Publisher or creator."
          },
          "artwork_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Show artwork link."
          },
          "podcast_name": {
            "type": "string",
            "description": "Name of the show."
          },
          "rating_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of listener ratings, when shown."
          },
          "rss_feed_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Show RSS feed link, when available."
          },
          "episode_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of episodes listed for the show."
          },
          "main_category": {
            "type": [
              "string",
              "null"
            ],
            "description": "Main podcast category."
          },
          "average_rating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Average listener rating out of 5, when shown."
          },
          "apple_podcast_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Apple Podcasts show ID."
          },
          "apple_podcasts_url": {
            "type": "string",
            "description": "Apple Podcasts show page link."
          },
          "latest_episode_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Most recent episode date in YYYY-MM-DD, when known."
          }
        }
      },
      "description": "Shows in search relevance order."
    }
  }
}
```

## See more

- [Apple API: Search apps](https://fous.com/methods/apps.apple.com/search-apps.md): Finds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links.
- [Apple API: Get podcast](https://fous.com/methods/podcasts.apple.com/get-podcast.md): Gets an Apple Podcasts show's details and its newest available episodes, by show name or Apple Podcasts link.
- [Apple API: Search songs](https://fous.com/methods/music.apple.com/search-songs.md): Searches the Apple Music song catalog by title and artist words, returning matching tracks in relevance order with prices and previews when available.
- [Apple API: List top podcasts](https://fous.com/methods/podcasts.apple.com/list-top-podcasts.md): Lists Apple Podcasts chart entries in rank order for a country and category, as top shows or top episodes.
- [Apple API: Get podcast reviews](https://fous.com/methods/podcasts.apple.com/get-podcast-reviews.md): Gets a podcast's country-specific rating total and average, plus up to 500 listener reviews sorted by newest or most helpful.
- [Apple API: List top charts](https://fous.com/methods/music.apple.com/list-top-charts.md): Lists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results.
- [Apple API: Get app reviews](https://fous.com/methods/apps.apple.com/get-app-reviews.md): Gets customer reviews for an iPhone or iPad app, found by name or App Store link, from the selected country's App Store.
- [Apple API: List top App Store charts](https://fous.com/methods/apps.apple.com/list-top-charts.md): Lists ranked iPhone or iPad apps from the public App Store charts for a chart, category, and country. App bundles and apps that are no longer available are left out.
- [All Apple methods](https://fous.com/methods/apple.com.md)
