- 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
Post episodes by ids
Post episodes by ids
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 requestInput Parameters
Output
Create podcast via form data
Create podcast via form data
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 requestInput Parameters
Output
Retrieve curated podcast by id
Retrieve curated podcast by id
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 requestInput Parameters
GET /search?type=curated or GET /curated_podcasts.Output
Fetch best podcasts list
Fetch best podcasts list
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 requestInput Parameters
GET /regions. If not specified, you”ll get “best podcasts” in United States.GET /genres. If not specified, it”ll be the overall best podcasts, which can be considered as a special genre.GET /languages. If not specified, you”ll get “best podcasts” in any language.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
Retrieve genre list
Retrieve genre list
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 requestInput Parameters
Output
Get playlists
Get playlists
Listen to just listen endpoint
Listen to just listen endpoint
Get podcast audience by id
Get podcast audience by id
Get curated podcasts
Get curated podcasts
Retrieve episode by id
Retrieve episode by id
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 requestInput Parameters
GET /search…Output
Fetch Podcast Details And Episodes
Fetch Podcast Details And Episodes
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 requestInput Parameters
GET /search, GET /best_podcasts…Output
Fetch podcast languages
Fetch podcast languages
Get podcast domains by name
Get podcast domains by name
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 requestInput Parameters
Output
Get episode recommendations by id
Get episode recommendations by id
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 requestInput Parameters
Output
Get podcast recommendations by id
Get podcast recommendations by id
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 requestInput Parameters
Output
Fetch Supported Regions
Fetch Supported Regions
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 requestOutput
Retrieve trending searches
Retrieve trending searches
LISTENNOTES_FETCH_TRENDING_SEARCH_TERMSRetrieves a list of currently trending search terms related to podcasts. This endpoint provides real-time insights into popular topics and interests among podcast listeners. It’s particularly useful for content creators, marketers, and researchers who want to stay updated on current trends in the podcast industry. The endpoint returns a curated list of search terms, likely ranked by popularity or recent search volume. While it offers valuable trend data, it does not provide detailed analytics or historical trend information. Users should be aware that the trending searches may change frequently and might be influenced by various factors such as current events, seasonal topics, or platform-specific promotions.Instant: Supported on the latest version.Instant pricing: $0.04 per successful API requestOutput
Search Episode Titles
Search Episode Titles
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 requestInput Parameters
Output
Search operation endpoint
Search operation endpoint
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 requestInput Parameters
GET /regions. It works only when type is episode or podcast.GET /languages. It works only when type is episode or podcast.GET /genres. It works only when type is episode or podcast.Output
Fetch Playlist Info
Fetch Playlist Info
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
Output
Post podcast rss by id
Post podcast rss by id
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
GET /search, GET /best_podcasts…Output
Delete podcast by id
Delete podcast by id
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
GET /search, GET /best_podcasts…Output
Spell check retrieval
Spell check retrieval
Submit podcast rss url
Submit podcast rss url
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
Output
Get typeahead suggestions
Get typeahead suggestions
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