Podcast All Details

GET 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.

Request

Path parameters

podcastIdOrSlugstringrequired

Podengine ID, Apple ID, or slug

Response

200 application/json
statusliteral: OKrequired
dataobjectrequired1 field
podcastobjectrequired10 fields
podcastobjectrequired37 fields
authorstringrequirednullable
authorityScoreobjectrequirednullable6 fields
calculatedAtdaterequired
authorityScorenumberrequired

This is the weighted total authority score of the podcast, out of 100

qualityScorenumberrequired

This is the quality score of the podcast, out of 100

youtubeScorenumberrequired

This is the YouTube score of the podcast, out of 100

socialScorenumberrequired

This is the social score of the podcast, out of 100

engagementScorenumberrequired

This is the engagement score of the podcast, out of 100

genresarray of stringrequired
idstringrequired
imageUrlstringrequirednullable
languagestringrequired
slugstringrequired
titlestringrequired
titleLateststringrequired
appleIdnumberrequired
blockedobject2 fields
blockedDatedaterequired
descriptionstringrequirednullable
emailsarray of stringrequired
explicitRssbooleanrequirednullable
hostNamesarray of stringrequirednullable
ignorebooleanrequired
isClaimedbooleanrequired
podcastAffiliationobjectrequirednullable2 fields

The name of the affiliate organization

affiliationTypeenumnullable

The type of affiliation from the list: academic, branded, celebrity, government, independent, legacy media, podcast company, new media, not for profit, religious, other, unknown

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown
podcastHasGuestsbooleanrequirednullable
podcastHasSponsorsbooleanrequirednullable
podcastLocationsarray of stringrequirednullable
primaryContactEmailstringrequirednullable
rssFeedUrlstringrequired
spotifyIdstringrequirednullable
statsobjectrequired6 fields
downloadCountnumberrequired
episodeCountnumberrequired
latestPublishedAtdaterequirednullable
firstEpisodePublishedAtdaterequirednullable
transcriptsCountnumberrequired
updateFrequencyenumrequired
dailyweeklybi-weeklymonthlystalevery-stale
titleLatestCleanedstringrequirednullable
transcriptionModeunionrequired
websiteUrlstringrequirednullable
audienceEstimateobject7 fields
audienceDemographicsobjectrequirednullable5 fields
ageRangeenumrequired

The age range of the audience as a string.

Under 1818-2425-3435-4445-5455+
genderSkewenumrequired

How the audience is skewed in terms of gender.

Male 0% Female 100%Male 20% Female 80%Male 40% Female 60%Male 50% Female 50%Male 60% Female 40%Male 80% Female 20%Male 100% Female 0%
educationLevelenumrequired

The probable education levels of the audience.

No High SchoolHigh SchoolSome CollegeBachelors DegreeMasters DegreeDoctorate
incomeLevelenumrequired

The probable income levels of the audience.

Under $25K$25K-$50K$50K-$75K$75K-$100K$100K-$150K$150K-$200K$200K+

An example profile of the audience. This is a description of the audience that you can use to describe the audience to an advertiser.

estimatedMonthlyListenersnumberrequirednullable
confidenceenumnullable
highmediumlow
isDormantbooleannullable
RETAIN_INDEFINITELYRETAIN_DAYSRETAIN_UNTIL_TRANSCRIBED
audioRetentionDaysnumbernullable
recentEpisodesarray of objectrequirednullable23 fields
deepAnalysisRequestedAtdaterequirednullable
descriptionstringrequirednullable
durationSecondsnumberrequirednullable
enclosureUrlstringrequired
episodeIdstringrequireduuid
episodeGuestsAndHostsarray of objectrequirednullable3 fields
namestringrequired
typeenumrequired
hostguestunknownmentioned
imageUrlstringrequirednullable
episodeSlugstringrequired
episodeShortDescriptionstringrequirednullable
episodeSponsorsarray of stringrequirednullable
hasTranscriptbooleanrequired
hasVideobooleanrequired

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.

videoUrlstringrequirednullableurl

A direct, downloadable URL to the episode video file when hasVideo is true; otherwise null. HLS playlists and streaming-only sources are excluded.

imageUrlstringrequirednullable
episodeThumbnailRssUrlstringrequirednullable
podcastIdstringrequireduuid
podcastSlugstringrequired
publishedAtdaterequired
titlestringrequired
transcriptIdstringrequirednullableuuid
transcriptionRequestedAtdaterequirednullable
audienceEstimateobject5 fields
audienceDemographicsobjectrequirednullable5 fields
ageRangeenumrequired

The age range of the audience as a string.

Under 1818-2425-3435-4445-5455+
genderSkewenumrequired

How the audience is skewed in terms of gender.

Male 0% Female 100%Male 20% Female 80%Male 40% Female 60%Male 50% Female 50%Male 60% Female 40%Male 80% Female 20%Male 100% Female 0%
educationLevelenumrequired

The probable education levels of the audience.

No High SchoolHigh SchoolSome CollegeBachelors DegreeMasters DegreeDoctorate
incomeLevelenumrequired

The probable income levels of the audience.

Under $25K$25K-$50K$50K-$75K$75K-$100K$100K-$150K$150K-$200K$200K+

An example profile of the audience. This is a description of the audience that you can use to describe the audience to an advertiser.

estimatedMonthlyListenersnumberrequirednullable
confidenceenumnullable
highmediumlow
isDormantbooleannullable
youtubeEpisodeDetailsobjectrequirednullable4 fields
youtubeViewCountnumberrequirednullable
youtubeDataFetchedAtdaterequirednullable
applePodcastsUrlstringrequirednullableurl
contactsobjectrequirednullable4 fields
podcastIdstringrequired
emailsarray of objectrequired9 fields
emailstringrequired

The email address associated with the podcast contact

verifiedAtdaterequirednullable

The timestamp when the email was last verified, or null if it has not been verified

syntaxValidbooleanrequirednullable

Whether the email address has valid syntax (e.g. correctly formatted local and domain parts), or null if not yet checked

mxValidbooleanrequirednullable

Whether the email's domain has valid MX records indicating it can receive mail, or null if not yet checked

deepVerifiedAtdaterequirednullable

The timestamp when the email was last deep-verified for deliverability, or null if not run

deliverabilityStatusenumrequirednullable

Deep deliverability status: valid, invalid, catch-all, unknown, spamtrap, abuse, or do_not_mail

validinvalidcatch-allunknownspamtrapabusedo_not_mail
deliverabilityReasonstringrequirednullable

Sub-classification providing more detail on the deliverability result

isFreeEmailProviderbooleanrequirednullable

Whether the address belongs to a known free-email provider (e.g. gmail, yahoo)

suggestedCorrectionstringrequirednullable

Suggested correction for likely typos, e.g. gmial.com -> gmail.com

phoneNumbersarray of stringrequired
websitesarray of objectrequired3 fields
urlstringrequired
verifiedbooleanrequired
contactUrlsarray of stringrequired
guestsobjectrequirednullable5 fields
episodesCountnumberrequired

Number of analysed episodes containing guests, independent of the role filter on the returned people.

mostRecentEpisodeDatedaterequirednullable
oldestEpisodeDatedaterequirednullable
guestsarray of objectrequired6 fields
namestringrequired
typeenumrequired
hostguestunknownmentioned
imageUrlstringrequirednullable
appearancesCountnumberrequiredmin 1
reviewsobjectrequirednullable8 fields
podcastIdstringrequired
appleIdnumberrequired
spotifyIdstringrequirednullable
applePodcastsReviewobjectrequirednullable10 fields
appleIdnumberrequired
scrapedAtdaterequired
countrystringrequired
reviewsCountnumberrequired
ratingnumberrequirednullable
oneStarCountnumberrequired
twoStarCountnumberrequired
threeStarCountnumberrequired
fourStarCountnumberrequired
fiveStarCountnumberrequired
applePodcastsReviewsByCountryarray of objectrequired10 fields
appleIdnumberrequired
scrapedAtdaterequired
countrystringrequired
reviewsCountnumberrequired
ratingnumberrequirednullable
oneStarCountnumberrequired
twoStarCountnumberrequired
threeStarCountnumberrequired
fourStarCountnumberrequired
fiveStarCountnumberrequired
applePodcastsReviewTextobjectrequirednullable5 fields
countrystringrequirednullable
totalnumberrequired
limitnumberrequired
offsetnumberrequired
reviewsarray of objectrequired6 fields
countrystringrequired
ratingnumberrequired
titlestringrequired
bodystringrequired
authorstringrequired
reviewedAtdaterequired
spotifyReviewobjectrequirednullable4 fields
spotifyIdstringrequired
scrapedAtdaterequired
reviewsCountnumberrequired
ratingnumberrequirednullable
castboxobjectrequirednullable3 fields
scrapedAtdaterequired
playsnumberrequired
subscribersnumberrequired
socialMediaobjectrequirednullable8 fields
podcastIdstringrequired
facebookPageDataarray of objectrequired9 fields
facebookPageIdstringrequired
profilePhotoUrlstringrequirednullable
namestringrequired
followersnumberrequiredmin 0
likesnumberrequiredmin 0
followingnumberrequiredmin 0
talkingAboutCountnumberrequirednullable
facebookPageUrlstringrequired
scrapedAtdaterequired
instagramDataarray of objectrequired7 fields
profileIdnumberrequired
followersnumberrequired
followingnumberrequired
postsnumberrequired
instagramProfileNamestringrequired
profilePhotoUrlstringrequirednullable
scrapedAtdaterequired
linkedInCompanyDataarray of objectrequired13 fields
scrapedAtdaterequired
linkedInCompanyIdstringrequired
linkedInUrlstringrequired
namestringrequired
countryCodestringrequirednullable
followersnumberrequirednullable
employeesInLinkedinnumberrequired
aboutstringrequirednullable
descriptionstringrequirednullable
companySizestringrequirednullable
industriesstringrequirednullable
logoImageUrlstringrequirednullable
mostRecentUpdateobjectrequirednullable7 fields
postIdstringrequired
likesCountnumberrequired
commentsCountnumberrequired
titlestringrequired
textstringrequired
postUrlstringrequired
datedaterequired
linkedInPersonDataarray of objectrequired14 fields
scrapedAtdaterequired
namestringrequired
profilePhotoUrlstringrequirednullable
linkedInProfileIdstringrequired
linkedInNumericIdnumberrequired
avatarUrlstringrequirednullable
citystringrequirednullable
countryCodestringrequirednullable
descriptionstringrequirednullable
aboutstringrequirednullable
locationstringrequirednullable
followerCountnumberrequired
connectionsCountnumberrequired
recommendationsCountnumberrequired
tiktokDataarray of objectrequired16 fields
accountIdstringrequired
awgEngagementRatenumberrequirednullable
biographystringrequirednullable
commentEngagementRatenumberrequirednullable
dateJoineddaterequired
followersnumberrequired
followingnumberrequired
isPrivatebooleanrequired
isVerifiedbooleanrequired
likeEngagementRatenumberrequirednullable
likesnumberrequired
nicknamestringrequired
handlestringrequired
profilePicUrlstringrequirednullableurl
videosCountnumberrequired
scrapedAtdaterequired
twitterDataarray of objectrequired10 fields
profileIdstringrequired
profileNamestringrequired
profileUrlstringrequiredurl
profileImageUrlstringrequirednullableurl
biographystringrequirednullable
followingCountnumberrequiredmin 0
followerCountnumberrequiredmin 0
postsCountnumberrequiredmin 0
dateJoineddaterequirednullable
scrapedAtdaterequired
sponsorsobjectrequirednullable5 fields
episodesCountnumberrequired
mostRecentEpisodeDatedaterequirednullable
oldestEpisodeDatedaterequirednullable
sponsorsarray of objectrequired5 fields
namestringrequired
imageUrlstringrequirednullable
appearancesCountnumberrequiredmin 1
relatedPodcastsobjectrequirednullable2 fields
podcastIdstringrequired
similarPodcastsarray of objectrequired10 fields
authorstringrequirednullable
authorityScoreobjectrequirednullable6 fields
calculatedAtdaterequired
authorityScorenumberrequired

This is the weighted total authority score of the podcast, out of 100

qualityScorenumberrequired

This is the quality score of the podcast, out of 100

youtubeScorenumberrequired

This is the YouTube score of the podcast, out of 100

socialScorenumberrequired

This is the social score of the podcast, out of 100

engagementScorenumberrequired

This is the engagement score of the podcast, out of 100

genresarray of stringrequired
idstringrequired
imageUrlstringrequirednullable
languagestringrequired
slugstringrequired
titlestringrequired
titleLateststringrequired
chartPositionsarray of objectrequirednullable5 fields
chartDatestringrequiredregex

The date of the chart in YYYY-MM-DD format

chartTypeenumrequired

The type of chart, one of apple, spotify

applespotify
countrystringrequired

The country of the chart in ISO 3166-1 alpha-2 format, for example "us". Defaults to us.

categorystringrequired

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"

positionnumberrequired
youtubeDataobjectrequirednullable2 fields
podcastIdstringrequired
youtubeDataarray of objectrequired22 fields
idstringrequired
titlestringrequired
descriptionstringrequirednullable
subscriberCountnumberrequired
viewCountnumberrequired
videoCountnumberrequired
publishedAtdaterequirednullable
thumbnailsobjectrequired3 fields
defaultstringrequirednullable
mediumstringrequirednullable
highstringrequirednullable
countrystringrequirednullable
customUrlstringrequirednullable
isPodcastChannelbooleanrequirednullable
discoverInputKeywordstringrequirednullable
bannerImageUrlstringrequirednullable
videosarray of objectrequirednullable11 fields
imageUrlstringrequired
isShortbooleanrequired
postedAtdaterequired
postedAtRelativestringrequired
scrapedAtdaterequired
titlestringrequired
videoUrlstringrequired
viewsnumberrequired
durationSecondsnumbernullable
durationCheckedAtdatenullable
episodeobjectnullable3 fields
idstringrequired
slugstringrequired
titlestringrequired
profileImageUrlstringrequirednullable
dataLastUpdateddaterequired
lastVideoUploadDatedaterequirednullable
lastVideoUploadDateSourcestringrequirednullable
lastVideoUploadDateCheckedAtdaterequirednullable
associationTierenumnullable
associatedcandidateunverified
statsHistoryarray of object2 fields
recordedAtdaterequired
subscriberCountnumberrequired