Listen API: Podcast Search, Directory, and Insights API
Simple & no-nonsense podcast search & directory API. Search all podcasts and episodes by people, places, or topics.
Media & content#openapi#entertainment
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Simple & no-nonsense podcast search & directory API. Search all podcasts and episodes by people, places, or topics.
Endpoints 23
Search API
- GETFetch related search terms
/related_searches?q=evergrandeSuggest related search terms. The results are more comprehensive than from GET /typeahead. This endpoint is available only in the PRO/ENTERPRISE plan. - GETFull-text search
/search?q=star wars&sort_by_date=0&type=episode&offset=0&len_min=10&len_max=30&episode_count_min=0&episode_count_max=0&update_freq_min=0&update_freq_max=0&genre_ids=68,82&published_before=1580172454000&published_after=0&only_in=title,description&language=English®ion=&ocid=string&ncid=string&safe_mode=0&unique_podcasts=0Full-text search on episodes, podcasts, or curated lists of podcasts. Use the offset parameter to paginate through search results. The FREE plan allows to see… - GETSpell check on a search term
/spellcheck?q=evergrand stokSuggest a list of words that correct the spelling errors of a search term. This endpoint is available only in the PRO/ENTERPRISE plan. - GETFetch trending search terms
/trending_searchesFetch up to 10 most recent trending search terms on the Listen Notes platform. - GETTypeahead search
/typeahead?q=star wars&show_podcasts=1&show_genres=1&safe_mode=0Suggest search terms, podcast genres, and podcasts.
Directory API
- GETFetch a list of best podcasts by genre
/best_podcasts?genre_id=93&page=2®ion=us&publisher_region=string&language=string&sort=listen_score&safe_mode=0Get a list of curated best podcasts by genre, which are curated by Listen Notes staffs based on various signals from the Internet, e.g., top charts on other… - GETFetch curated lists of podcasts
/curated_podcasts?page=2A bunch of curated lists from online media. For each list, you'll get basic info of up to 5 podcasts. To get detailed meta data of all podcasts in a specific… - GETFetch a curated list of podcasts by id
/curated_podcasts/:idGet detailed meta data of all podcasts in a specific curated list. This endpoint returns same data as https://www.listennotes.com/curated-podcasts/ - POSTBatch fetch basic meta data for episodes
/episodesBatch fetch basic meta data for up to 10 episodes. This endpoint could be used to implement custom playlists for individual episodes. For detailed meta data… - GETFetch detailed meta data for an episode by id
/episodes/:id?show_transcript=1Fetch detailed meta data for a specific episode. - GETFetch recommendations for an episode
/episodes/:id/recommendations?safe_mode=0Fetch up to 8 episode recommendations based on the given episode id. - GETFetch a list of podcast genres
/genres?top_level_only=1Get a list of podcast genres that are supported in Listen Notes. The genre id can be passed to other endpoints as a parameter to get podcasts in a specific… - GETFetch a random podcast episode
/just_listenRecently published episodes are more likely to be fetched. Good luck! - GETFetch a list of supported languages for podcasts
/languagesGet a list of languages that are supported in Listen Notes database. You can use the language string as query parameter in GET /search. - POSTBatch fetch basic meta data for podcasts
/podcastsBatch fetch basic meta data for up to 10 podcasts. This endpoint could be used to build something like OPML import, allowing users to import a bunch of… - GETFetch detailed meta data and episodes for a podcast by id
/podcasts/:id?next_episode_pub_date=1479154463000&sort=recent_firstFetch detailed meta data and episodes for a specific podcast (up to 10 episodes each time). You can use the next_episode_pub_date parameter to do pagination… - GETFetch recommendations for a podcast
/podcasts/:id/recommendations?safe_mode=0Fetch up to 8 podcast recommendations based on the given podcast id. - GETFetch a list of supported countries/regions for best podcasts
/regionsIt returns a dictionary of country codes (e.g., us, gb...) & country names (United States, United Kingdom...). The country code is used in the query parameter…
Playlist API
- GETFetch a list of your playlists.
/playlists?sort=recent_added_first&page=1This endpoint returns same data as listennotes.com/listen under your account. You can use the page parameter to do pagination and fetch more playlists. - GETFetch a playlist's info and items (i.e., episodes or podcasts).
/playlists/:id?type=episode_list&last_timestamp_ms=0&sort=recent_added_firstA playlist can be an episode list (i.e., all items are episodes) or a podcast list (i.e., all items are podcasts), which is essentially the same as those…
Podcaster API
- POSTSubmit a podcast to Listen Notes database
/podcasts/submitPodcast hosting services can use this endpoint to help your users directly submit a new podcast to Listen Notes database. If the podcast doesn't exist in the… - DELETERequest to delete a podcast
/podcasts/:id?reason=the podcaster wants to delete itPodcast hosting services can use this endpoint to streamline the process of podcast deletion on behave of their users (podcasters). We will review the…
Insights API
- GETFetch audience demographics for a podcast
/podcasts/:id/audienceFetch audience demographics for a podcast - 1) directly measured on the Listen Notes platform; 2) only supports audience breakdown by regions for now; 3) not…
API details
- Base URL
https://listen-api.listennotes.com/api/v2- Authentication
- None declared in the description
- Operations
- 23 operations on 22 pathsGET 19POST 3DELETE 1
- Main resources
- Directory API 13Search API 5Playlist API 2Podcaster API 2Insights API 1
- Response formats
application/json- Webhooks
- 3 described
- Description format
- OpenAPI 3.1.0, API version
2.0 - Links
- OpenAPI document · Terms of service · Support
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the Listen API: Podcast Search, Directory, and Insights API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Listen API: Podcast Search, Directory, and Insights API collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “Fetch related search terms” (GET /related_searches?q=evergrande), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Listen API: Podcast Search, Directory, and Insights API?
Simple & no-nonsense podcast search & directory API. Search all podcasts and episodes by people, places, or topics. It is listed under Media & content and has 23 endpoints.
Who publishes the Listen API: Podcast Search, Directory, and Insights API?
It is listed from Listen Notes's public API description (an OpenAPI document), not published by Listen Notes on Swastik Codes. Anyone who controls listennotes.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Listen API: Podcast Search, Directory, and Insights API?
Requests go to https://listen-api.listennotes.com/api/v2. Endpoint paths are added to this base URL.
How do I authenticate with the Listen API: Podcast Search, Directory, and Insights API?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the Listen API: Podcast Search, Directory, and Insights API have?
23 operations on 22 paths (19 GET, 3 POST, 1 DELETE). The largest groups are Directory API, Search API, Playlist API, Podcaster API.
Is forking the Listen API: Podcast Search, Directory, and Insights API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.