Skip to main content

Episode

The episode object and all of its attributes.

type Episode {
  id: ID!
  title: String!
  description: String
  htmlDescription: String
  airDate: DateTime!
  addedDate: DateTime!
  imageUrl: Url
  audioUrl: Url
  url: Url
  webUrl: Url
  fileSize: Int
  guid: String
  length: Int
  explicit: Boolean!
  episodeType: String!
  modifiedDate: DateTime
  podcast: Podcast!
  ratingCount: Int
  reviewCount: Int
  userRating: Rating
  userReview: Review
  ratingAverage: Float
  ratingSummary: [RatingSummary]
  brandSafety: [BrandSafety]
  transcripts: [Transcript]
  podcastEstimatedReach: Int
  estimatedReach: Int
  audienceReach: IntegerRange
  ratings(
    filters: RatingFilters
    first: Int = 10
    page: Int = 0
    searchTerm: String
    sort: RatingSort
    paginationType: PaginationType
    cursor: String
  ): RatingList
  reviews(
    filters: ReviewFilters
    first: Int = 10
    page: Int = 0
    searchTerm: String
    sort: ReviewSort
    paginationType: PaginationType
    cursor: String
  ): ReviewList
  credits(
    filters: CreditFilters
    first: Int = 10
    page: Int = 0
    searchTerm: String
    sort: Sort
    paginationType: PaginationType
    cursor: String
  ): EpisodeCreditList
  lists(
    filters: ListFilters
    first: Int = 10
    page: Int = 0
    searchTerm: String
    sort: ListSort
    paginationType: PaginationType
    cursor: String
  ): ListList
  sponsors(first: Int = 10, page: Int = 0): EpisodeSponsorPaginator
}

Fields​

id (ID!)​

Podchaser's internal episode ID.

title (String!)​

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

description (String)​

A string only representation of the episode description

htmlDescription (String)​

A processed version of the podcast description including sanitized HTML

airDate (DateTime!)​

The publish date of the episode as specified by the publisher

addedDate (DateTime!)​

The date this episode was added to the Podchaser database

imageUrl (Url)​

The episode specific artwork

audioUrl (Url)​

The URL of the episode audio

url (Url)​

The URL of the episode on Podchaser

webUrl (Url)​

The Web URL for the episode as specified in the RSS feed.

fileSize (Int)​

The file size of the audio file as specified by the publisher

guid (String)​

The unique identifier of this episode within the context of the podcast

length (Int)​

The length of the audio in seconds

explicit (Boolean!)​

Whether or not this episode has been marked as explicit by the publisher

episodeType (String!)​

The type of episode. These can be either full, bonus or trailer episodes

modifiedDate (DateTime)​

When the episode entity was last updated within Podchaser.

podcast (Podcast!)​

ratingCount (Int)​

reviewCount (Int)​

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.

ratingAverage (Float)​

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

ratingSummary ([RatingSummary])​

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

Only available with certain permissions.

brandSafety ([BrandSafety])​

Brand safety risk assessments for this episode.

Only available with certain permissions.

transcripts ([Transcript])​

BETA - The Episode's transcripts, if we have any

Only available with certain permissions.

podcastEstimatedReach (Int)​

The estimated reach for this episode from podcast-level data. Will return null when we do not have enough data yet for the episode. Requires our plus or pro plans.

Only available with certain permissions.

estimatedReach (Int)​

(Deprecated: use 'audienceReach')

EXPERIMENTAL BETA - the estimated number of listeners of this episode. Will return null when we do not have enough data yet for the episode.

Only available with certain permissions.

audienceReach (IntegerRange)​

The number of listeners of this episode. Will return null when we do not have enough data yet for the episode. Requires our plus or pro plans.

Only available with certain permissions.

ratings (RatingList)​

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

Which type of pagination to use

The cursor from which to retrieve the next page of results

reviews (ReviewList)​

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

Which type of pagination to use

The cursor from which to retrieve the next page of results

credits (EpisodeCreditList)​

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

Which type of pagination to use

The cursor from which to retrieve the next page of results

lists (ListList)​

The lists created by Podchaser users that include this episode.

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

Which type of pagination to use

The cursor from which to retrieve the next page of results

sponsors (EpisodeSponsorPaginator)​

A list of brands which sponsor this episode, and related meta-data

Only available with certain permissions.

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

The offset from which items are returned.