ListenNotes
FREEMIUM
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 https://www.listennotes.com/api/

Learn more about this API
Search API
GETFull-text Search
GETTypeahead
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
GETTypeahead

Suggest search terms

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Required Parameters
qSTRING
REQUIREDSearch term
Optional Parameters
show_podcastsNUMBER
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.
show_genresNUMBER
OPTIONALAutosuggest genres. 1 is yes, 0 is no. Default: 0
safe_modeNUMBER
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