get_podcast
Fetch detailed metadata for a podcast by its Listen Notes ID. Returns full podcast information including title, publisher, description, RSS feed URL, genre IDs, listen score, and recent episodes.
Use **nextEpisodePubDate** for paginating through a podcast's episode list.
submit_podcast
Submit a podcast RSS feed URL to the Listen Notes database. If the RSS URL already exists, returns the podcast metadata immediately. Otherwise, the podcast is reviewed and added within 12 hours.
Optionally provide an email to receive a notification when the podcast is added.
search_podcasts
Full-text search across millions of podcasts, episodes, and curated lists.
Supports filtering by content type, genre, language, region, publish date range, and audio length.
Results include highlighted matches and relevance scoring. Use **type** to search podcasts, episodes, or curated lists.
get_episode
Fetch detailed metadata for a podcast episode by its Listen Notes ID. Returns full episode information including title, description, audio URL, duration, publish date, and parent podcast metadata.
Optionally include transcript if available (PRO/ENTERPRISE plans).
batch_fetch
Fetch metadata for multiple podcasts or episodes in a single request (up to 10).
For podcasts, you can look them up by Listen Notes IDs, RSS URLs, iTunes IDs, or Spotify IDs.
For episodes, provide Listen Notes episode IDs. Requires PRO/ENTERPRISE plan.
typeahead_search
Search-as-you-type suggestions for podcast search. Returns autocomplete term suggestions and optionally matching podcasts and genres.
Also provides access to trending search terms and related search suggestions.
curated_lists
Browse and fetch curated podcast lists. Without a curatedListId, returns a paginated list of available curated collections.
With a curatedListId, returns the full details and podcasts in that specific curated list.
get_recommendations
Get similar podcast or episode recommendations based on a given podcast or episode ID. Returns up to 8 recommendations that are similar in content and style.
best_podcasts
Browse the best and most popular podcasts by genre. Returns curated lists of top podcasts with pagination support.
Filter by genre, region, publisher region, language, and sort order. Use the "Get Genres & Regions" tool to discover available genre IDs and region codes.
get_playlists
Fetch your Listen Notes playlists. Without a playlistId, returns a paginated list of all your playlists.
With a playlistId, returns the full playlist with its items (episodes or podcasts).
random_episode
Get a random podcast episode from Listen Notes ("Just Listen"). Great for discovering new content or providing serendipitous recommendations.
delete_podcast
Request removal of a podcast from the Listen Notes database. This is primarily used by podcast hosting services to handle content removal requests on behalf of podcasters.
get_genres_and_regions
Fetch the directory of podcast genres, supported languages, and supported regions. Use this to discover valid genre IDs, language names, and region codes for filtering search and discovery results.