Skip to main content

PodcastFilters

Filters that can be applied to a podcasts query.

type PodcastFilters {
  country: String
  language: String
  rating: RatingFilter
  categories: [String]
  modifiedDate: DateRangeInput
  powerScore: [RangeInput]
  identifiers: [PodcastIdentifier]
  dateOfFirstEpisode: DateRangeInput
  dateOfLatestEpisode: DateRangeInput
  hasGuests: [Boolean]
  includeRemoved: Boolean
  episodeAudienceEstimate: RangeInput
  brandSafety: BrandSafetyFilter
  status: [PodcastStatus]
}

Fields​

country (String)​

Filter by the top XX podcasts per country (normally up to 500 per country). Expected in 2-character country code, such as us or ca.

language (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.

rating (RatingFilter)​

Filter by the average rating given by Podchaser user's for the podcast.

categories ([String])​

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

modifiedDate (DateRangeInput)​

Filter by the date that any of the data within Podchaser was updated for a podcast.

powerScore ([RangeInput])​

Filter by the podcast's PowerScore. Requires our plus or pro plans.

identifiers ([PodcastIdentifier])​

Filter by specific podcast identifiers. Use Podchaser ID for best performance.

dateOfFirstEpisode (DateRangeInput)​

Filter by the date of the first episode released by this podcast

dateOfLatestEpisode (DateRangeInput)​

Filter by the date of the latest episode released by this podcast

hasGuests ([Boolean])​

Filter by whether the podcast is likely to have guests. True - has guests, false - unlikely to have guests.

includeRemoved (Boolean)​

By default, removed podcasts are not returned in results. Set this filter to true to include both removed and active podcasts.

episodeAudienceEstimate (RangeInput)​

Filter by the estimated number of listeners of an episode. Requires our plus or pro plans.

brandSafety (BrandSafetyFilter)​

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

status ([PodcastStatus])​

Filter by the Podcast Status