Retrieving Podcast and Episode Sponsors
Podchaser's Podcast Sponsors add-on is a new feature for gaining insight into where podcast advertisers are spending their money. Use it to monitor competitors, source partners, look for sales prospects, and spot content acquisition targets.
Now part of the Podchaser API, the Podcast Sponsors add-on allows developers and partners to access past sponsor data across the top 5,000+ podcasts, plus each brand's sponsor history with estimated ad spend.
If you haven't already, you will need to get your authorization token which you can get by following our Authorization instructions.
Getting Sponsors of a Podcast
The Podcast object has a sponsors field that contains all the sponsors the podcast has had. You can access that field in any query that returns a Podcast object including when looking up a specific podcast using our Podcast query or when searching podcasts using our Podcasts query.
This sponsors field returns a PodcastSponsorList object which is a paginated list of all sponsors of a podcast.
For example, if we looked up the "Pivot" podcast and looked at a few sponsors, we could use this query:
POST https://api.podchaser.com/graphql
Authorization: Bearer YOURTOKEN
query {
podcast(identifier: {id: "731600", type: PODCHASER}) {
id,
title,
description,
sponsors {
data {
brand {
name,
code
},
episode_count
}
}
}
}
This query will have this reponse (though shortened here for brevity):
{
"data": {
"podcast": {
"id": 731600,
"title": "Pivot",
"description": "Every Tuesday and Friday, tech journalist Kara Swisher and NYU Professor Scott Galloway offer sharp, unfiltered insights into the biggest stories in tech, business, and politics. They make bold predictions, pick winners and losers, and bicker and banter like no one else. After all, with great power comes great scrutiny. From New York Magazine and the Vox Media Podcast Network.",
"sponsors": {
"data": [
{
"brand": {
"name": "Salesforce",
"code": "global.brand.salesforce.com"
},
"episode_count": 5
},
{
"brand": {
"name": "Athletic Greens",
"code": "global.brand.athletic_greens"
},
"episode_count": 2
},
...other brands...
]
}
}
}
}
Getting Sponsors of an Episode
The Episode object also has a sponsors field that contains all the sponsors for the episode. You can access that field in any query that returns an Episode object, including the episodes returned in the episodes field on a Podcast object or when using the Episode or Episodes queries.
This sponsors field returns a EpisodeSponsorPaginator object which is a paginated list of all sponsors of the episode.
For example, if we looked up the "StarTalk Radio" podcast and looked at sponsors for some of the most recent episodes, we could use this query:
POST https://api.podchaser.com/graphql
Authorization: Bearer YOURTOKEN
query {
podcast(identifier: {id: "20978", type: PODCHASER}) {
id,
title,
description,
episodes(first: 5, sort: {sortBy: AIR_DATE, direction: DESCENDING}) {
data {
id,
title,
description,
sponsors {
data {
brand {
name,
code,
}
}
},
},
},
},
}
This query will have this reponse (though shortened here for brevity):
{
"data": {
"podcast": {
"id": 20978,
"title": "StarTalk Radio",
"description": "Science, pop culture and comedy collide on StarTalk Radio! Astrophysicist and Hayden Planetarium director Neil deGrasse Tyson, his comic co-hosts, guest celebrities and scientists discuss astronomy, physics, and everything else about life in the universe. Keep Looking Up! New episodes premiere Monday nights at 7pm ET.",
"episodes": {
"data": [
{
"id": "147117570",
"title": "Hormones on Steroids with Dr. Aniket Sidhaye",
"description": "How do hormones affect us? On this episode, Neil deGrasse Tyson and co-hosts Chuck Nice and Gary O’Reilly explore the body's endocrine system, steroids, hormones, and how we can hack it with an endocrinologist, Dr. Aniket Sidhaye.NOTE: StarTalk+ Patrons can watch or listen to this entire episode commercial-free here: https://startalkmedia.com/show/hormones-on-steroids-with-dr-aniket-sidhaye/Photo Credit: quimono, CC BY-SA 4.0, Pixabay through Creative Commons via Wikimedia Commons\n",
"sponsors": {
"data": [
{
"brand": {
"name": "Progressive",
"code": "global.brand.progressive"
}
}
]
}
}
...other episodes...
]
}
}
}
}
Finding Podcasts Sponsored by a Brand
You can also look up what podcasts are sponsored by a specific brand. You have two main ways to do so:
- Use our Brand query to look up a specific brand using our internal "code" (shown in the responses above)
- Use our Brands query to search for a brand by name
For example, if we use the code that was returned with Progressive in the response above, we could use this query to get information about the brand:
POST https://api.podchaser.com/graphql
Authorization: Bearer YOURTOKEN
query {
brand(code: "global.brand.progressive") {
name,
code,
estimatedAdSpend {
low,
high
},
sponsoredPodcasts {
data {
podcast {
id,
title
}
episode_count
}
}
},
}
This query will have this reponse (though shortened here for brevity):
{
"data": {
"brand": {
"name": "Progressive",
"code": "global.brand.progressive",
"estimatedAdSpend": {
"low": 5098399.81,
"high": 10196788.32
},
"sponsoredPodcasts": {
"data": [
{
"podcast": {
"id": "1577501",
"title": "The Dinesh D'Souza Podcast"
},
"episode_count": 3
},
{
"podcast": {
"id": "193778",
"title": "Our Fake History"
},
"episode_count": 6
},
{
"podcast": {
"id": "95725",
"title": "Latino USA"
},
"episode_count": 9
},
...other podcasts...
]
}
}
}
}
Since the sponsoredPodcasts field is a paginated podcast list, you can also use any of our PodcastSort sorts to sort the podcast, such as by Power Score, alphabetical, and follower count.