Podcast

The podcast object and all of its attributes.

type Podcast {
id: ID!
title: String!
description: String
sanitizedDescription: String
htmlDescription: String
url: Url
webUrl: Url
rssUrl: String
imageUrl: Url
language: String
modifiedDate: DateTime
numberOfEpisodes: Int
avgEpisodeLength: Int
startDate: DateTime
socialLinks: PodcastSocialLinks
categories: [Category]
feeds: [Feed!]
userRating: Rating
userReview: Review
ratingCount: Int
ratingAverage: Float
ratingSummary: [RatingSummary]
reviewCount: Int
applePodcastsId: String
itunesID: String
author: EmailContact
itunesAuthor: EmailContact
powerScore: Float
audienceEstimate: Float
contacts: [Contact]
demographics: PodcastDemographics
episodes(
filters: EpisodeFilters
first: Int = 10
page: Int = 0
searchTerm: String
sort: EpisodeSort
): EpisodeList
credits(
filters: CreditFilters
first: Int = 10
page: Int = 0
searchTerm: String
sort: Sort
): PodcastCreditList
lists(
filters: ListFilters
first: Int = 10
page: Int = 0
searchTerm: String
sort: ListSort
): ListList
ratings(
filters: RatingFilters
first: Int = 10
page: Int = 0
searchTerm: String
sort: RatingSort
): RatingList
reviews(
filters: ReviewFilters
first: Int = 10
page: Int = 0
searchTerm: String
sort: ReviewSort
): ReviewList
similarPodcasts(
first: Int = 10
page: Int = 0
searchTerm: String
sort: Sort
): PodcastList
charts(
platform: ChartPlatform!
day: Date!
category: String
country: String
sort: [PodcastChartsSortOrderByClause!] = []
first: Int = 10
page: Int = 0
): ChartPositionPaginator
}

Fields

id (ID!)

Podchaser's internal podcast ID.

title (String!)

The title of the podcast as specified in the RSS feed or podcast platform.

description (String)

A string only representation of the podcast description.

sanitizedDescription (String)

(Deprecated: use 'htmlDescription')

A processed version of the podcast description including sanitized HTML.

htmlDescription (String)

A processed version of the podcast description including sanitized HTML.

url (Url)

The URL for the podcast on Podchaser.

webUrl (Url)

The homepage for the podcast as specified in the RSS feed.

rssUrl (String)

The URL of the primary RSS feed for the podcast. This may be null if the podcast source is Spotify or another service.

imageUrl (Url)

The podcast artwork URL as specified in the RSS feed or podcast platform.

language (String)

The spoken language of the podcast in standard IETF format.

modifiedDate (DateTime)

When the podcast entity was last updated within Podchaser.

numberOfEpisodes (Int)

The total number of episodes this podcast has.

avgEpisodeLength (Int)

The average length, in seconds, for this podcast's episodes.

startDate (DateTime)

When the podcast's first episode aired.

socialLinks (PodcastSocialLinks)

The social media handles for the podcast.

categories ([Category])

All of the Podchaser categories of the podcast.

feeds ([Feed!])

The known feeds for this podcast - this may include feeds from other services and previous inactive RSS feed URLs

userRating (Rating)

The existing rating for the authenticated user

Only available with certain permissions.

userReview (Review)

The existing review for the authenticated user

Only available with certain permissions.

ratingCount (Int)

ratingAverage (Float)

The raw un-weighted average of all ratings for this podcast

ratingSummary ([RatingSummary])

A summary of how many ratings per star rating for this podcast

Only available with certain permissions.

reviewCount (Int)

applePodcastsId (String)

The Apple Podcast ID (formerly iTunes ID). This field is either added when the podcast is submitted to Podchaser or Podchaser retrieves this ID after the podcast is approved by moderation team.

itunesID (String)

(Deprecated: use 'applePodcastsId')

author (EmailContact)

The author of the podcast as defined in the RSS feed.

itunesAuthor (EmailContact)

(Deprecated: use 'author')

The author of the podcast as defined in the RSS feed.

powerScore (Float)

The podcast's PowerScore, which is Podchaser's unique attribute that represents how popular and influential a podcast is. Calculated using a proprietary algorithm which uses dozens of different factors, such as reach and subcribers. Requires Plus or Pro API access.

Only available with certain permissions.

audienceEstimate (Float)

The estimated monthly listens the podcast receives. Requires Plus or Pro API access.

Only available with certain permissions.

contacts ([Contact])

A list of contact information for people related to the podcast. Requires Plus or Pro API access.

Only available with certain permissions.

demographics (PodcastDemographics)

An aggregation of the demographics of the podcast's audience.

Only available with certain permissions.

episodes (EpisodeList)

All the podcast's episodes.

Limits number of fetched elements. Maximum allowed value: 100.

The offset from which elements are returned.

A search term to filter on.

How to sort the results

credits (PodcastCreditList)

Only available with certain permissions.

Limits number of fetched elements. Maximum allowed value: 100.

The offset from which elements are returned.

A search term to filter on.

How to sort the results

lists (ListList)

Limits number of fetched elements. Maximum allowed value: 100.

The offset from which elements are returned.

A search term to filter on.

How to sort the results

ratings (RatingList)

Ratings for this podcast by all users

Only available with certain permissions.

Limits number of fetched elements. Maximum allowed value: 100.

The offset from which elements are returned.

A search term to filter on.

How to sort the results

reviews (ReviewList)

Reviews for this podcast by all users

Only available with certain permissions.

Limits number of fetched elements. Maximum allowed value: 100.

The offset from which elements are returned.

A search term to filter on.

How to sort the results

similarPodcasts (PodcastList)

A list of podcasts that are similar to the podcast. Requires Plus or Pro API access.

Only available with certain permissions.

Limits number of fetched elements. Maximum allowed value: 100.

The offset from which elements are returned.

A search term to filter on.

How to sort the results

charts (ChartPositionPaginator)

The chart rankings of the podcast on Apple Podcasts and Spotify

Only available with certain permissions.

Limits number of fetched items. Maximum allowed value: 100.

The offset from which elements are returned.