Apple Podcasts API & Scraper — Shows, Episodes & Charts
Pricing
Pay per event
Apple Podcasts shows by link, search or top chart (any country and genre) with rating, publisher, genres and feed, plus their episodes with audio links. No login. Unofficial Apple Podcasts API.
Input
input
Optional
The search, link or value this record came from.
Status
status
Optional
Result of this record: OK for a delivered record, or a reason code (for example NO_RESULTS, NOT_FOUND, INVALID_INPUT, FAILED) when the input gave nothing.
Error
error
Optional
Plain-language reason when status is not OK; empty for a delivered record.
Record type
recordType
Optional
Kind of record: podcast or episode.
Input type
inputType
Optional
How the input was read (for example link or keyword).
Position
position
Optional
Position of the record inside its search, starting at 1.
Store country
storeCountry
Optional
Apple Podcasts store country the record was read from, for example us.
Podcast id
podcastId
Optional
Apple Podcasts show id.
Name
name
Optional
Show name.
Publisher
publisher
Optional
Publisher as Apple shows it.
Primary genre
primaryGenre
Optional
Main genre.
Genres
genres
Optional
All genres.
Genre ids
genreIds
Optional
Apple genre ids.
Episode count
episodeCount
Optional
Number of episodes on Apple.
Latest release date
latestReleaseDate
Optional
ISO 8601 time of Apple's latest release (can be a scheduled episode a few weeks ahead).
Explicit
explicit
Optional
True when the show is marked explicit.
Content rating
contentRating
Optional
Content rating: Clean or Explicit.
Feed url
feedUrl
Optional
Public RSS feed of the show.
Artwork
artwork
Optional
URL of the 600 by 600 cover.
Url
url
Optional
Link to the record on the source site.
Rating
rating
Optional
Average star rating in the chosen store.
Rating count
ratingCount
Optional
Number of ratings in the chosen store.
Description
description
Optional
Show description (with Add rating and description) or the episode show notes.
Scraped at
scrapedAt
Optional
ISO 8601 time the record was collected.
Chart
chart
Optional
Chart the show was read from, for example History (chart inputs only).
Episode id
episodeId
Optional
Apple episode id; null for older episodes read from the feed.
Title
title
Optional
Episode title.
Podcast name
podcastName
Optional
Name of the show the episode belongs to.
Release date
releaseDate
Optional
ISO 8601 time the episode came out.
Duration sec
durationSec
Optional
Episode length in seconds.
Audio url
audioUrl
Optional
Link to the audio or video file.
Media type
mediaType
Optional
Media type, for example audio or video.
File extension
fileExtension
Optional
File extension of the media file.
Episode number
episodeNumber
Optional
Episode number from the feed, when the show gives one.
Season
season
Optional
Season number from the feed, when the show gives one.
Episode type
episodeType
Optional
Episode type from the feed, for example full, trailer or bonus.
Guid
guid
Optional
Episode GUID from the feed.
Source
source
Optional
Where the episode was read from: apple or feed.
