Get the most popular podcasts

Use getPopularContent to get details on the most popular podcasts. Moreover, you can filter by language or genre.

Example

To get the most popular podcasts in English:


{
  getPopularContent(filterByLanguage:ENGLISH){
    popularityRankId
    podcastSeries{
      uuid
      name
      description
      popularityRank
    }
  }
}

To get the most popular podcasts in the Business genre.

Note: filterByGenres takes an array of genres so that you can use multiple genres and subgenres. Please see Genre for a full list of possible genres.


{
  getPopularContent(filterByLanguage:ENGLISH, filterByGenres:[PODCASTSERIES_BUSINESS, PODCASTSERIES_NEWS_BUSINESS, PODCASTSERIES_BUSINESS_CAREERS, PODCASTSERIES_BUSINESS_INVESTING, PODCASTSERIES_BUSINESS_MARKETING, PODCASTSERIES_BUSINESS_MANAGEMENT, PODCASTSERIES_BUSINESS_NON_PROFIT, PODCASTSERIES_BUSINESS_ENTREPRENEURSHIP]){
    popularityRankId
    podcastSeries{
      uuid
      name
      description
      popularityRank
    }
  }
}

Query Input:

For getPopularContent, you can get back a list of podcasts with the following input:


" (Optional) Allows for filtering by language. "
filterByLanguage: Language

" (Optional) Allows for filtering by genres. "
filterByGenres: [Genre!]

" (Optional) Allows for pagination. Default is 1 (ie: page 1 of the results). Max value is 20. "
page: Int

" (Optional) The number of results per page. Default is 10. Max value is 25 (ie: that max results you can return in one query in 25) "
limitPerPage: Int

Query Response:

The response you get back includes an array of PodcastSeries .


" Identifier for the popularity query being sent (Used for caching) "
popularityRankId: ID!

" A list of PodcastSeries items "
podcastSeries: [PodcastSeries]

Referenced types in this document:

PodcastSeriesTranscriptionStatus

👋

If you are new to using Taddy’s API, Get Started with our 🤖 Intro to Taddy’s API.