Getting Podcast Networks
You can get a single podcast network or a filtered, sorted list of networks using our API. This guide will show you how to retrieve podcast network details using GraphQL queries.
Prerequisites
If you haven't already, you will need to get your authorization token to run the example queries below. You can get it by following our "Your First Podchaser Query" guide.
Returning Network Details from Within a Podcast Object
A podcast's network is easy to retrieve alongside any additional podcast details. For example, on a podcast query, you can request the podcast's networks using the networks
field. Here's an example:
Example GraphQL Query
query {
podcast(identifier: {id: "243479", type: PODCHASER}) {
title
description
networks {
title
description
}
}
}
Example Response
This query will have a response similar to below:
{
"data": {
"podcast": {
"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 and Sabrina Tavernise. Twenty minutes a day, five days a week, ready by 6 a.m.\n\nListen to this podcast in New York Times Audio, our new iOS app for news subscribers. Download now at nytimes.com/audioapp",
"networks": [
{
"title": "New York Times",
"description": "The New York Times is powered by the idea that independent, deeply reported journalism fuels a healthy and engaged society.\n\nOur reporters, columnists, editors, engineers, designers, data analysts, developers and marketers breathe life into the most important topics of our time and tell stories that might otherwise go untold.\n\nWhether bringing new truths to light with our reporting, building innovative products that deliver a best-in-class digital experience, or analyzing data to understand how we can best serve our readers, our people power the world’s top destination for journalism.\n\nWorking at The Times means envisioning and developing the future of journalism. Bring your passion, perspective and experience and join us as we seek the truth and help people understand the world.\n\nCheck out our career opportunities (nytco.com/careers) and follow our page to connect with Times employees, journalists and readers."
}
]
}
}
}
See the Network object documentation for a list of fields that are available in your query.
Retrieving a Specific Network
A single podcast network can be retrieved using a network query. You can retrieve a network by either its Podchaser ID or by the exact title of the network. Specifying a title is case-insensitive, but must exactly match the network title. 1 See below for an example network
query:
Example GraphQL Query
query {
network(identifier: {id: "bbc", type: TITLE}) {
title
description
url
}
}
Example Response
The query above will have a response similar to below:
{
"data": {
"network": {
"title": "BBC",
"description": "The BBC is the world’s leading public service broadcaster.\n\nWe’re impartial and independent, and every day we create distinctive, world-class programmes and content which inform, educate and entertain millions of people in the UK and around the world.\n\nWe do this across:\n- A portfolio of television services, including the UK’s most-watched channel BBC One, the pioneering online youth service BBC Three, and our multi award-winning channels for children, as well as national and regional television programmes and services across England. Northern Ireland, Scotland and Wales\n- Ten UK-wide radio networks, providing the best live music broadcasting in the UK, as well as speech radio which informs, educates and entertains. We also have two national radio services each in Scotland, Wales and Northern Ireland and 39 local radio stations across England and the Channel Islands, providing an invaluable and unique service to listeners across the UK\n- Our digital services including BBC News, Sport, Weather CBBC and CBeebies, iPlayer and BBC Sounds, BBC Red Button and our vast archive\n- BBC World Service television, radio and online on more than 40 languages",
"url": "https://www.podchaser.com/networks/bbc-6"
}
}
}
1 Use a networks query with a searchTerm
in order to discover networks by a partial network title.
Retrieving a List of Podcasts from a Network
You can perform a podcasts query in combination with a networks
filter to retrieve a list of podcasts within one or more networks. See below for an example podcasts
query:
Example Podcasts GraphQL Query
query {
podcasts(
filters: {
networks: [
{
id: "Acast"
type: TITLE
}
]
}
sort: {
sortBy: ALPHABETICAL
direction: ASCENDING
}
) {
cursorInfo {
total
}
data {
title
description
networks {
title
}
}
}
}
Example Podcasts Response
The query above will have a response similar to below (though shortened here for brevity):
{
"data": {
"podcasts": {
"cursorInfo": {
"total": 120,088
},
"data": [
{
"title": "A History of Europe, Key Battles",
"description": "A podcast on European conflicts from the perspective of each side to provide an alternative to the traditional national narratives. Going chronologically from the Ancient Greeks onwards I will describe to some extent how each battle was won or lost by particular decisions, tactics, technology or fortune. But the aim of each main narrative will be to place each battle in the context of the overall history of Europe. Hosted on Acast. See acast.com/privacy for more information.",
"networks": [
{
"title": "Acast"
}
]
},
{
"title": "Big Rich Brock & Friends",
"description": "Big Rich Brock is a “Big Man” with an even bigger personality. The former pastor (25+years), now turned comedian, brings his preacher persona to the weekly podcast with his clean comedy and storytelling that is laugh out loud funny with a side of inspiration. Covering everything from growing up in the 1900’s, small town living, ministry, marriage, divorce, dating again and again, raising kids, career changes; and a behind the scenes look at pursuing comedy dreams, at the same time as he qualified for an AARP card. Big Rich is entertaining and will make you reminisce, laugh and bring a smile to your face. Hosted on Acast. See acast.com/privacy for more information.",
"networks": [
{
"title": "Acast"
}
]
},
...
]
}
}
}
You can also perform a filtered list search of podcasts when returning networks, allowing you to retrieve only networks that contain podcasts that are relevant to your search. See below See below for an example networks
query:
Example Networks GraphQL Query
query {
networks(searchTerm: "Acast") {
data {
title
description
url
podcasts(searchTerm: "History") {
data {
title
description
}
}
}
}
}
Example Networks Response
The query above will have a response similar to below (though shortened here for brevity):
{
"data": {
"networks": {
"data": [
{
"title": "Acast",
"description": "Acast is a Swedish-founded company that provides hosting, monetization and growth support for podcasts, and podcast advertising solutions for brands and media agencies.",
"url": "https://www.podchaser.com/networks/acast-145",
"podcasts": {
"data": [
{
"title": "A History of Europe, Key Battles",
"description": "A podcast on European conflicts from the perspective of each side to provide an alternative to the traditional national narratives. Going chronologically from the Ancient Greeks onwards I will describe to some extent how each battle was won or lost by particular decisions, tactics, technology or fortune. But the aim of each main narrative will be to place each battle in the context of the overall history of Europe. Hosted on Acast. See acast.com/privacy for more information."
},
{
"title": "History's greatest cities",
"description": "Travel writer and history buff Paul Bloomfield will be joining expert guides with rich local and historical knowledge. Venturing to the great cities of Europe, Africa, Asia and the Americas, they'll explore centuries-long stories of foundation and growth, and examine how contact between continents shaped these far-flung places. Along the way, they'll introduce the colourful characters who played pivotal roles in the development of these cities, and lead listeners through the must-visit palaces, temples, bazaars and, of course, bars and restaurants. And, our experts will also share insider tips to help visitors discover hidden facets of each fascinating destination.\nHistory's greatest cities is produced by the team behind BBC History Magazine."
},
{
"title": "A History of Europe, Key Battles",
"description": "A podcast on European conflicts from the perspective of each side to provide an alternative to the traditional national narratives. Going chronologically from the Ancient Greeks onwards I will describe to some extent how each battle was won or lost by particular decisions, tactics, technology or fortune. But the aim of each main narrative will be to place each battle in the context of the overall history of Europe. Hosted on Acast. See acast.com/privacy for more information."
},
...
]
}
}
]
}
}
}
Retrieving a List Of Networks
A list of podcast networks can be retrieving using a networks query. You can use a combination of NetworkFilters and a searchTerm
in order to find the networks relevant to your needs. Here's an example of how to find networks containing "NBC" in the title:
Example GraphQL Query
query {
networks(searchTerm: "NBC") {
data {
title
description
url
}
}
}
Example Response
The query above will have a response similar to below:
{
"data": {
"networks": {
"data": [
{
"title": "NBC",
"description": "A leading source of global news and information for more than 75 years. The National Broadcasting Company (NBC) is an American commercial broadcasting television network and former radio network headquartered in New York City's Rockefeller Center, with bureaus and staff in the U.S. and around the world.",
"url": "https://www.podchaser.com/networks/nbc-108"
},
{
"title": "NBC Sports",
"description": "NBC Sports Group is a division of NBCUniversal that is responsible for NBC Sports' media properties, encompassing the NBC television network's sports division as well as day-to-day operation of the company's sports-oriented cable networks and other properties such as NBC Sports Radio.\n\nOperating Units\nGolf Channel\nGolf Films\nTelemundo Deportes, cross-conglomerate unit with NBCUniversal Telemundo\nNBC Sports\nNBC Sports Digital - consists of the online operations (the groups' websites and apps) plus:\nPlaymaker Media streaming unit[14]\nAllstar Stats LLC - Rotoworld and other fantasy sport sites\nNBC SportsTalk franchise\nNBC Sports Gold\nGolfNow\nSportsEngine\nNBC Sports Films\nNBCSN\nNBC Sports Regional Networks\nNBC Sports Ventures LLC\nNBC Sports Radio\nAlli Sports\nWillow\nOlympic Channel",
"url": "https://www.podchaser.com/networks/nbc-sports-215"
}
]
}
}
}
Retrieving podcast insights for networks
You can also retrieve aggregated podcast data from a network object. This includes details such as a list of categories that are present in the podcasts of the network, as well as the number of podcasts where audience demographic segments are present.
Please note that several podcast insight data segments require our plus or pro plans. See the PodcastInsights object reference documentation for details regarding which data points require special permissions.
Example GraphQL Query
query {
networks(searchTerm: "NBC") {
data {
title
description
url
podcastInsights {
categories {
title
count
}
status {
title
count
}
powerScore {
title
count
}
medianAge {
title
count
}
countries {
title
count
}
}
}
}
}
Example Response
The query above will have a response similar to below:
{
"data": {
"networks": {
"data": [
{
"title": "NBC",
"description": "A leading source of global news and information for more than 75 years. The National Broadcasting Company (NBC) is an American commercial broadcasting television network and former radio network headquartered in New York City's Rockefeller Center, with bureaus and staff in the U.S. and around the world.",
"url": "https://www.podchaser.com/networks/nbc-108",
"podcastInsights": {
"categories": [
{
"title": "Society",
"count": 20
},
{
"title": "Culture",
"count": 35
},
{
"title": "News",
"count": 70
},
{
"title": "True Crime",
"count": 15
}
],
"status": [
{
"title": "Idle",
"count": 3
},
{
"title": "Active",
"count": 70
}
],
"powerScore": [
{
"title": "0-9",
"count": 2
},
{
"title": "10-19",
"count": 8
},
{
"title": "20-29",
"count": 10
},
{
"title": "30-39",
"count": 14
},
{
"title": "40-49",
"count": 15
},
{
"title": "50-59",
"count": 18
},
{
"title": "60-69",
"count": 20
}
],
"medianAge": [
{
"title": "0-18",
"count": 0
},
{
"title": "18-24",
"count": 5
},
{
"title": "25-34",
"count": 20
},
{
"title": "35-44",
"count": 22
},
{
"title": "45-54",
"count": 26
},
{
"title": "55+",
"count": 8
}
],
"countries": [
{
"title": "Australia",
"count": 5
},
{
"title": "Brazil",
"count": 6
},
{
"title": "Canada",
"count": 20
},
{
"title": "United Kingdom",
"count": 10
},
{
"title": "United States",
"count": 25
}
]
}
},
...
]
}
}
}