By listennotes
Updated a month 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
GETFetch a list of best podcasts by genre

Get a list of curated best podcasts by genre. You can get the genre ids from /api/v1/genres endpoint

Header Parameters
Optional Parameters
OPTIONALYou can get the id from /api/v1/genres. If not specified, it'll be all podcasts.
OPTIONALPage number of those podcasts in this genre.
OPTIONALFilter best podcasts by country/region. You can get the supported country codes from the /api/v1/regions endpoint. Default: us
OPTIONALWhether or not to exclude podcasts/episodes with explicit language. 1 is yes and 0 is no. Default: 0.
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication