Other

Listen API: Podcast Search, Directory, and Insights

auto-generated

swirls add listennotes …

actionGETv1.0.0

Fetch a curated list of podcasts by id

Get detailed meta data of all podcasts in a specific curated list. This endpoint returns same data as https://www.listennotes.com/curated-podcasts/

Source

actionGETv1.0.0

Fetch a list of best podcasts by genre

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/

Source

actionGETv1.0.0

Fetch a list of podcast genres

Get 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 genre, e.g., `GET /best_podcasts`, `GET /search`... You may want to cache the list of genres on the client side.

Source

actionGETv1.0.0

Fetch a list of supported countries/regions for best podcasts

It 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 **region** of `GET /best_podcasts`.

Source

actionGETv1.0.0

Fetch a list of supported languages for podcasts

Get a list of languages that are supported in Listen Notes database. You can use the language string as query parameter in `GET /search`.

Source

actionGETv1.0.0

Fetch a list of your playlists.

This endpoint returns same data as listennotes.com/listen under your account. You can use the **page** parameter to do pagination and fetch more playlists.

Source

actionGETv1.0.0

Fetch a playlist's info and items (i.e., episodes or podcasts).

A 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 created via listennotes.com/listen/. This endpoint fetches a list of items (i.e., episodes or podcasts) in the playlist. You can use the **last_pub_date_ms** parameter to do pagination and fetch more items. A playlist can be **public** (discoverable on ListenNotes.com), **unlisted** (accessible to anyone who knows the playlist id), or **private** (accessible to its owner). You can fetch all playlists created by you, and **public** / **unlisted** playlists created by others.

Source

actionGETv1.0.0

Fetch a random podcast episode

Recently published episodes are more likely to be fetched. Good luck!

Source

actionGETv1.0.0

Fetch audience demographics for a podcast

Fetch audience demographics for a podcast - 1) directly measured on the Listen Notes platform; 2) only supports audience breakdown by regions for now; 3) not every podcast has data.

Source

actionGETv1.0.0

Fetch curated lists of podcasts

A 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 list, you need to use `GET /curated_podcasts/{id}`. We add new curated lists to the database on a daily basis.

Source

actionGETv1.0.0

Fetch detailed meta data and episodes for a podcast by id

Fetch 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 and fetch more episodes.

Source

actionGETv1.0.0

Fetch detailed meta data for an episode by id

Fetch detailed meta data for a specific episode.

Source

actionGETv1.0.0

Fetch recommendations for a podcast

Fetch up to 8 podcast recommendations based on the given podcast id.

Source

actionGETv1.0.0

Fetch recommendations for an episode

Fetch up to 8 episode recommendations based on the given episode id.

Source

actionGETv1.0.0

Fetch related search terms

Suggest related search terms. The results are more comprehensive than from `GET /typeahead`. This endpoint is available only in the PRO/ENTERPRISE plan.

Source

actionGETv1.0.0

Fetch trending search terms

Fetch up to 10 most recent trending search terms on the Listen Notes platform.

Source

actionGETv1.0.0

Full-text search

Full-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 up to 30 search results (or `offset` < 30) per query. The PRO plan allows to see up to 300 search results (or `offset` < 300) per query. The ENTERPRISE plan allows to see up to 10,000 search results (or `offset` < 10000) per query.

Source

actionDELETEv1.0.0

Request to delete a podcast

Podcast hosting services can use this endpoint to streamline the process of podcast deletion on behave of their users (podcasters). We will review the deletion request within 12 hours. If the podcast is already deleted, the "status" field in the response will be "deleted". Otherwise, the status field will be "in review". If you want to get a notification once the podcast is deleted, you can configure a webhook url in the dashboard: listennotes.com/api/dashboard/#webhooks

Source

actionGETv1.0.0

Spell check on a search term

Suggest a list of words that correct the spelling errors of a search term. This endpoint is available only in the PRO/ENTERPRISE plan.

Source

actionPOSTv1.0.0

Submit a podcast to Listen Notes database

Podcast 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 database, "status" in the response will be "in review", and we'll review it within 12 hours. If the podcast exists, "status" in the response will be "found". If this submission is rejected, "status" in the response will be "rejected". You can use `POST /podcasts` to check if multiple podcasts exist in the database. If you want to get a notification once the podcast is accepted, you can either specify the "email" parameter or configure a webhook url in the dashboard: listennotes.com/api/dashboard/#webhooks

Source

actionGETv1.0.0