Skip to content

Listen API: Podcast Search, Directory, and Insights API API

by listennotes.com

No authHTTPSEntertainment
Open documentation ↗

Overview

Simple & no-nonsense podcast search & directory API. Search all podcasts and episodes by people, places, or topics.

Listen API: Podcast Search, Directory, and Insights API is an entertainment API from listennotes.com. It needs no API key. It is served over HTTPS. Its OpenAPI description documents 23 endpoints.

At a glance

Authentication
No auth
HTTPS
Yes
CORS
Unknown
Base URL
https://listen-api.listennotes.com/api/v2
Version
2.0
Endpoints
23
Spec updated
2023-03-06

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://listen-api.listennotes.com/api/v2/best_podcasts" \
  -H "Accept: application/json"
JavaScript
const response = await fetch("https://listen-api.listennotes.com/api/v2/best_podcasts", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://listen-api.listennotes.com/api/v2/best_podcasts",
    headers={
    "Accept": "application/json",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/best_podcastsFetch a list of best podcasts by genre
GET/curated_podcastsFetch curated lists of podcasts
GET/curated_podcasts/{id}Fetch a curated list of podcasts by id
POST/episodesBatch fetch basic meta data for episodes
GET/episodes/{id}Fetch detailed meta data for an episode by id
GET/episodes/{id}/recommendationsFetch recommendations for an episode
GET/genresFetch a list of podcast genres
GET/just_listenFetch a random podcast episode
GET/languagesFetch a list of supported languages for podcasts
GET/playlistsFetch a list of your playlists.
GET/playlists/{id}Fetch a playlist's info and items (i.e., episodes or podcasts).
POST/podcastsBatch fetch basic meta data for podcasts
POST/podcasts/submitSubmit a podcast to Listen Notes database
GET/podcasts/{id}Fetch detailed meta data and episodes for a podcast by id
DELETE/podcasts/{id}Request to delete a podcast
GET/podcasts/{id}/audienceFetch audience demographics for a podcast
GET/podcasts/{id}/recommendationsFetch recommendations for a podcast
GET/regionsFetch a list of supported countries/regions for best podcasts
GET/related_searchesFetch related search terms
GET/searchFull-text search
GET/spellcheckSpell check on a search term
GET/trending_searchesFetch trending search terms
GET/typeaheadTypeahead search

Questions

Does the Listen API: Podcast Search, Directory, and Insights API API need an API key?

No. The Listen API: Podcast Search, Directory, and Insights API API can be called without an API key or sign-up, which makes it handy for prototypes and front-end demos.

Does the Listen API: Podcast Search, Directory, and Insights API API support HTTPS?

Yes, the Listen API: Podcast Search, Directory, and Insights API API is served over HTTPS.

How many endpoints does the Listen API: Podcast Search, Directory, and Insights API API have?

Its OpenAPI description lists 23 endpoints in version 2.0. All of them are shown on this page.

What are alternatives to the Listen API: Podcast Search, Directory, and Insights API API?

Other Entertainment APIs include Techy, Imgflip, Official Joke, Betfair: Exchange Streaming API, TasteDive.

Compare alternatives →

Listed from APIs.guru (CC0).