Skip to main content

Filtering, Sorting, and Searching Podcasts

One of the main queries you might use is our podcasts query which allows you to search, filter, and sort the podcasts in Podchaser.

If you haven't already, you will need to get your authorization token which you can get by following our "Your First Podchaser Query" guide.

Exploring the Podcasts Query

In order to get podcasts, you can use our podcasts query. An example query for this would look like this:

POST https://api.podchaser.com/graphql
query {
podcasts {
paginatorInfo {
count,
currentPage,
firstItem,
hasMorePages,
lastItem,
lastPage,
perPage,
total
},
data {
title,
description
}
}
}

Like most of our paginated queries, it returns a list object (for this query, it's the PodcastList object). The list object has two main parts: the paginatorInfo (which includes information about the number of results and pages) and the data field which contains the results.

Applying a Podcast Filter

You can filter all of the podcasts in Podchaser using any of the PodcastFilters. Some ways you can filter the podcasts include by Podchaser rating, categories, and Power Score.

For example, if we wanted to use the rating filter to only get podcasts that have a Podchaser rating of 4+ stars, we would apply the filter like in this example:

POST https://api.podchaser.com/graphql
query {
podcasts(filters: {rating: {minRating: 4, maxRating: 5}}) {
paginatorInfo {
currentPage,
hasMorePages,
lastPage,
},
data {
title,
description
}
}
}

This query will have this reponse (though shortened here for brevity):

{
"data": {
"podcasts": {
"paginatorInfo": {
"currentPage": 0,
"hasMorePages": true,
"lastPage": 7500
},
"data": [
{
"title": "The Joe Rogan Experience",
"description": "The official podcast of comedian Joe Rogan. Follow The Joe Rogan Clips show page for some of the best moments from the episodes."
},
{
"title": "This American Life",
"description": "This American Life is a weekly public radio show, heard by 2.2 million people on more than 500 stations. Another 2.5 million people download the weekly podcast. It is hosted by Ira Glass, produced in collaboration with Chicago Public Media, delivered to stations by PRX The Public Radio Exchange, and has won all of the major broadcasting awards."
},
{
"title": "TED Talks Daily",
"description": "Every weekday, TED Talks Daily brings you the latest talks in audio. Join host and journalist Elise Hu for thought-provoking ideas on every subject imaginable — from Artificial Intelligence to Zoology, and everything in between — given by the world's leading thinkers and creators. With TED Talks Daily, find some space in your day to change your perspectives, ignite your curiosity, and learn something new."
},
...other podcasts...
]
}
}
}

Sorting the Results

You can also sort the podcast results by a variety of criteria using PodcastSort. Some ways you can sort the podcasts include alphabetical, follower count, and Power Score.

For example, if we want to sort the podcasts by follower count, we would add the sort argument:

POST https://api.podchaser.com/graphql
query {
podcasts(filters: {rating: {minRating: 4, maxRating: 5}}, sort: {sortBy: FOLLOWER_COUNT, direction: DESCENDING}) {
paginatorInfo {
currentPage,
hasMorePages,
lastPage,
},
data {
title,
description
}
}
}

This query will have this reponse (though shortened here for brevity):

{
"data": {
"podcasts": {
"paginatorInfo": {
"currentPage": 0,
"hasMorePages": true,
"lastPage": 7500
},
"data": [
{
"title": "The Joe Rogan Experience",
"description": "The official podcast of comedian Joe Rogan. Follow The Joe Rogan Clips show page for some of the best moments from the episodes."
},
{
"title": "This American Life",
"description": "This American Life is a weekly public radio show, heard by 2.2 million people on more than 500 stations. Another 2.5 million people download the weekly podcast. It is hosted by Ira Glass, produced in collaboration with Chicago Public Media, delivered to stations by PRX The Public Radio Exchange, and has won all of the major broadcasting awards."
},
{
"title": "The Daily",
"description": "This is what the news should sound like. The biggest stories of our time, told by the best journalists in the world. Hosted by Michael Barbaro. Twenty minutes a day, five days a week, ready by 6 a.m."
},
{
"title": "Reply All",
"description": "\"'A podcast about the internet' that is actually an unfailingly original exploration of modern life and how to survive it.\" - The Guardian. Hosted by Alex Goldman and Emmanuel Dzotsi from Gimlet."
}
...other podcasts...
]
}
}
}

Searching for Podcasts

Using the searchTerm argument, you can search for a specific podcast or a podcast about certain topics.

Searching for a Specific Podcast

If we wanted to search for "Reply All" we can use this query:

POST https://api.podchaser.com/graphql
query {
podcasts(searchTerm: "Reply All") {
paginatorInfo {
currentPage,
hasMorePages,
lastPage,
},
data {
id,
title,
description,
webUrl,
}
}
}

If you are searching by the title of the podcast, it is usually within the top few results. Since many podcasts can have the same title, you may want to check the results to ensure you are using the correct one.

This query will have this reponse (though shortened here for brevity):

{
"data": {
"podcasts": {
"paginatorInfo": {
"currentPage": 0,
"hasMorePages": true,
"lastPage": 92284
},
"data": [
{
"id": "161183",
"title": "Reply All",
"description": "\"'A podcast about the internet' that is actually an unfailingly original exploration of modern life and how to survive it.\" - The Guardian. Hosted by Alex Goldman and Emmanuel Dzotsi from Gimlet.",
"webUrl": "http://gimletmedia.com/shows/reply-all"
},
{
"id": "724785",
"title": "ReplyAll",
"description": "The ReplyAll podcast follows ReplyAll Founder, Zach Abramowitz, as he meets with fellow tech entrepreneurs. Taking the ReplyAll conversations he's been publishing, and delivering them in a more audial format.",
"webUrl": "https://anchor.fm/zach-abramowitz"
}
...other podcasts...
]
}
}
}

Searching for Different Topics

Sometimes, you may want to discover podcasts about a topic. For example, you could find podcasts that have "Marketing" in their title, description, or other fields. For these queries, you may want to apply a filter, such as ratings or Power Score, or use a sort to find the best podcasts or most recent podcasts within the topic.

An example query could be:

POST https://api.podchaser.com/graphql
query {
podcasts(searchTerm: "Marketing", filters: {rating: {minRating: 4, maxRating: 5}}, sort: {sortBy: POWER_SCORE, direction: DESCENDING}) {
paginatorInfo {
currentPage,
hasMorePages,
lastPage,
},
data {
id,
title,
description,
webUrl,
}
}
}

This query will have this reponse (though shortened here for brevity):

{
"data": {
"podcasts": {
"paginatorInfo": {
"currentPage": 0,
"hasMorePages": true,
"lastPage": 305
},
"data": [
{
"id": "112956",
"title": "The GaryVee Audio Experience",
"description": "Welcome to The Garyvee Audio Experience, hosted by entrepreneur, CEO, investor, vlogger, and public speaker Gary Vaynerchuk. On this podcast you'll find a mix of my #AskGaryVee show episodes, keynote speeches on marketing and business, segments from my WEEKLYVEE video series, interviews and fireside chats I've given, as well as new and current thoughts I record originally for this audio experience!",
"webUrl": "http://www.garyvaynerchuk.com"
},
{
"id": "591485",
"title": "The Marketing Secrets Show",
"description": "Welcome to the Marketing Secrets podcast!\n\nThis show is for entrepreneurs and business owners who want to learn how to market in a way that lets us get our message, our products, and our services, out to the world… and yet still remain profitable.  \n\nLearn from Russell Brunson, the world-famous internet marketer and a co-founder of the largest funnel creation software ClickFunnels. \n\nInside each episode, Russell shares his biggest “a-ha moments” and marketing secrets with complete transparency. From tough lessons learned, to mindset, to pure marketing strategy, Russell pulls you into his world and shares his personal journey and secrets to growing a business from $0 to $100,000,000 in just 3 years, with NO outside capital!",
"webUrl": "https://marketingsecrets.com"
}
...other podcasts...
]
}
}
}

Searching Using Boolean Search Parameters

You can use boolean search parameters inside of your searchTerm phrase. In order to use boolean search parameters, you must set the boolSearch flag to true in the options argument. Podchaser currently supports +, | and - parameters, for AND, OR and NOT queries, respectively.

For example, if we wanted to perform a search for "Sports" and "hall of fame", but exclude results for "Soccer" or "Football" in the title and description, we can use this query:

POST https://api.podchaser.com/graphql
query {
podcasts(options: {boolSearch: true}, searchTerm: "Sports -(Soccer|Football) +(hall of fame)") {
paginatorInfo {
currentPage,
hasMorePages,
lastPage,
},
data {
id,
title,
description,
webUrl,
}
}
}

This query will have this reponse (though shortened here for brevity):

{
"data": {
"podcasts": {
"paginatorInfo": {
"currentPage": 0,
"hasMorePages": true,
"lastPage": 6
},
"data": [
{
"id": "3965936",
"title": "Hall of Fame Sports's show",
"description": "",
"webUrl": "https://www.spreaker.com/show/hall-of-fame-sportss-show"
},
{
"id": "2099776",
"title": "Philadelphia Sports Hall of Fame Radio",
"description": "The podcast of the Philadelphia Sports Hall of Fame. Bringing the listener the great stories from the legends of Philadelphia sports.",
"webUrl": "www.phillyhall.org"
},
{
"id": "4643411",
"title": "Hall Of Fame For Fantasy Sports",
"description": "Podcast about hall of fame inductees for fantasy sports.",
"webUrl": "https://anchor.fm/louis-patel0"
}
]
}
}
}