Podcast All Details

GET /podcasts/::podcastIdOrSlug/all-details

This wraps all the other endpoints for a podcast so you can get all the details in a single request.

TOKEN

Authentication

This endpoint requires an API token. You can learn more about how to get an API token from the authentication page.

URL

https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/all-details

Code Example

API Specification

Path Parameters

PropertyTypeDescription
podcastIdOrSlug
string

Podengine ID, Apple ID, or slug

200

Success Response

PropertyTypeDescription
status
literal: OK

data
object

podcast
object

podcast
object

authornullable
string

authorityScorenullable
object

calculatedAt
date

authorityScore
number

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

qualityScore
number

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

youtubeScore
number

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

socialScore
number

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

engagementScore
number

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

genres
array
of
string

id
string

imageUrlnullable
string

language
string

lastEpisodePublishedAt
date

slug
string

title
string

titleLatest
string

appleId
number

blockedoptional
object

blockedDate
date

blockedReasonoptional
string

descriptionnullable
string

emails
array
of
string

explicitRssnullable
boolean

hostNamesnullable
array
of
string

ignore
boolean

ignoreReasonoptional
string

neverTranscribeoptional
boolean

neverTranscribeReasonoptional
string

isClaimed
boolean

podcastAffiliationnullable
object

affiliateOrganizationNameoptionalnullable
string

The name of the affiliate organization

affiliationTypeoptionalnullable
enum ⓘ

Allowed values

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown

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

podcastDirectoryLinks
object

amazonmusicoptional
string ⓘ

Constraints:

url

anchoroptional
string ⓘ

Constraints:

url

antennapodoptional
string ⓘ

Constraints:

url

anytimeplayeroptional
string ⓘ

Constraints:

url

apollooptional
string ⓘ

Constraints:

url

appleoptional
string ⓘ

Constraints:

url

audibleoptional
string ⓘ

Constraints:

url

breezoptional
string ⓘ

Constraints:

url

castamaticoptional
string ⓘ

Constraints:

url

castboxoptional
string ⓘ

Constraints:

url

castrooptional
string ⓘ

Constraints:

url

curiocasteroptional
string ⓘ

Constraints:

url

fountainoptional
string ⓘ

Constraints:

url

goodpodsoptional
string ⓘ

Constraints:

url

googleoptional
string ⓘ

Constraints:

url

gpodderoptional
string ⓘ

Constraints:

url

iheartradiooptional
string ⓘ

Constraints:

url

listennotesoptional
string ⓘ

Constraints:

url

lnbeatsoptional
string ⓘ

Constraints:

url

moonfmoptional
string ⓘ

Constraints:

url

overcastoptional
string ⓘ

Constraints:

url

playerfmoptional
string ⓘ

Constraints:

url

pocketcastsoptional
string ⓘ

Constraints:

url

podbeanoptional
string ⓘ

Constraints:

url

podcastaddictoptional
string ⓘ

Constraints:

url

podcastguruoptional
string ⓘ

Constraints:

url

podcastrepublicoptional
string ⓘ

Constraints:

url

podchaseroptional
string ⓘ

Constraints:

url

podfriendoptional
string ⓘ

Constraints:

url

podknifeoptional
string ⓘ

Constraints:

url

podlpoptional
string ⓘ

Constraints:

url

podnewsoptional
string ⓘ

Constraints:

url

podscanoptional
string ⓘ

Constraints:

url

podscribeoptional
string ⓘ

Constraints:

url

podstationoptional
string ⓘ

Constraints:

url

poduramaoptional
string ⓘ

Constraints:

url

podverseoptional
string ⓘ

Constraints:

url

radiopublicoptional
string ⓘ

Constraints:

url

rephonicoptional
string ⓘ

Constraints:

url

sonnetoptional
string ⓘ

Constraints:

url

spotifyoptional
string ⓘ

Constraints:

url

stenofmoptional
string ⓘ

Constraints:

url

truefansoptional
string ⓘ

Constraints:

url

tuneinoptional
string ⓘ

Constraints:

url

youtubemusicoptional
string ⓘ

Constraints:

url

podcastHasGuestsnullable
boolean

podcastHasSponsorsnullable
boolean

podcastLocationsnullable
array
of
string

primaryContactEmailnullable
string

rssFeedUrl
string

socialMediaLinks
array
of
object

socialMediaType
enum ⓘ

Allowed values

beehiivbehanceblueskydiscordfacebookgithubinstagramlinkedinlinktreemastodonmediumpatreonpinterestredditsnapchatsoundcloudsubstackthreadstiktoktumblrtwitchtwittervimeowhatsappyoutube

url
string ⓘ

Constraints:

url

sources
array
of
enum ⓘ

Allowed values

apple-podcastsbright-data-datasetgoogle-searchlinktreepodcast-websitepodchaserrephonicrss

spotifyIdnullable
string

stats
object

downloadCount
number

episodeCount
number

latestPublishedAtnullable
date

firstEpisodePublishedAtnullable
date

transcriptsCount
number

updateFrequency
enum ⓘ

Allowed values

dailyweeklybi-weeklymonthlystalevery-stale

titleLatestCleanednullable
string

transcriptionMode
union

websiteUrlnullable
string

audienceEstimateoptional
object

audienceDemographicsnullable
object

ageRange
enum ⓘ

Allowed values

Under 1818-2425-3435-4445-5455+

The age range of the audience as a string.

genderSkew
enum ⓘ

Allowed values

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%

How the audience is skewed in terms of gender.

educationLevel
enum ⓘ

Allowed values

No High SchoolHigh SchoolSome CollegeBachelors DegreeMasters DegreeDoctorate

The probable education levels of the audience.

incomeLevel
enum ⓘ

Allowed values

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

The probable income levels of the audience.

exampleListenerProfile
string

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

estimatedMonthlyListenersnullable
number

estimatedMonthyListenersCalculatedAtnullable
date

audioRetentionPolicyoptional
enum ⓘ

Allowed values

RETAIN_INDEFINITELYRETAIN_DAYSRETAIN_UNTIL_TRANSCRIBED

audioRetentionDaysoptionalnullable
number

recentEpisodesnullable
array
of
object

deepAnalysisRequestedAtnullable
date

descriptionnullable
string

durationSecondsnullable
number

enclosureUrl
string

episodeId
string ⓘ

Constraints:

uuid

episodeGuestsAndHostsnullable
array
of
object

name
string

type
enum ⓘ

Allowed values

hostguestunknownmentioned

imageUrlnullable
string

episodeSlug
string

episodeShortDescriptionnullable
string

episodeSponsorsnullable
array
of
string

hasTranscript
boolean

imageUrlnullable
string

episodeThumbnailRssUrlnullable
string

podcastId
string ⓘ

Constraints:

uuid

podcastSlug
string

publishedAt
date

title
string

transcriptIdnullable
string ⓘ

Constraints:

uuid

transcriptionRequestedAtnullable
date

audienceEstimateoptional
object

audienceDemographicsnullable
object

ageRange
enum ⓘ

Allowed values

Under 1818-2425-3435-4445-5455+

The age range of the audience as a string.

genderSkew
enum ⓘ

Allowed values

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%

How the audience is skewed in terms of gender.

educationLevel
enum ⓘ

Allowed values

No High SchoolHigh SchoolSome CollegeBachelors DegreeMasters DegreeDoctorate

The probable education levels of the audience.

incomeLevel
enum ⓘ

Allowed values

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

The probable income levels of the audience.

exampleListenerProfile
string

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

estimatedMonthlyListenersnullable
number

estimatedMonthyListenersCalculatedAtnullable
date

youtubeEpisodeDetailsnullable
object

youtubeLink
string ⓘ

Constraints:

url

youtubeMatchConfidence
number

youtubeViewCountnullable
number

youtubeDataFetchedAtnullable
date

applePodcastsUrlnullable
string ⓘ

Constraints:

url

contactsnullable
object

podcastId
string

emails
array
of
object

email
string

The email address associated with the podcast contact

verifiedAtnullable
date

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

syntaxValidnullable
boolean

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

mxValidnullable
boolean

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

deepVerifiedAtnullable
date

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

deliverabilityStatusnullable
enum ⓘ

Allowed values

validinvalidcatch-allunknownspamtrapabusedo_not_mail

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

deliverabilityReasonnullable
string

Sub-classification providing more detail on the deliverability result

isFreeEmailProvidernullable
boolean

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

suggestedCorrectionnullable
string

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

phoneNumbers
array
of
string

websites
array
of
object

url
string

verified
boolean

contactUrls
array
of
string

guestsnullable
object

episodesCount
number

episodesWithGuestsCount
number

mostRecentEpisodeDate
date

oldestEpisodeDate
date

guests
array
of
object

name
string

type
enum ⓘ

Allowed values

hostguestunknownmentioned

imageUrlnullable
string

appearancesCount
number ⓘ

Constraints:

>= 1

mostRecentAppearanceDate
date

oldestAppearanceDate
date

reviewsnullable
object

podcastId
string

appleId
number

spotifyIdnullable
string

applePodcastsReviewnullable
object

appleId
number

scrapedAt
date

country
string

reviewsCount
number

ratingnullable
number

oneStarCount
number

twoStarCount
number

threeStarCount
number

fourStarCount
number

fiveStarCount
number

spotifyReviewnullable
object

spotifyId
string

scrapedAt
date

reviewsCount
number

ratingnullable
number

castboxnullable
object

scrapedAt
date

plays
number

subscribers
number

socialMedianullable
object

podcastId
string

socialMediaLinks
array
of
object

socialMediaType
enum ⓘ

Allowed values

beehiivbehanceblueskydiscordfacebookgithubinstagramlinkedinlinktreemastodonmediumpatreonpinterestredditsnapchatsoundcloudsubstackthreadstiktoktumblrtwitchtwittervimeowhatsappyoutube

url
string ⓘ

Constraints:

url

sources
array
of
enum ⓘ

Allowed values

apple-podcastsbright-data-datasetgoogle-searchlinktreepodcast-websitepodchaserrephonicrss

facebookPageData
array
of
object

facebookPageId
string

profilePhotoUrlnullable
string

name
string

followers
number ⓘ

Constraints:

>= 0

likes
number ⓘ

Constraints:

>= 0

following
number ⓘ

Constraints:

>= 0

talkingAboutCountnullable
number

facebookPageUrl
string

scrapedAt
date

instagramData
array
of
object

profileId
number

followers
number

following
number

posts
number

instagramProfileName
string

profilePhotoUrlnullable
string

scrapedAt
date

linkedInCompanyData
array
of
object

scrapedAt
date

linkedInCompanyId
string

linkedInUrl
string

name
string

countryCodenullable
string

followers
number

employeesInLinkedin
number

aboutnullable
string

descriptionnullable
string

companySizenullable
string

industriesnullable
string

logoImageUrlnullable
string

mostRecentUpdatenullable
object

postId
string

likesCount
number

commentsCount
number

title
string

text
string

postUrl
string

date
date

linkedInPersonData
array
of
object

scrapedAt
date

name
string

profilePhotoUrlnullable
string

linkedInProfileId
string

linkedInNumericId
number

avatarUrlnullable
string

citynullable
string

countryCodenullable
string

descriptionnullable
string

aboutnullable
string

locationnullable
string

followerCount
number

connectionsCount
number

recommendationsCount
number

tiktokData
array
of
object

accountId
string

awgEngagementRatenullable
number

biographynullable
string

commentEngagementRatenullable
number

dateJoined
date

followers
number

following
number

isPrivate
boolean

isVerified
boolean

likeEngagementRatenullable
number

likes
number

nickname
string

handle
string

profilePicUrlnullable
string ⓘ

Constraints:

url

videosCount
number

scrapedAt
date

twitterData
array
of
object

profileId
string

profileName
string

profileUrl
string ⓘ

Constraints:

url

profileImageUrlnullable
string ⓘ

Constraints:

url

biographynullable
string

followingCount
number ⓘ

Constraints:

>= 0integer

followerCount
number ⓘ

Constraints:

>= 0integer

postsCount
number ⓘ

Constraints:

>= 0integer

dateJoinednullable
date

scrapedAt
date

sponsorsnullable
object

episodesCount
number

episodesWithSponsorsCount
number

mostRecentEpisodeDate
date

oldestEpisodeDate
date

sponsors
array
of
object

name
string

imageUrlnullable
string

appearancesCount
number ⓘ

Constraints:

>= 1

mostRecentAppearanceDate
date

oldestAppearanceDate
date

relatedPodcastsnullable
object

podcastId
string

similarPodcasts
array
of
object

authornullable
string

authorityScorenullable
object

calculatedAt
date

authorityScore
number

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

qualityScore
number

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

youtubeScore
number

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

socialScore
number

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

engagementScore
number

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

genres
array
of
string

id
string

imageUrlnullable
string

language
string

lastEpisodePublishedAt
date

slug
string

title
string

titleLatest
string

chartPositionsnullable
array
of
object

chartDate
string ⓘ

Constraints:

regex

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

chartType
enum ⓘ

Allowed values

applespotify

The type of chart, one of apple, spotify

country
string

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

category
string

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"

position
number

youtubeDatanullable
object

podcastId
string

youtubeData
array
of
object

id
string

title
string

descriptionnullable
string

subscriberCount
number

viewCount
number

videoCount
number

publishedAtnullable
date

thumbnails
object

defaultnullable
string

mediumnullable
string

highnullable
string

countrynullable
string

customUrlnullable
string

linksnullable
array
of
string

isPodcastChannelnullable
boolean

discoverInputKeywordnullable
string

bannerImageUrlnullable
string

videosnullable
array
of
object

imageUrl
string

isShort
boolean

postedAt
date

postedAtRelative
string

scrapedAt
date

title
string

videoUrl
string

views
number

profileImageUrlnullable
string

dataLastUpdated
date

lastVideoUploadDatenullable
date

lastVideoUploadDateSourcenullable
string

lastVideoUploadDateCheckedAtnullable
date