Fetch a list of best podcasts by genre
GET {{baseUrl}}/best_podcasts?genre_id=<string>&page=<integer>®ion=us&publisher_region=<string>&language=<string>&sort=recent_added_first&safe_mode=0
Get 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 podcast platforms, recommendations from mainstream media,
user activities on listennotes.com...
You can get the genre ids from GET /genres endpoint.
This endpoint returns same data as https://www.listennotes.com/best-podcasts/
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
genre_id | string | You can get the id from GET /genres. If not specified, it'll be the overall best podcasts, which can be considered as a special genre. | |
page | string | Page number of those podcasts in this genre. | |
region | string | Filter best podcasts by country/region. | |
| Please note that podcasts that are "best" in a country/region may not be produced in that country/region. | |||
| For example, a podcast from the US may be very popular in Canada. | |||
You can get the supported country codes (e.g., us, jp, gb...) from GET /regions. | |||
| If not specified, you'll get "best podcasts" in United States. | |||
publisher_region | string | Filter best podcasts by the publisher's country/region. | |
| This is to narrow down the results to include "best podcasts" produced in a specific country/region. | |||
You can get the supported country codes (e.g., us, jp, gb...) from GET /regions. | |||
| If not specified, you'll get "best podcasts" produced in any country/region. | |||
| If you want to get a country/region's "best podcasts" that are also produced in that country/region, | |||
| then you need to specify both region and publisher_region, | |||
e.g., region=jp and publisher_region=jp. | |||
language | string | Filter best podcasts by language. | |
You can get a list of supported languages (e.g., English, Chinese, Japanese...) from GET /languages. | |||
| If not specified, you'll get "best podcasts" in any language. | |||
sort | string | How do you want to sort these podcasts? | |
| If you'd like to sort by popularity, please use listen_score. | |||
safe_mode | number | Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
X-ListenAPI-Key | string | (Required) Get API Key on listennotes.com/api | |
Accept | string |
RESPONSES
status: OK
{"has_next":"\u003cboolean\u003e","has_previous":"\u003cboolean\u003e","id":"\u003cinteger\u003e","listennotes_url":"\u003cstring\u003e","name":"\u003cstring\u003e","next_page_number":"\u003cinteger\u003e","page_number":"\u003cinteger\u003e","parent_id":"\u003cinteger\u003e","podcasts":[{"is_claimed":"\u003cboolean\u003e","type":"serial","explicit_content":"\u003cboolean\u003e","website":"\u003cstring\u003e","total_episodes":"\u003cinteger\u003e","audio_length_sec":"\u003cinteger\u003e","update_frequency_hours":"\u003cinteger\u003e","earliest_pub_date_ms":"\u003cinteger\u003e","rss":"\u003cstring\u003e","latest_episode_id":"\u003cstring\u003e","latest_pub_date_ms":"\u003cinteger\u003e","title":"\u003cstring\u003e","language":"\u003cstring\u003e","description":"\u003cstring\u003e","email":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","id":"\u003cstring\u003e","country":"\u003cstring\u003e","publisher":"\u003cstring\u003e","itunes_id":"\u003cinteger\u003e","looking_for":{"cohosts":"\u003cboolean\u003e","cross_promotion":"\u003cboolean\u003e","sponsors":"\u003cboolean\u003e","guests":"\u003cboolean\u003e"},"extra":{"youtube_url":"\u003cstring\u003e","facebook_handle":"\u003cstring\u003e","instagram_handle":"\u003cstring\u003e","twitter_handle":"\u003cstring\u003e","wechat_handle":"\u003cstring\u003e","patreon_handle":"\u003cstring\u003e","google_url":"\u003cstring\u003e","amazon_music_url":"\u003cstring\u003e","linkedin_url":"\u003cstring\u003e","spotify_url":"\u003cstring\u003e","url1":"\u003cstring\u003e","url2":"\u003cstring\u003e","url3":"\u003cstring\u003e"},"genre_ids":["\u003cinteger\u003e","\u003cinteger\u003e"],"listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e","has_guest_interviews":"\u003cboolean\u003e","has_sponsors":"\u003cboolean\u003e"},{"is_claimed":"\u003cboolean\u003e","type":"serial","explicit_content":"\u003cboolean\u003e","website":"\u003cstring\u003e","total_episodes":"\u003cinteger\u003e","audio_length_sec":"\u003cinteger\u003e","update_frequency_hours":"\u003cinteger\u003e","earliest_pub_date_ms":"\u003cinteger\u003e","rss":"\u003cstring\u003e","latest_episode_id":"\u003cstring\u003e","latest_pub_date_ms":"\u003cinteger\u003e","title":"\u003cstring\u003e","language":"\u003cstring\u003e","description":"\u003cstring\u003e","email":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","id":"\u003cstring\u003e","country":"\u003cstring\u003e","publisher":"\u003cstring\u003e","itunes_id":"\u003cinteger\u003e","looking_for":{"cohosts":"\u003cboolean\u003e","cross_promotion":"\u003cboolean\u003e","sponsors":"\u003cboolean\u003e","guests":"\u003cboolean\u003e"},"extra":{"youtube_url":"\u003cstring\u003e","facebook_handle":"\u003cstring\u003e","instagram_handle":"\u003cstring\u003e","twitter_handle":"\u003cstring\u003e","wechat_handle":"\u003cstring\u003e","patreon_handle":"\u003cstring\u003e","google_url":"\u003cstring\u003e","amazon_music_url":"\u003cstring\u003e","linkedin_url":"\u003cstring\u003e","spotify_url":"\u003cstring\u003e","url1":"\u003cstring\u003e","url2":"\u003cstring\u003e","url3":"\u003cstring\u003e"},"genre_ids":["\u003cinteger\u003e","\u003cinteger\u003e"],"listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e","has_guest_interviews":"\u003cboolean\u003e","has_sponsors":"\u003cboolean\u003e"}],"previous_page_number":"\u003cinteger\u003e","total":"\u003cinteger\u003e"}