Podcast All Details
https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/all-details This wraps all the other endpoints for a podcast so you can get all the details in a single request. Set includePublishingHistory=true to include compact monthly counts for the last 24 UTC months, average per complete month, latest episode date, and truncation status. Existing episode and transcript counts are always available.
Request
Path parameters
Pod Engine ID or slug, Apple Podcasts ID, Spotify show ID, or podcast:guid
Query parameters
Include 24 months of publishing history. Defaults to false; omitted history incurs no history query.
Response
200 application/jsondataobjectrequired1 field
podcastobjectrequired11 fields
podcastobjectrequired37 fields
blockedobject2 fields
podcastAffiliationobjectrequirednullable2 fields
The name of the affiliate organization
The type of affiliation from the list: academic, branded, celebrity, government, independent, legacy media, podcast company, new media, not for profit, religious, other, unknown
podcastDirectoryLinksobjectrequired45 fields
statsobjectrequired6 fields
How often the show publishes new episodes, based on the typical gap between its recent episodes. daily: about every day. weekly: every 2–10 days. bi-weekly: every 10–20 days. monthly: less often than that. stale: no new episode for over 90 days, or for much longer than its usual gap. very-stale: no new episode for over a year.
audienceEstimateobject11 fields
audienceDemographicsobjectrequirednullable5 fields
How the audience is skewed in terms of gender.
The probable education levels of the audience.
The probable income levels of the audience.
An example profile of the audience. This is a description of the audience that you can use to describe the audience to an advertiser.
Bucket for the estimated monthly listeners: 0-1K, 1K-10K, 10K-100K, 100K-1M or 1M+. 0-1K means the estimate is under 1,000, even when the rounded figure reads 1,000. Null means no estimate is available.
The podcast-app part of estimatedMonthlyListeners, unrounded. Null when not available.
The YouTube part of estimatedMonthlyListeners (monthly views of the show on its matched YouTube channel), unrounded. Null when not available.
hostReportedobjectnullable4 fields
recentEpisodesarray of objectrequirednullable23 fields
episodeGuestsAndHostsarray of objectrequirednullable3 fields
Whether the podcast RSS feed declares a directly-downloadable video file for this episode. This does not include YouTube videos or Apple Podcasts HLS streams.
A direct, downloadable URL to the episode video file when hasVideo is true; otherwise null. HLS playlists and streaming-only sources are excluded.
audienceEstimateobject6 fields
audienceDemographicsobjectrequirednullable5 fields
How the audience is skewed in terms of gender.
The probable education levels of the audience.
The probable income levels of the audience.
An example profile of the audience. This is a description of the audience that you can use to describe the audience to an advertiser.
Bucket for the estimated monthly listeners: 0-1K, 1K-10K, 10K-100K, 100K-1M or 1M+. 0-1K means the estimate is under 1,000, even when the rounded figure reads 1,000. Null means no estimate is available.
youtubeEpisodeDetailsobjectrequirednullable4 fields
contactsobjectrequirednullable4 fields
emailsarray of objectrequired10 fields
The email address associated with the podcast contact
The timestamp when the email was last verified, or null if it has not been verified
Whether the email address has valid syntax (e.g. correctly formatted local and domain parts), or null if not yet checked
Whether the email's domain has valid MX records indicating it can receive mail, or null if not yet checked
The timestamp when the email was last deep-verified for deliverability, or null if not run
Deep deliverability status: valid, invalid, catch-all, unknown, spamtrap, abuse, or do_not_mail
Sub-classification providing more detail on the deliverability result
Whether the address belongs to a known free-email provider (e.g. gmail, yahoo)
Suggested correction for likely typos, e.g. gmial.com -> gmail.com
Whether the address belongs to a podcast hosting platform (e.g. anchor.fm, libsyn.com) rather than the show itself, so it usually reaches the host only indirectly
websitesarray of objectrequired3 fields
reviewsobjectrequirednullable8 fields
applePodcastsReviewobjectrequirednullable10 fields
applePodcastsReviewsByCountryarray of objectrequired10 fields
applePodcastsReviewTextobjectrequirednullable5 fields
spotifyReviewobjectrequirednullable4 fields
castboxobjectrequirednullable3 fields
chartPositionsarray of objectrequirednullable5 fields
The date of the chart in YYYY-MM-DD format
The country of the chart in ISO 3166-1 alpha-2 format, for example "us". Defaults to us.
The chart category defaulting to 'top podcasts'. Apple podcasts supports the following: "top podcasts", "arts", "business", "comedy", "education", "fiction", "government", "health & fitness", "history", "kids & family", "leisure", "music", "news", "religion & spirituality", "science", "society & culture", "sports", "technology", "true crime", "tv & film"
youtubeDataobjectrequirednullable2 fields
youtubeDataarray of objectrequired24 fields
thumbnailsobjectrequired3 fields
statsHistoryarray of object4 fields
recentEpisodeCoverageobject3 fields
publishingHistoryobjectnullable4 fields
How often the show publishes: episode counts per month for the last 24 months.
monthlyEpisodeCountsobjectrequired2 fields
Average episodes per complete month in the window, counted from the month of the first episode when the show started inside it, rounded to one decimal. Null when there is no complete month to average.
Publish time of the latest episode; null when there is none.
True when the show published more than 5,000 episodes in the window and only the latest were counted.