
Listen API: Podcast Search, Directory, and Insights API API
by listennotes.com
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
- Category
- Entertainment
- Base URL
https://listen-api.listennotes.com/api/v2- Version
- 2.0
- Endpoints
- 23
- OpenAPI
- Specification ↗
- Spec updated
- 2023-03-06
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://listen-api.listennotes.com/api/v2/best_podcasts" \
-H "Accept: application/json"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);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
| Method | Path | What it does |
|---|---|---|
| GET | /best_podcasts | Fetch a list of best podcasts by genre |
| GET | /curated_podcasts | Fetch curated lists of podcasts |
| GET | /curated_podcasts/{id} | Fetch a curated list of podcasts by id |
| POST | /episodes | Batch fetch basic meta data for episodes |
| GET | /episodes/{id} | Fetch detailed meta data for an episode by id |
| GET | /episodes/{id}/recommendations | Fetch recommendations for an episode |
| GET | /genres | Fetch a list of podcast genres |
| GET | /just_listen | Fetch a random podcast episode |
| GET | /languages | Fetch a list of supported languages for podcasts |
| GET | /playlists | Fetch a list of your playlists. |
| GET | /playlists/{id} | Fetch a playlist's info and items (i.e., episodes or podcasts). |
| POST | /podcasts | Batch fetch basic meta data for podcasts |
| POST | /podcasts/submit | Submit 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}/audience | Fetch audience demographics for a podcast |
| GET | /podcasts/{id}/recommendations | Fetch recommendations for a podcast |
| GET | /regions | Fetch a list of supported countries/regions for best podcasts |
| GET | /related_searches | Fetch related search terms |
| GET | /search | Full-text search |
| GET | /spellcheck | Spell check on a search term |
| GET | /trending_searches | Fetch trending search terms |
| GET | /typeahead | Typeahead 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.
Similar entertainment APIs
Compare alternatives →Techy
EntertainmentJSON and Plaintext API for tech-savvy sounding phrases
Imgflip
EntertainmentGets an array of popular memes
Official Joke
EntertainmentAPI for random and programming jokes
Betfair: Exchange Streaming API
EntertainmentAPI to receive streamed updates. This is an ssl socket connection of CRLF delimited json messages (see RequestMessage & ResponseMessage)
TasteDive
EntertainmentContent-based recommendations for movies, music, TV shows, books, games, and podcasts
JokeAPI
EntertainmentProgrammable jokes in multiple languages with filtering options
Listed from APIs.guru (CC0).