Skip to main content
Listen Notes logo
  • Category: video & audio
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 26
  • Triggers: 0
  • Slug: LISTENNOTES
  • Version: 20261101_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODESRetrieves metadata for multiple known podcast episodes by ID in one request. Managed-account requests require 1 to 10 nonempty episode identifiers.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
Comma-separated list of episode ids.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTSRetrieves metadata for multiple podcasts by Listen Notes IDs, RSS URLs, Apple Podcasts IDs, or Spotify IDs, with optional latest episodes. Managed-account requests require 1 to 10 nonempty identifiers in total.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
Comma-separated list of podcast ids.
string
Comma-separated rss urls.
string
Comma-separated Apple Podcasts (iTunes) ids, e.g., 659155419
string
Comma-separated Spotify ids, e.g., 3DDfEsKDIDrTlnPOiG4ZF4
integer
Whether or not to fetch up to 15 latest episodes from these podcasts, sorted by pub_date. 1 is yes, and 0 is no.
integer
For latest episodes pagination. It”s the value of next_episode_pub_date from the response of last request. If not specified, just return latest 15 episodes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_A_CURATED_LIST_OF_PODCASTS_BY_IDRetrieves detailed information about a specific curated podcast using its unique identifier. This endpoint allows users to access comprehensive data about a carefully selected podcast collection, including its contents, curator information, and associated metadata. It’s particularly useful for applications that want to display or analyze curated podcast lists. The endpoint should be used when detailed information about a known curated podcast is required, but it won’t provide a list of all available curated podcasts or allow modifications to the curated content.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
id for a specific curated list of podcasts. You can get the id from the response of GET /search?type=curated or GET /curated_podcasts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_A_LIST_OF_BEST_PODCASTS_BY_GENREThe getBestPodcasts endpoint retrieves a curated list of the best podcasts from the Listen Notes platform. It allows users to access a collection of top-rated or popular podcasts, which can be filtered by genre, region, and content rating. This endpoint is useful for discovering high-quality podcast content, creating recommendation systems, or populating podcast directories. The results are paginated for efficient data retrieval and can be customized to exclude explicit content if required. While it provides a valuable overview of top podcasts, it may not include real-time updates or notifications about new episodes or changes in podcast rankings.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

integer
Page number of those podcasts in this genre.
string ("listen_score" | "oldest_added_first" | "oldest_published_first" | "recent_added_first" | "recent_published_first")
How do you want to sort these podcasts? If you”d like to sort by popularity, please use listen_score.
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.
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.
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.
integer
Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.
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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_A_LIST_OF_PODCAST_GENRESThe GetGenres endpoint retrieves a comprehensive list of available genres within the listennotestest platform. This endpoint is designed to provide users with up-to-date information on content categories, which can be used for filtering, organizing, or subscribing to specific types of content. It’s particularly useful for applications that need to populate genre-based dropdown menus, create content recommendation systems, or set up genre-specific notification preferences. The endpoint does not require any input parameters, making it simple to use for fetching the entire genre catalog. However, users should be aware that the response may contain a large amount of data, depending on the number of genres available in the system.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

integer
Just show top level genres? If 1, yes, just show top level genres. If 0, no, show all genres.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_A_LIST_OF_YOUR_PLAYLISTSRetrieves a paginated, sortable list of playlists associated with your Listen Notes account, including basic playlist metadata. Requires connecting your own Listen Notes account.

Input Parameters

integer
Page number of playlists.
string ("name_a_to_z" | "name_z_to_a" | "oldest_added_first" | "recent_added_first")
How do you want to sort playlists?

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_A_RANDOM_PODCAST_EPISODERetrieves a random podcast episode from Listen Notes, with episode metadata and associated podcast information.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_AUDIENCE_DEMOGRAPHICS_FOR_A_PODCASTRetrieves audience demographics for a podcast by ID, including audience distribution by region when available.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
Podcast id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_CURATED_LISTS_OF_PODCASTSRetrieves a page of curated podcast lists from Listen Notes, with list metadata and a preview of up to five podcasts in each list.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

integer
Page number of curated lists.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_DETAILED_META_DATA_FOR_AN_EPISODE_BY_IDRetrieves detailed information about a specific episode using its unique identifier. This endpoint allows users to access comprehensive data about an individual episode, which may include metadata such as title, description, publication date, duration, and associated podcast information. It’s particularly useful when you need to display or process information about a single episode. The endpoint should be used when detailed information about a known episode is required, but it won’t provide lists of episodes or search functionality. Note that the response structure and the exact fields returned are not specified in the given schema, so the actual content may vary based on the API implementation.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
id for a specific episode. You can get episode id from using other endpoints, e.g., GET /search…
integer
To include the transcript of this episode or not? If it is 1, then include the transcript in the transcript field. The default value is 0 - we don”t include transcript by default, because 1) it would make the response data very big, thus slow response time; 2) less than 1% of episodes have transcripts. The transcript field is available only in the PRO/ENTERPRISE plan.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_PODCAST_EPISODES_BY_IDRetrieves detailed metadata for a podcast by ID along with a page of its episodes. Episodes can be sorted and paginated using the returned publication-date cursor.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
Podcast id. You can get podcast id from using other endpoints, e.g., GET /search, GET /best_podcasts…
string ("oldest_first" | "recent_first")
How do you want to sort the episodes of this podcast?
integer
For episodes pagination. It”s the value of next_episode_pub_date from the response of last request. If not specified, just return latest 10 episodes or oldest 10 episodes, depending on the value of the sort parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_PODCAST_LANGUAGESRetrieves the list of supported podcast languages from Listen Notes for use in content filtering. The response contains a list of language names.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_PODCASTS_BY_A_PUBLISHER_S_DOMAIN_NAMERetrieves a list of podcasts associated with a specified domain name. This endpoint allows users to discover podcasts that are produced or hosted by a particular website or organization. It’s useful for content aggregation, competitive analysis, or finding podcasts related to specific brands or companies. The tool returns podcast information for the given domain, which may include multiple podcasts if the domain produces several shows. It should be used when you need to find all podcasts linked to a specific web domain. Note that this endpoint may not capture podcasts that are hosted on general podcast platforms unless they have a custom domain setup.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

integer
Page number of the podcasts from this domain name
string
required
A publisher”s domain name, e.g., nytimes.com, wondery.com, npr.org…

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_RECOMMENDATIONS_FOR_AN_EPISODERetrieves a list of recommended podcast episodes based on a specific episode ID. This endpoint utilizes the Listen Notes API to generate personalized content suggestions, helping users discover new episodes similar to ones they’ve already enjoyed. It’s ideal for enhancing user engagement and content discovery within podcast applications. The recommendations are likely based on factors such as episode content, listener behavior, and popularity. Use this endpoint when you want to provide users with tailored podcast suggestions or implement a “You might also like” feature. Note that the quality and relevance of recommendations may vary depending on the popularity and metadata of the source episode.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
Episode id.
integer
Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_RECOMMENDATIONS_FOR_A_PODCASTRetrieves a list of podcast recommendations based on a specified podcast ID. This endpoint is designed to help users discover new podcasts that are similar or related to a podcast they already enjoy. It can be used to enhance user experience by providing personalized content suggestions, increasing engagement, and broadening the listener’s podcast library. The recommendations are likely based on factors such as genre, topics, popularity, and listening patterns of users with similar interests. While this tool is excellent for content discovery, it should not be relied upon for comprehensive podcast information or metadata retrieval.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
Podcast id.
integer
Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FETCH_SUPPORTED_REGIONSRetrieves information about available regions in the listennotestest platform. This endpoint allows users to fetch a list of regions, which can be used for filtering content, setting up notifications, or managing regional preferences. It should be used when the client needs to know what regions are supported by the platform or when regional data is required for other operations. The endpoint returns basic details about each region, potentially including region codes, names, and any associated metadata. It does not provide detailed statistics or real-time data about events within these regions.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FIND_EPISODES_BY_TITLESearches for podcast episodes by title, optionally restricted to a specified podcast. Returns matching episode results.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
An episode”s title, e.g., Jerusalem Demsas on The Dispossessed. You can use double quotes to do verbatim match, e.g., “Jerusalem Demsas on The Dispossessed”. Otherwise, it”s fuzzy search.
string
Refine search results by specifying a podcast through its unique ID. The format of the podcast ID is governed by the podcast_id_type parameter. For listennotes_id, the podcast ID will look like “cda18f20f1be4ac7b3cce7d0eb168fff”. For itunes_id, it will be a numerical value like “983795625”. For spotify_id, expect a format like “0Z1234tGXD2hVhjFrrhJ7g”. For rss, the podcast ID will be the RSS URL, e.g., “https://cowenconvos.libsyn.com/rss”.
string ("itunes_id" | "listennotes_id" | "rss" | "spotify_id")
The type of podcast id. Valid values are listennotes_id, itunes_id, spotify_id, and rss. Note: itunes_id is for Apple Podcasts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_FULL_TEXT_SEARCHSearches Listen Notes for episodes, podcasts, or curated podcast lists using a text query. Supports filtering, sorting, and paginated results.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
Search term, e.g., person, place, topic… You can use double quotes to do verbatim match, e.g., “game of thrones”. Otherwise, it”s fuzzy search.
string
A comma-delimited string of podcast ids (up to 5 podcasts) - you can get a podcast id from the podcast_id field in response. This parameter is to exclude search results of a few specific podcasts. It works only when type is episode.
string
A comma-delimited string of podcast ids (up to 5 podcasts) - you can get a podcast id from the podcast_id field in response. This parameter is to limit search results from only a few specific podcasts. It works only when type is episode.
string ("curated" | "episode" | "podcast")
What type of contents do you want to search for?
integer
Offset for search results, for pagination. You”ll use next_offset from response for this parameter.
string
Limit search results to a specific region (e.g., us, gb, in…). If not specified, it”ll be any region. You can get the supported country codes from GET /regions. It works only when type is episode or podcast.
integer
Maximum audio length in minutes. Applicable only when type parameter is episode or podcast. If type parameter is episode, it”s for audio length of an episode. If type parameter is podcast, it”s for average audio length of all episodes in a podcast.
integer
Minimum audio length in minutes. Applicable only when type parameter is episode or podcast. If type parameter is episode, it”s for audio length of an episode. If type parameter is podcast, it”s for average audio length of all episodes in a podcast.
string
A comma-delimited string to search only in specific fields. Allowed values are title, description, author, and audio. If not specified, then search every fields.
string
Limit search results to a specific language. If not specified, it”ll be any language. You can get a list of supported languages from GET /languages. It works only when type is episode or podcast.
string
A comma-delimited string of a list of genre ids. If not specified, then all genres are included. You can find the id and the name of all genres from GET /genres. It works only when type is episode or podcast.
integer
The maximum number of search results per page. A valid value should be an integer between 1 and 10 (inclusive).
integer
Whether or not to exclude podcasts/episodes with explicit language. 1 is yes and 0 is no. It works only when type is episode or podcast.
integer
Sort by date or not? If 0, then sort by relevance. If 1, then sort by date.
integer
Whether or not to keep only podcasts that have sponsors in search results. 1 is yes and 0 is no. It works only when type is podcast. This parameter is available only in the PRO/ENTERPRISE plan.
integer
Whether or not to keep only podcasts that have guest interviews in search results. 1 is yes and 0 is no. It works only when type is podcast. This parameter is available only in the PRO/ENTERPRISE plan.
integer
Only show episodes/podcasts/curated lists published after this timestamp (in milliseconds). If published_before & published_after are used at the same time, published_before should be bigger than published_after.
integer
Whether or not to keep only one episode per podcast in search results. 1 is yes and 0 is no. It works only when type is episode.
integer
Maximum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find “weekly” podcasts, then you can set update_freq_min=144 hours (or 6 days) and update_freq_max=192 hours (or 8 days). Applicable only when type parameter is podcast.
integer
Minimum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find “weekly” podcasts, then you can set update_freq_min=144 hours (or 6 days) and update_freq_max=192 hours (or 8 days). Applicable only when type parameter is podcast.
integer
Only show episodes/podcasts/curated lists published before this timestamp (in milliseconds). If published_before & published_after are used at the same time, published_before should be bigger than published_after.
integer
Maximum number of episodes. Applicable only when type parameter is podcast.
integer
Minimum number of episodes. Applicable only when type parameter is podcast.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_GET_PLAYLIST_BY_IDRetrieves a playlist by ID, including its metadata and a sortable, paginated list of episode, custom audio, or podcast items. Requires connecting your own Listen Notes account.

Input Parameters

string
required
Playlist id (always 11 characters, e.g., m1pe7z60bsw). You can get the podcast id from the url of a playlist, e.g., m1pe7z60bsw is the playlist id of listennotes.com/listen/podcasts-about-podcasting-m1pe7z60bsw
string ("oldest_added_first" | "oldest_published_first" | "recent_added_first" | "recent_published_first")
How do you want to sort playlist items?
string ("episode_list" | "podcast_list")
The type of this playlist, which should be either episode_list or podcast_list.
integer
For playlist items pagination. It”s the value of last_timestamp_ms from the response of last request. If it”s 0 or not specified, just return the latest or the oldest 20 items, depending on the value of the sort parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_REFRESH_RSS_FEED_OF_A_PODCASTRequests an RSS feed refresh for a podcast by ID and returns the refresh status and last refresh timestamp when available. Requires a connected Listen Notes account; managed accounts cannot use this action.

Input Parameters

string
required
Podcast id. You can get podcast id from using other endpoints, e.g., GET /search, GET /best_podcasts…

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_REQUEST_TO_DELETE_A_PODCASTRequests deletion of a podcast by ID, optionally supplying a reason, and returns the request status. Requires a connected Listen Notes account; managed accounts cannot use this action.

Input Parameters

string
required
Podcast id. You can get podcast id from using other endpoints, e.g., GET /search, GET /best_podcasts…
string
The reason why this podcast should be deleted, e.g., copyright violation, the podcaster wants to delete it… You can put “testing” here to indicate that you are testing this endpoint, so we will not actually delete the podcast.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_SPELL_CHECK_ON_A_SEARCH_TERMChecks the spelling of a supplied search term and returns misspelled tokens, suggestions, and corrected text with HTML formatting.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
Search term, e.g., person, place, topic…

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_SUBMIT_A_PODCAST_TO_LISTEN_NOTES_DATABASESubmits a podcast RSS feed to the Listen Notes database, optionally providing an email for acceptance notifications; submission does not guarantee inclusion. Requires connecting your own Listen Notes account.

Input Parameters

string
required
A valid podcast rss url.
string
A valid email address. If email is specified, then we”ll notify this email address once the podcast is accepted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LISTENNOTES_TYPEAHEAD_SEARCHRetrieves typeahead search-term suggestions for a query, with optional podcast and genre suggestions. Podcast suggestions contain limited metadata.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API request

Input Parameters

string
required
Search term, e.g., person, place, topic… You can use double quotes to do verbatim match, e.g., “game of thrones”. Otherwise, it”s fuzzy search.
integer
Whether or not to exclude podcasts/episodes with explicit language. 1 is yes and 0 is no. It works only when show_podcasts is 1.
integer
Whether or not to autosuggest genres. 1 is yes, 0 is no.
integer
Autosuggest podcasts. This only searches podcast title and publisher and returns very limited info of 5 podcasts. 1 is yes, 0 is no. It”s a bit slow to autosuggest podcasts, so we turn it off by default. If show_podcasts=1, you can also pass iTunes id (e.g., 474722933) to the q parameter to fetch podcast meta data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not