Skip to main content

EpisodeFilters

Filters that can be applied to a episodes query.

type EpisodeFilters {
  airDate: [DateRangeInput]
  length: [RangeInput]
  modifiedDate: DateRangeInput
  podcastPowerScore: [RangeInput]
  isExplicit: [Boolean]
  sponsoredBy: [String]
  episodeType: [EpisodeType]
  categories: CategoriesFilter
  brandSafety: BrandSafetyFilter
  hasTranscripts: Boolean
  hasRankedPodcastPermission: Boolean
  podcastLanguage: String
  addedDate: DateRangeInput
  transcriptCreationDate: DateRangeInput
}

Fields​

airDate ([DateRangeInput])​

Filter by when the episode aired, according to its publisher.

length ([RangeInput])​

Filter by how long an episode is, in seconds.

modifiedDate (DateRangeInput)​

Filter by the date that any of the data within Podchaser was updated for an episode.

podcastPowerScore ([RangeInput])​

Filter by the podcast's PowerScore.

isExplicit ([Boolean])​

Filter by whether the episode has been marked as explicit by the publisher.

sponsoredBy ([String])​

Filter by which brands have sponsored each episode. Use the brand's 'code'. For searching for a brand's code, use the brands query.

episodeType ([EpisodeType])​

Filter by the episodes' type. These can be full, bonus, or trailer episodes.

categories (CategoriesFilter)​

Filter by the Podchaser categories attached to the episode's podcast. Must search using the 'slug' of the category.

brandSafety (BrandSafetyFilter)​

Filter out (exclude) episodes based on the episode's brand safety risk assessments.

hasTranscripts (Boolean)​

Filter for episodes that have at least one transcript available.

hasRankedPodcastPermission (Boolean)​

Filter for episodes where the episode's podcast is within the client's podcast ranking or country access permission level. Requires our plus or pro plans.

podcastLanguage (String)​

Filter by what the podcast's feed states is the language of the podcast. Expected in 2-character language code, such as en or es.

addedDate (DateRangeInput)​

Filter by the date that an episode was added to the Podchaser database

transcriptCreationDate (DateRangeInput)​

Filter by the date that an episode's transcript was most recently created.