By listennotes
Updated 24 days ago

ListenNotes API Documentation

Podcast search, directory, and recommendation API. Note: We are retiring this version of API (v1) from RapidAPI. Please use the latest version v2 at

Learn more about this API
Search API
GETFull-text Search
Directory API
GETFetch meta data for a podcast by id
GETFetch meta data for an episode by id
GETFetch a list of podcast genres
GETFetch a list of supported languages for podcasts
GETFetch a list of best podcasts by genre
GETFetch a list of supported countries/regions for best podcasts
GETFetch recommendations for a podcast
GETFetch recommendations for an episode
POSTBatch fetch basic meta data for episodes
POSTBatch fetch basic meta data for podcasts
GETFetch a random podcast episode
GETFetch a curated list of podcasts by id
GETFetch curated lists of podcasts

Suggest search terms

Header Parameters
Required Parameters
REQUIREDSearch term
Optional Parameters
OPTIONALAutosuggest podcasts. This only searches podcast title and publisher and returns very limited info of 5 podcasts. 1 is yes, 0 is no. It's a bit slow to autosuggest podcasts, so we turn it off by default. Default: 0. If show_podcasts=1, you can also pass iTunes id (e.g., 474722933) to the q parameter to fetch podcast meta data.
OPTIONALAutosuggest genres. 1 is yes, 0 is no. Default: 0
OPTIONALWhether or not to exclude podcasts/episodes with explicit language. 1 is yes and 0 is no. Default: 0. This is only applicable when show_podcasts=1
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication