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!
  imageUrl: Url
  audioUrl: Url
  url: 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]
  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

imageUrl (Url)​

The episode specific artwork

audioUrl (Url)​

The URL of the episode audio

url (Url)​

The URL of the episode on Podchaser

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.

estimatedReach (Int)​

(Deprecated: use 'audienceReach')

EXPERIMENTAL BETA - the estimated number of listeners of this episode

Only available with certain permissions.

audienceReach (IntegerRange)​

The number of listeners of this 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.