Simple & no-nonsense podcast search & directory API. Search all podcasts and episodes by people, places, or topics.
Every row below was read from the vendor's own OpenAPI document. The summary text is theirs. What this registry adds is that each operation is indexed with its method, path, base URL and auth scheme, so a search for a capability can answer with a call rather than a name, and that the endpoint is probed on a schedule.
Specifications as held by the APIs.guru corpus, whose newest record is 2023-04-21. Operations the vendor has added since are not listed here; the origin links above are the vendor's own current documents.
base URLs: https://listen-api.listennotes.com/api/v2
find it by capability: POST /search {"query":{"text":"..."}} returns these
operations with their invocation detail. Connect any agent client.
Simple & no-nonsense podcast search & directory API. Search all podcasts and episodes by people, places, or topics.
| method | path | what the vendor says it does |
|---|---|---|
GET | /best_podcasts | Fetch a list of best podcasts by genre Get a list of curated best podcasts by genre, which are curated by List |
GET | /curated_podcasts | Fetch curated lists of podcasts A bunch of curated lists from online media. For each list, you'll get basic in |
GET | /curated_podcasts/{id} | Fetch a curated list of podcasts by id Get detailed meta data of all podcasts in a specific curated list. This |
POST | /episodes | Batch fetch basic meta data for episodes Batch fetch basic meta data for up to 10 episodes. This endpoint coul |
GET | /episodes/{id} | Fetch detailed meta data for an episode by id Fetch detailed meta data for a specific episode. Directory API |
GET | /episodes/{id}/recommendations | Fetch recommendations for an episode Fetch up to 8 episode recommendations based on the given episode id. Dire |
GET | /genres | Fetch a list of podcast genres Get a list of podcast genres that are supported in Listen Notes. The genre id c |
GET | /just_listen | Fetch a random podcast episode Recently published episodes are more likely to be fetched. Good luck! Directory |
GET | /languages | Fetch a list of supported languages for podcasts Get a list of languages that are supported in Listen Notes da |
GET | /playlists | Fetch a list of your playlists. This endpoint returns same data as listennotes.com/listen under your account. |
GET | /playlists/{id} | Fetch a playlist's info and items (i.e., episodes or podcasts). A playlist can be an episode list (i.e., all i |
POST | /podcasts | Batch fetch basic meta data for podcasts Batch fetch basic meta data for up to 10 podcasts. This endpoint coul |
POST | /podcasts/submit | Submit a podcast to Listen Notes database Podcast hosting services can use this endpoint to help your users di |
GET | /podcasts/{id} | Fetch detailed meta data and episodes for a podcast by id Fetch detailed meta data and episodes for a specific |
DELETE | /podcasts/{id} | Request to delete a podcast Podcast hosting services can use this endpoint to streamline the process of podcas |
GET | /podcasts/{id}/audience | Fetch audience demographics for a podcast Fetch audience demographics for a podcast - 1) directly measured on |
GET | /podcasts/{id}/recommendations | Fetch recommendations for a podcast Fetch up to 8 podcast recommendations based on the given podcast id. Direc |
GET | /regions | Fetch a list of supported countries/regions for best podcasts It returns a dictionary of country codes (e.g., |
GET | /related_searches | Fetch related search terms Suggest related search terms. The results are more comprehensive than from `GET /ty |
GET | /search | Full-text search Full-text search on episodes, podcasts, or curated lists of podcasts. Use the `offset` parame |
GET | /spellcheck | Spell check on a search term Suggest a list of words that correct the spelling errors of a search term. This e |
GET | /trending_searches | Fetch trending search terms Fetch up to 10 most recent trending search terms on the Listen Notes platform. Sea |
GET | /typeahead | Typeahead search Suggest search terms, podcast genres, and podcasts. Search API |
specification origin: https://listen-api.listennotes.com/api/v2/openapi.yaml
nothing on this page is a rating, an endorsement or a claim about quality. Reachability is what our probes observed from one network; answering is a floor under usefulness, not a measure of it.