Podcast API

An API for developers to get information on over 4 million podcasts and 130 million episodes. The goal of our Podcast API is to make it easier for anyone to build a great podcast app.

What can you do with the API?

Get details on any podcast or episode.

Blazing fast full-text search on all podcasts and episodes.

💡

New Documentation for getSearchTerm

The full-text search query will be updated on May 1st, 2024. The change adjusts the default parameters being passed in and allows non-exact matches to be returned. If you want to keep the current logic, you will want to pass in EXACT_PHRASE.

Get notifications for any newly released podcasts or episodes through a webhook (See our example use cases)

Daily Top Charts for podcasts and episodes.

Get details on multiple podcasts or multiple episodes (returns an array).

Add a podcast to our directory.

Bulk download all 4 million podcasts from our directory.

👋

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

Sign Up for Free ➤

How do we keep our API up-to-date?

Checking for new or updated podcast information can be a challenging task because a new episode can be released at any time on any of the 5 million podcast feeds. The way we solve for this is that we use multiple queues:

WEBSUB - Feed is checked immediately for updates (within 5 mins, usually much sooner). This is only for podcast feeds that support WebSub (~20% of podcasts).

HIGH - Feed is checked every 4 hours. This is used for popular podcasts that do not have WebSub support

REGULAR - Feed is checked every day. This is the most common queue.

LOW / INACTIVE - Feed is checked once a week. This is used for podcast feeds that throw errors or have not been updated in over a year.

You can check the priority of any podcast to see what queue it falls under.

API Reference:

PodcastSeries - Information on a podcast

PodcastEpisode - Information on an episode

iTunesInfo - Additional information from iTunes on a podcast

Country - The country in which the podcast is made

Language - The language spoken on the podcast

Genre - The genre of the podcast

SortOrder - The option to have returned items sorted by newest or oldest.

PodcastContentType - Helps you distinguish between audio and video podcasts

PodcastSeriesType - Helps you distinguish between episodic and serial podcasts

PodcastEpisodeType - Helps you distinguish between episodic and serial podcasts

TaddyType - The types of media available on Taddy

TopChartsSource - A list of platforms you can get Top Charts data from

TopChartsType - A list of possible categories for podcasts or episodes to be ranked in

SearchResultBoostType - The option to have search results be prioritized by exact term matching or popularity

SearchOperator - Choose between searching for exact phrases, all terms, and some terms

SearchQueryResponseInfo - Additional details for search request

FeedRefreshDetails - Details on how often Taddy checks a podcast feed for updates