Apple Podcasts
Overview
Apple Podcasts content platform — search, browse, and get details for podcasts and episodes via the AMP API.
Workflows
Search and explore a podcast
searchPodcasts(term) → results with podcast idgetPodcast(id, include=["episodes"]) → full details with episode list
Autocomplete search
getSearchSuggestions(term) → suggestions with podcast/episode matchessearchPodcasts(term) → full search results
Browse top charts
getTopCharts(name="search-landing") → editorial groupings with featured podcasts
Operations
| Operation |
Intent |
Key Input |
Key Output |
Notes |
| searchPodcasts |
search by keyword |
term |
id, name, artistName, artwork, url |
entry point |
| getPodcast |
podcast detail + episodes |
id ← searchPodcasts |
name, description, artwork, feedUrl, genreNames, episodes (via include) |
set include=episodes for episode list |
| getSearchSuggestions |
autocomplete |
term |
searchTerm, displayTerm, content |
prefix-based suggestions |
| getTopCharts |
browse charts |
name (optional) |
editorial groupings, featured podcasts |
name=search-landing for main charts |
Quick Start
# Search podcasts
openweb apple-podcasts exec searchPodcasts '{"term":"technology"}'
# Get podcast details with episodes
openweb apple-podcasts exec getPodcast '{"id":"917918570","extend":["editorialArtwork","feedUrl","userRating"],"include":["episodes"],"limit[episodes]":10}'
# Autocomplete suggestions
openweb apple-podcasts exec getSearchSuggestions '{"term":"tech"}'
# Top charts
openweb apple-podcasts exec getTopCharts '{"name":"search-landing"}'
1---2name: apple-podcasts3description: Apple Podcasts4---5# Apple Podcasts67## Overview8Apple Podcasts content platform — search, browse, and get details for podcasts and episodes via the AMP API.910## Workflows1112### Search and explore a podcast131. `searchPodcasts(term)` → results with podcast `id`142. `getPodcast(id, include=["episodes"])` → full details with episode list1516### Autocomplete search171. `getSearchSuggestions(term)` → suggestions with podcast/episode matches182. `searchPodcasts(term)` → full search results1920### Browse top charts211. `getTopCharts(name="search-landing")` → editorial groupings with featured podcasts2223## Operations2425| Operation | Intent | Key Input | Key Output | Notes |26|-----------|--------|-----------|------------|-------|27| searchPodcasts | search by keyword | term | id, name, artistName, artwork, url | entry point |28| getPodcast | podcast detail + episodes | id ← searchPodcasts | name, description, artwork, feedUrl, genreNames, episodes (via include) | set include=episodes for episode list |29| getSearchSuggestions | autocomplete | term | searchTerm, displayTerm, content | prefix-based suggestions |30| getTopCharts | browse charts | name (optional) | editorial groupings, featured podcasts | name=search-landing for main charts |3132## Quick Start3334```bash35# Search podcasts36openweb apple-podcasts exec searchPodcasts '{"term":"technology"}'3738# Get podcast details with episodes39openweb apple-podcasts exec getPodcast '{"id":"917918570","extend":["editorialArtwork","feedUrl","userRating"],"include":["episodes"],"limit[episodes]":10}'4041# Autocomplete suggestions42openweb apple-podcasts exec getSearchSuggestions '{"term":"tech"}'4344# Top charts45openweb apple-podcasts exec getTopCharts '{"name":"search-landing"}'46```
spike-faye-lei