Sign Up

Log In

ListenNotes

FREEMIUM
By listennotes
Updated 6 hours ago
Media
9.8/10
Popularity Score
360ms
Latency
100%
Success Rate

ListenNotes API Documentation

Podcast search, directory, and recommendation API

View API Details

Supercharge your App

Discover and connect to thousands of APIs in the world's largest API Hub

Search API
GETFull-text Search
GETTypeahead
Directory API
GETFetch meta data for a podcast
GETFetch meta data for an episode
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
GETFull-text Search

Search episodes or podcasts

FreemiumThis API has a free, limited plan and paid plans. You can subscribe directly to it from RapidAPI.
Sign up to test this endpoint
Log in
Header Parameters
X-RapidAPI-KeySTRING
REQUIRED
Required Parameters
qSTRING
REQUIREDSearch term
Optional Parameters
sort_by_dateNUMBER
OPTIONALSort by date or not? If 1, sort by date. If 0 (default), sort by relevance.
typeSTRING
OPTIONALWhat to search: "episode" (default) or "podcast"?
offsetNUMBER
OPTIONALOffset for search results, for pagination. You'll use next_offset from response for this parameter.
len_minNUMBER
OPTIONALMinimum audio length in minutes. Applicable only when type parameter is "episode".
len_maxNUMBER
OPTIONALMaximum audio length in minutes. Applicable only when type parameter is "episode".
genre_idsSTRING
OPTIONALA comma-delimited string of a list of genre ids. You can find the id and the name of all genres in the response of /api/v1/genres
published_beforeNUMBER
OPTIONALOnly show episodes published before this timestamp (in milliseconds). Default: now. If published_before & published_after are used at the same time, published_before should be bigger than published_after.
published_afterNUMBER
OPTIONALOnly show episodes published after this timestamp (in milliseconds). Default: 0 (since the very first episode). If published_before & published_after are used at the same time, published_before should be bigger than published_after.
only_inSTRING
OPTIONALSearch only in specific fields. Allowed values: title, description, author, audio. If not specified, then search every fields
languageSTRING
OPTIONALLimit search results to a specific language. If not specified, it'll be any language. You can get a list of supported languages from /api/v1/languages endpoint
ocidSTRING
OPTIONALA podcast id (the podcast_id field in response). This parameter is to limit search results in a specific podcast. It works only when "type" is episode.
ncidSTRING
OPTIONALA podcast id (the podcast_id field in response). This parameter is to exclude search results from a specific podcast. It works only when "type" is episode.
safe_modeNUMBER
OPTIONALWhether or not to exclude podcasts/episodes with explicit language. 1 is yes and 0 is no. Default: 0
Request Snippet
unirest.get("https://listennotes.p.rapidapi.com/api/v1/search?sort_by_date=undefined&type=undefined&offset=undefined&len_min=undefined&len_max=undefined&genre_ids=undefined&published_before=undefined&published_after=undefined&only_in=undefined&language=undefined&ocid=undefined&ncid=undefined&safe_mode=undefined&q=<required>")
.header("X-RapidAPI-Key", "undefined")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
Sample Response

loading...

Log inSign up

Install SDK for NodeJS

Installing

To utilize unirest for node.js install the the npm module:

$ npm install unirest

After installing the npm package you can now start simplifying requests like so:

var unirest = require('unirest');

Creating Request

unirest.get("https://listennotes.p.rapidapi.com/api/v1/search?sort_by_date=undefined&type=undefined&offset=undefined&len_min=undefined&len_max=undefined&genre_ids=undefined&published_before=undefined&published_after=undefined&only_in=undefined&language=undefined&ocid=undefined&ncid=undefined&safe_mode=undefined&q=<required>")
.header("X-RapidAPI-Key", "undefined")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication
Sign up for freeto test this endpoint
Join the world’s largest API marketplace with over half a million developers and thousands of APIs.
DiscoverAPIs
Testfrom the browser
Connectusing code snippets
Managefrom one dashboard