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]
transcripts: [Transcript]
estimatedReach: Int
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.

transcripts ([Transcript])

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

Only available with certain permissions.

estimatedReach (Int)

EXPERIMENTAL BETA - the estimated number of listeners of this episode

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.