Listen Notes
The best podcast search engine and database. All podcasts and episodes. Built with PodcastAPI.com.
- Name For Model
- PodcastDatabase
- Website
- listennotes.com
- Try on ChatGPT
- Open ChatGPT and Search the plugin name
- Update Date
- 8 months ago
- Contact
- [email protected]
- Description For Model
- Plugin for discovering podcasts and episodes. - When asked for searching podcasts, use the `searchPodcasts` endpoint - when asked for searching episodes or interviews, use the `searchEpisodes` endpoint - When asked for top podcasts or best podcasts or podcast recommendations, use the `getBestPodcasts` endpoint first; if no results, then try the `searchPodcasts` endpoint - When you need category or genres id, use the `getGenres` endpoint to find the closet genre name then get the id Instructions for displaying results: - Always use `listennotes_url` from the response data for the link of a podcast or an episode. Don't make up your own link. - Display at most 5 results, where each result is a podcast or an episode. - Summarize the description of each result to at most 150 characters.
Plugin Functions/Features (Plugin API Document)
| Operation Id | HTTP Method | Description | |
|---|---|---|---|
| 1 | searchPodcasts | GET | Search podcasts by keyword. A keyword can be a topic, a person name, a place, or a brand. Useful to discover podcasts by hosts, topics, publishers, etc. Also useful to find podcasts by name. |
| 2 | searchEpisodes | GET | Search episodes by keyword. A keyword can be a topic, a person name, a place, or a brand. Useful to find podcast interviews of a person, or episodes discussing a specific topic / person. |
| 3 | getBestPodcasts | GET | Fetch a list of best podcasts by genre, region, and language.Get the genre ids from the `getGenres` endpoint |
| 4 | justListen | GET | Get a random podcast episode, with all necessary metadata to describe this episode and stream the audio.Recently published episodes are more likely to be fetched. |
| 5 | getGenres | GET | Fetch a list of podcast genres. The `id` field can be used in other endpoints as `genre_id` parameter. |
| 6 | getLanguages | GET | Fetch a list of supported languages for podcasts. Use the language name as `language` parameter in other endpoints. |
| 7 | getRegions | GET | Fetch a list of supported countries/regions. The key of the returned json object is the region code (e.g., us, gb...) used in other endpoints as `region` parameter. |
| 8 | getEpisode | GET | Fetch detailed meta data for an episode by id. The `id` parameter of this endpoint can be obtained from the response of other endpoints. |
| 9 | getPodcast | GET | Fetch detailed meta data for a podcast by id, including up to 10 episodes. The `id` parameter of this endpoint can be obtained from the response of other endpoints. |