# Apple API: Get podcast

> Gets an Apple Podcasts show's details and its newest available episodes, by show name or Apple Podcasts link.

Unofficial. Not affiliated with or endorsed by Apple.

- Page: https://fous.com/methods/podcasts.apple.com/get-podcast
- Method: `podcasts.apple.com/get_podcast`, version 1
- Website: podcasts.apple.com
- Returns: name, publisher, description, category, rating, website, artwork, feed URL, episodes
- 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 |
|---|---|---|---|---|
| `country` | string | no |  | Country name or two-letter code for listings and ratings, such as United States or GB. Default "United States". |
| `podcast` | string | yes | `"The Daily"` | Podcast name or Apple Podcasts show link, such as The Daily. |
| `max_episodes` | integer | no |  | Maximum number of recent episodes to return, such as 20. Default 20. |

## Output

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

```json
{
  "podcast": "The Daily"
}
```

Its output:

```json
{
  "name": "The Daily",
  "category": "Daily News",
  "episodes": [
    {
      "title": "The Battle Over Black Representation in the South",
      "length": "29 min",
      "description": "The approach to this year’s midterms has brought two hugely consequential changes to voting for Black Americans: the gutting of the Voting Rights Act, and redistricting. In the wake of those actions, efforts are underway to mobilize Black voters in the South. In Mississippi, the Senate battle is bei…",
      "episode_url": null,
      "release_date": "2026-10-23",
      "audio_file_url": "https://dts.podtrac.com/redirect.mp3/pdst.fm/e/pfx.vpixl.com/6qj4J/pscrb.fm/rss/p/tracking.swap.fm/track/4jdbJYYRKqK96EGqOzQb/nyt.simplecastaudio.com/03d8b493-87fc-4bd1-931f-8a8e9b945d8a/episodes/60ffceb7-687b-4c09-b075-cd86e8bd477f/audio/128/default.mp3?aid=rss_feed&awCollectionId=03d8b493-87fc-4bd…",
      "length_seconds": 1775
    },
    {
      "title": "The Election That Will Define Israel’s Future",
      "length": "33 min",
      "description": "Israelis head to the polls next week. On the ballot is the future of a country that has become isolated on the world stage, because of both its war in Gaza and a growing outcry over settler violence in the West Bank. David M. Halbfinger, the Jerusalem bureau chief for The New York Times, explains ho…",
      "episode_url": "https://podcasts.apple.com/us/podcast/the-election-that-will-define-israels-future/id1200361736?i=1000797595841",
      "release_date": "2026-10-22",
      "audio_file_url": "https://dts.podtrac.com/redirect.mp3/pdst.fm/e/pfx.vpixl.com/6qj4J/pscrb.fm/rss/p/tracking.swap.fm/track/4jdbJYYRKqK96EGqOzQb/nyt.simplecastaudio.com/03d8b493-87fc-4bd1-931f-8a8e9b945d8a/episodes/4d142ed1-ec9d-470b-b52b-ba35e33fedf6/audio/128/default.mp3?aid=rss_feed&awCollectionId=03d8b493-87fc-4bd…",
      "length_seconds": 2032
    },
    {
      "title": "Is This Economy as Awful as Voters Think? We Ask Our Expert.",
      "length": "32 min",
      "description": "The economy is one of the most important issues for voters in the midterm elections. President Trump has been trying to persuade Americans that they are wrong to be frustrated about the cost of living. Ben Casselman, the chief economics correspondent for The New York Times, explains what the latest …",
      "episode_url": "https://podcasts.apple.com/us/podcast/is-this-economy-as-awful-as-voters-think-we-ask-our-expert/id1200361736?i=1000797417699",
      "release_date": "2026-10-21",
      "audio_file_url": "https://dts.podtrac.com/redirect.mp3/pdst.fm/e/pfx.vpixl.com/6qj4J/pscrb.fm/rss/p/tracking.swap.fm/track/4jdbJYYRKqK96EGqOzQb/nyt.simplecastaudio.com/03d8b493-87fc-4bd1-931f-8a8e9b945d8a/episodes/93fe65fc-d93d-490d-b13f-c5a17049a898/audio/128/default.mp3?aid=rss_feed&awCollectionId=03d8b493-87fc-4bd…",
      "length_seconds": 1949
    }
  ],
  "publisher": "The New York Times",
  "podcast_id": "1200361736",
  "artwork_url": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/ab/64/66/ab6466a9-9a7d-e20e-7a3d-bc5be37d29ce/mza_15084852813176276273.jpg/1200x1200bb.jpg",
  "description": "This is what the news should sound like. The biggest stories of our time, told by the best journalists in the world. Hosted by Michael Barbaro, Rachel Abrams and Natalie Kitroeff. Twenty minutes a day, six days a week, ready by 6 a.m. Subscribe today at nytimes.com/podcasts or on Apple Podcasts, Spo…",
  "website_url": "https://www.nytimes.com/the-daily",
  "rating_count": 106007,
  "rss_feed_url": "https://feeds.simplecast.com/Sl5CSM3S",
  "average_rating": 4.3,
  "update_frequency": "Updated Daily",
  "apple_podcasts_url": "https://podcasts.apple.com/us/podcast/the-daily/id1200361736"
}
```

## 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/get_podcast","input":{"podcast":"The Daily"}}'
```

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

- I want the details and latest episodes of the podcast Serial, including its publisher and feed URL.
- Can you pull up the Apple Podcasts show The Daily and list its 10 newest episodes?
- Get me the description, category, and rating for the Huberman Lab podcast in the GB store.
- Look up this Apple Podcasts link and give me the show's artwork, website, and recent episodes: https://podcasts.apple.com/us/podcast/radiolab/id79112081
- What's the latest from the podcast Hard Fork on apple.com? I need the newest 5 episodes and the RSS feed.

## Input schema

```json
{
  "type": "object",
  "required": [
    "podcast"
  ],
  "properties": {
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code for listings and ratings, such as United States or GB."
    },
    "podcast": {
      "type": "string",
      "minLength": 1,
      "description": "Podcast name or Apple Podcasts show link, such as The Daily."
    },
    "max_episodes": {
      "type": "integer",
      "default": 20,
      "maximum": 300,
      "minimum": 1,
      "description": "Maximum number of recent episodes to return, such as 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "name",
    "apple_podcasts_url",
    "episodes"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "category": {
      "type": [
        "string",
        "null"
      ]
    },
    "episodes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "length": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "episode_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "release_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "audio_file_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "length_seconds": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    },
    "publisher": {
      "type": [
        "string",
        "null"
      ]
    },
    "podcast_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "artwork_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "website_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "rating_count": {
      "type": [
        "integer",
        "null"
      ]
    },
    "rss_feed_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "average_rating": {
      "type": [
        "number",
        "null"
      ]
    },
    "update_frequency": {
      "type": [
        "string",
        "null"
      ]
    },
    "apple_podcasts_url": {
      "type": "string"
    }
  }
}
```

## See more

- [Apple API: Search podcasts](https://fous.com/methods/podcasts.apple.com/search-podcasts.md): Finds Apple Podcasts shows by name or topic in a country, ordered by search relevance, with ratings when the show page provides them.
- [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 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 App Store app](https://fous.com/methods/apps.apple.com/get-app.md): Gets an iPhone or iPad app's public App Store listing by name or link. You can narrow it by developer and country. In-app purchases are included when the page lists them.
- [Apple API: Get artist](https://fous.com/methods/music.apple.com/get-artist.md): Gets an Apple Music artist profile by name or artist link. The profile includes the latest release, top songs and albums.
- [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: Get album](https://fous.com/methods/music.apple.com/get-album.md): Finds an Apple Music album by title and optional artist, or by album link, and returns its matched release, purchase details and tracks in order.
- [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.
- [All Apple methods](https://fous.com/methods/apple.com.md)
