Listen Notes
listennotesListen Notes is a powerful podcast search engine and database that allows you to discover, explore, and listen to millions of podcasts and episodes worldwide.
Acciones disponibles (26)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Post episodes by idsLISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODESAcciónThe listennotestest episodes post endpoint allows users to retrieve metadata for multiple podcast episodes in a single request. this post endpoint accepts a list of episode ids and returns detailed information about each specified episode. it's particularly useful for bulk retrieval of episode data, reducing the number of api calls needed when working with multiple episodes. the endpoint should be used when you need to fetch information about specific, known episodes rather than searching or browsing. keep in mind that this endpoint is focused on retrieval only and does not support creating, updating, or deleting episode data.
LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODESAcciónThe listennotestest episodes post endpoint allows users to retrieve metadata for multiple podcast episodes in a single request. this post endpoint accepts a list of episode ids and returns detailed information about each specified episode. it's particularly useful for bulk retrieval of episode data, reducing the number of api calls needed when working with multiple episodes. the endpoint should be used when you need to fetch information about specific, known episodes rather than searching or browsing. keep in mind that this endpoint is focused on retrieval only and does not support creating, updating, or deleting episode data.
Parámetros de entrada
idsstringObligatorioComma-separated list of episode ids.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create podcast via form dataLISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTSAcciónThe listennotestest podcasts post endpoint allows users to retrieve information about multiple podcasts using various identifiers such as listen notes ids, rss feed urls, apple podcasts ids, or spotify ids. it can optionally fetch the latest episodes for the specified podcasts. this endpoint is useful for bulk podcast data retrieval and for staying updated on recent episodes across multiple shows. it's particularly valuable for applications that need to sync or update podcast information from different platforms. the endpoint has a limit of returning up to 15 latest episodes per request, so for comprehensive episode history, multiple calls may be necessary.
LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTSAcciónThe listennotestest podcasts post endpoint allows users to retrieve information about multiple podcasts using various identifiers such as listen notes ids, rss feed urls, apple podcasts ids, or spotify ids. it can optionally fetch the latest episodes for the specified podcasts. this endpoint is useful for bulk podcast data retrieval and for staying updated on recent episodes across multiple shows. it's particularly valuable for applications that need to sync or update podcast information from different platforms. the endpoint has a limit of returning up to 15 latest episodes per request, so for comprehensive episode history, multiple calls may be necessary.
Parámetros de entrada
idsstringComma-separated list of podcast ids.
rssesstringComma-separated rss urls.
itunes_idsstringComma-separated Apple Podcasts (iTunes) ids, e.g., 659155419
spotify_idsstringComma-separated Spotify ids, e.g., 3DDfEsKDIDrTlnPOiG4ZF4
show_latest_episodesintegerWhether or not to fetch up to 15 latest episodes from these podcasts, sorted by pub_date. 1 is yes, and 0 is no.
next_episode_pub_dateintegerFor 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.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve curated podcast by idLISTENNOTES_FETCH_A_CURATED_LIST_OF_PODCASTS_BY_IDAcciónRetrieves 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.
LISTENNOTES_FETCH_A_CURATED_LIST_OF_PODCASTS_BY_IDAcciónRetrieves 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.
Parámetros de entrada
idstringObligatorioid for a specific curated list of podcasts. You can get the id from the response of `GET /search?type=curated` or `GET /curated_podcasts`.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch best podcasts listLISTENNOTES_FETCH_A_LIST_OF_BEST_PODCASTS_BY_GENREAcciónThe 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.
LISTENNOTES_FETCH_A_LIST_OF_BEST_PODCASTS_BY_GENREAcciónThe 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.
Parámetros de entrada
pageintegerPage number of those podcasts in this genre.
sortstringenumHow do you want to sort these podcasts? If you"d like to sort by popularity, please use **listen_score**.
listen_scoreoldest_added_firstoldest_published_firstrecent_added_firstrecent_published_firstregionstringFilter 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.
genre_idstringYou 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.
languagestringFilter 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.
safe_modeintegerWhether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.
publisher_regionstringFilter 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`.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve genre listLISTENNOTES_FETCH_A_LIST_OF_PODCAST_GENRESAcciónThe 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.
LISTENNOTES_FETCH_A_LIST_OF_PODCAST_GENRESAcciónThe 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.
Parámetros de entrada
top_level_onlyintegerJust show top level genres? If 1, yes, just show top level genres. If 0, no, show all genres.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get playlistsLISTENNOTES_FETCH_A_LIST_OF_YOUR_PLAYLISTSAcciónRetrieves a list of playlists from the listen notes platform. this endpoint allows users to fetch all available playlists associated with their account or publicly accessible playlists. it should be used when you need to display a collection of playlists, such as in a user's library or for browsing purposes. the endpoint returns basic information about each playlist, which may include the playlist name, creator, number of episodes, and other relevant metadata. note that this endpoint likely returns a limited number of playlists per request, and pagination might be necessary for retrieving large collections. it does not provide detailed information about the episodes within each playlist; separate api calls would be required to fetch that level of detail.
LISTENNOTES_FETCH_A_LIST_OF_YOUR_PLAYLISTSAcciónRetrieves a list of playlists from the listen notes platform. this endpoint allows users to fetch all available playlists associated with their account or publicly accessible playlists. it should be used when you need to display a collection of playlists, such as in a user's library or for browsing purposes. the endpoint returns basic information about each playlist, which may include the playlist name, creator, number of episodes, and other relevant metadata. note that this endpoint likely returns a limited number of playlists per request, and pagination might be necessary for retrieving large collections. it does not provide detailed information about the episodes within each playlist; separate api calls would be required to fetch that level of detail.
Parámetros de entrada
pageintegerPage number of playlists.
sortstringenumHow do you want to sort playlists?
name_a_to_zname_z_to_aoldest_added_firstrecent_added_first
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Listen to just listen endpointLISTENNOTES_FETCH_A_RANDOM_PODCAST_EPISODEAcciónThe 'just listen' endpoint is a basic listener or health check mechanism for the listennotestest app. it allows users to verify the availability and responsiveness of the service without requiring any input parameters. this endpoint should be used for monitoring the status of the listennotestest service or as a simple ping to ensure the api is operational. it's important to note that this endpoint likely doesn't provide any specific data about podcasts or user accounts. the response is expected to be minimal, possibly just confirming that the service is up and running. while useful for basic health checks, it should not be relied upon for any complex operations or data retrieval within the listennotestest ecosystem.
LISTENNOTES_FETCH_A_RANDOM_PODCAST_EPISODEAcciónThe 'just listen' endpoint is a basic listener or health check mechanism for the listennotestest app. it allows users to verify the availability and responsiveness of the service without requiring any input parameters. this endpoint should be used for monitoring the status of the listennotestest service or as a simple ping to ensure the api is operational. it's important to note that this endpoint likely doesn't provide any specific data about podcasts or user accounts. the response is expected to be minimal, possibly just confirming that the service is up and running. while useful for basic health checks, it should not be relied upon for any complex operations or data retrieval within the listennotestest ecosystem.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get podcast audience by idLISTENNOTES_FETCH_AUDIENCE_DEMOGRAPHICS_FOR_A_PODCASTAcciónRetrieves audience information for a specific podcast identified by its unique id. this endpoint allows users to access demographic data, listening statistics, or other audience-related metrics for a particular podcast. it's useful for podcast creators, marketers, or analysts who want to understand their audience better or track the performance of their content. the tool returns aggregated data about the podcast's listeners, which may include but is not limited to age groups, geographic distribution, listening habits, or engagement metrics. it should be used when detailed audience insights for a specific podcast are needed. note that this endpoint does not provide real-time listener counts or individual listener data to protect user privacy.
LISTENNOTES_FETCH_AUDIENCE_DEMOGRAPHICS_FOR_A_PODCASTAcciónRetrieves audience information for a specific podcast identified by its unique id. this endpoint allows users to access demographic data, listening statistics, or other audience-related metrics for a particular podcast. it's useful for podcast creators, marketers, or analysts who want to understand their audience better or track the performance of their content. the tool returns aggregated data about the podcast's listeners, which may include but is not limited to age groups, geographic distribution, listening habits, or engagement metrics. it should be used when detailed audience insights for a specific podcast are needed. note that this endpoint does not provide real-time listener counts or individual listener data to protect user privacy.
Parámetros de entrada
idstringObligatorioPodcast id.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get curated podcastsLISTENNOTES_FETCH_CURATED_LISTS_OF_PODCASTSAcciónRetrieves a list of curated podcasts from the listen notes platform. this endpoint provides access to a collection of handpicked and organized podcasts, likely curated by experts or algorithms. it's useful for discovering high-quality content or featuring recommended podcasts to users. the endpoint returns a selection of podcasts, possibly grouped by themes, genres, or other criteria. while it offers a curated selection, it may not provide exhaustive search capabilities or personalized recommendations based on individual user preferences.
LISTENNOTES_FETCH_CURATED_LISTS_OF_PODCASTSAcciónRetrieves a list of curated podcasts from the listen notes platform. this endpoint provides access to a collection of handpicked and organized podcasts, likely curated by experts or algorithms. it's useful for discovering high-quality content or featuring recommended podcasts to users. the endpoint returns a selection of podcasts, possibly grouped by themes, genres, or other criteria. while it offers a curated selection, it may not provide exhaustive search capabilities or personalized recommendations based on individual user preferences.
Parámetros de entrada
pageintegerPage number of curated lists.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve episode by idLISTENNOTES_FETCH_DETAILED_META_DATA_FOR_AN_EPISODE_BY_IDAcciónRetrieves 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.
LISTENNOTES_FETCH_DETAILED_META_DATA_FOR_AN_EPISODE_BY_IDAcciónRetrieves 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.
Parámetros de entrada
idstringObligatorioid for a specific episode. You can get episode id from using other endpoints, e.g., `GET /search`...
show_transcriptintegerTo 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.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch Podcast Details And EpisodesLISTENNOTES_FETCH_PODCAST_EPISODES_BY_IDAcciónRetrieves detailed information about a specific podcast using its unique identifier. this endpoint allows users to fetch comprehensive data about a particular podcast, including but not limited to its title, description, author, episode list, and other metadata. it's ideal for applications that need to display in-depth information about a single podcast or integrate podcast data into their systems. the endpoint should be used when detailed information about a known podcast is required, rather than for searching or browsing multiple podcasts. note that this endpoint only provides information for podcasts that exist within the listen notes database and may not include real-time updates for very recent changes to the podcast.
LISTENNOTES_FETCH_PODCAST_EPISODES_BY_IDAcciónRetrieves detailed information about a specific podcast using its unique identifier. this endpoint allows users to fetch comprehensive data about a particular podcast, including but not limited to its title, description, author, episode list, and other metadata. it's ideal for applications that need to display in-depth information about a single podcast or integrate podcast data into their systems. the endpoint should be used when detailed information about a known podcast is required, rather than for searching or browsing multiple podcasts. note that this endpoint only provides information for podcasts that exist within the listen notes database and may not include real-time updates for very recent changes to the podcast.
Parámetros de entrada
idstringObligatorioPodcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`...
sortstringenumHow do you want to sort the episodes of this podcast?
oldest_firstrecent_firstnext_episode_pub_dateintegerFor 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.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch podcast languagesLISTENNOTES_FETCH_PODCAST_LANGUAGESAcciónRetrieves a list of supported languages in the listen notes api. this endpoint provides information about the languages available for use within the platform, which can be crucial for internationalization and localization efforts. use this endpoint when you need to know which languages are supported by the api, such as for filtering content or setting user preferences. the response likely includes language codes and possibly their corresponding names or additional metadata. note that this endpoint doesn't accept any parameters, offering a static list of supported languages.
LISTENNOTES_FETCH_PODCAST_LANGUAGESAcciónRetrieves a list of supported languages in the listen notes api. this endpoint provides information about the languages available for use within the platform, which can be crucial for internationalization and localization efforts. use this endpoint when you need to know which languages are supported by the api, such as for filtering content or setting user preferences. the response likely includes language codes and possibly their corresponding names or additional metadata. note that this endpoint doesn't accept any parameters, offering a static list of supported languages.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get podcast domains by nameLISTENNOTES_FETCH_PODCASTS_BY_A_PUBLISHER_S_DOMAIN_NAMEAcciónRetrieves 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.
LISTENNOTES_FETCH_PODCASTS_BY_A_PUBLISHER_S_DOMAIN_NAMEAcciónRetrieves 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.
Parámetros de entrada
pageintegerPage number of the podcasts from this domain name
domain_namestringObligatorioA publisher"s domain name, e.g., nytimes.com, wondery.com, npr.org...
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get episode recommendations by idLISTENNOTES_FETCH_RECOMMENDATIONS_FOR_AN_EPISODEAcciónRetrieves 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.
LISTENNOTES_FETCH_RECOMMENDATIONS_FOR_AN_EPISODEAcciónRetrieves 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.
Parámetros de entrada
idstringObligatorioEpisode id.
safe_modeintegerWhether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get podcast recommendations by idLISTENNOTES_FETCH_RECOMMENDATIONS_FOR_A_PODCASTAcciónRetrieves 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.
LISTENNOTES_FETCH_RECOMMENDATIONS_FOR_A_PODCASTAcciónRetrieves 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.
Parámetros de entrada
idstringObligatorioPodcast id.
safe_modeintegerWhether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch related searches dataLISTENNOTES_FETCH_RELATED_SEARCH_TERMSAcciónRetrieves a list of related search queries based on the current context or user's recent search activity. this endpoint is useful for enhancing user experience by suggesting alternative or complementary search terms, potentially increasing engagement and discovery within the platform. it should be used when you want to provide users with additional search options or ideas related to their current interests or queries. the endpoint does not require any explicit parameters, relying instead on server-side logic to determine the context for generating related searches. note that the specific algorithm for generating related searches and the format of the response are not detailed in the schema, so integrators should be prepared to handle various response structures.
LISTENNOTES_FETCH_RELATED_SEARCH_TERMSAcciónRetrieves a list of related search queries based on the current context or user's recent search activity. this endpoint is useful for enhancing user experience by suggesting alternative or complementary search terms, potentially increasing engagement and discovery within the platform. it should be used when you want to provide users with additional search options or ideas related to their current interests or queries. the endpoint does not require any explicit parameters, relying instead on server-side logic to determine the context for generating related searches. note that the specific algorithm for generating related searches and the format of the response are not detailed in the schema, so integrators should be prepared to handle various response structures.
Parámetros de entrada
qstringObligatorioSearch term, e.g., person, place, topic...
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch Supported RegionsLISTENNOTES_FETCH_SUPPORTED_REGIONSAcciónRetrieves 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.
LISTENNOTES_FETCH_SUPPORTED_REGIONSAcciónRetrieves 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.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Retrieve trending searchesLISTENNOTES_FETCH_TRENDING_SEARCH_TERMSAcciónRetrieves 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.
LISTENNOTES_FETCH_TRENDING_SEARCH_TERMSAcciónRetrieves 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.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Search Episode TitlesLISTENNOTES_FIND_EPISODES_BY_TITLEAcciónThe search episode titles endpoint allows users to search for and retrieve episode titles based on specified criteria. it provides a powerful way to find relevant episodes quickly, supporting real-time updates and notifications for changes in episode titles. this endpoint is particularly useful for applications that need to display or monitor podcast content, offering up-to-date information on episode titles across various shows or categories. while it excels at title searches, it may not provide full episode details or content, focusing primarily on the title information.
LISTENNOTES_FIND_EPISODES_BY_TITLEAcciónThe search episode titles endpoint allows users to search for and retrieve episode titles based on specified criteria. it provides a powerful way to find relevant episodes quickly, supporting real-time updates and notifications for changes in episode titles. this endpoint is particularly useful for applications that need to display or monitor podcast content, offering up-to-date information on episode titles across various shows or categories. while it excels at title searches, it may not provide full episode details or content, focusing primarily on the title information.
Parámetros de entrada
qstringObligatorioAn 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.
podcast_idstringRefine 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".
podcast_id_typestringenumThe type of podcast id. Valid values are **listennotes_id**, **itunes_id**, **spotify_id**, and **rss**. Note: **itunes_id** is for Apple Podcasts.
itunes_idlistennotes_idrssspotify_id
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Search operation endpointLISTENNOTES_FULL_TEXT_SEARCHAcciónThe search endpoint allows users to query notifications or events within the listennotestest platform. it provides a way to find specific notifications based on keywords or identifiers, helping users locate relevant information quickly. this get request likely returns a list of matching notifications or events, which can be useful for monitoring specific activities or retrieving historical data. the endpoint supports basic search functionality and potentially includes options for pagination and sorting to manage large result sets efficiently.
LISTENNOTES_FULL_TEXT_SEARCHAcciónThe search endpoint allows users to query notifications or events within the listennotestest platform. it provides a way to find specific notifications based on keywords or identifiers, helping users locate relevant information quickly. this get request likely returns a list of matching notifications or events, which can be useful for monitoring specific activities or retrieving historical data. the endpoint supports basic search functionality and potentially includes options for pagination and sorting to manage large result sets efficiently.
Parámetros de entrada
qstringObligatorioSearch 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.
ncidstringA 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*.
ocidstringA 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*.
typestringenumWhat type of contents do you want to search for?
curatedepisodepodcastoffsetintegerOffset for search results, for pagination. You"ll use **next_offset** from response for this parameter.
regionstringLimit 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*.
len_maxintegerMaximum 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.
len_minintegerMinimum 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.
only_instringA comma-delimited string to search only in specific fields. Allowed values are title, description, author, and audio. If not specified, then search every fields.
languagestringLimit 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*.
genre_idsstringA 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*.
page_sizeintegerThe maximum number of search results per page. A valid value should be an integer between 1 and 10 (inclusive).
safe_modeintegerWhether 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*.
sort_by_dateintegerSort by date or not? If 0, then sort by relevance. If 1, then sort by date.
sponsored_onlyintegerWhether 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.
interviews_onlyintegerWhether 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.
published_afterintegerOnly 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**.
unique_podcastsintegerWhether 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*.
update_freq_maxintegerMaximum 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**.
update_freq_minintegerMinimum 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**.
published_beforeintegerOnly 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**.
episode_count_maxintegerMaximum number of episodes. Applicable only when type parameter is **podcast**.
episode_count_minintegerMinimum number of episodes. Applicable only when type parameter is **podcast**.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Fetch Playlist InfoLISTENNOTES_GET_PLAYLIST_BY_IDAcciónRetrieves detailed information about a specific playlist using its unique identifier. this endpoint allows users to fetch comprehensive data about a playlist, including its name, description, creator, tracks, and other relevant metadata. it's particularly useful when you need to display or process information about a known playlist. the endpoint should be used when you have the playlist's id and require its current, up-to-date details. note that this endpoint only provides read access to playlist data and does not allow for modifications. it may not include real-time listening statistics or user-specific interaction data with the playlist.
LISTENNOTES_GET_PLAYLIST_BY_IDAcciónRetrieves detailed information about a specific playlist using its unique identifier. this endpoint allows users to fetch comprehensive data about a playlist, including its name, description, creator, tracks, and other relevant metadata. it's particularly useful when you need to display or process information about a known playlist. the endpoint should be used when you have the playlist's id and require its current, up-to-date details. note that this endpoint only provides read access to playlist data and does not allow for modifications. it may not include real-time listening statistics or user-specific interaction data with the playlist.
Parámetros de entrada
idstringObligatorioPlaylist 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
sortstringenumHow do you want to sort playlist items?
oldest_added_firstoldest_published_firstrecent_added_firstrecent_published_firsttypestringenumThe type of this playlist, which should be either **episode_list** or **podcast_list**.
episode_listpodcast_listlast_timestamp_msintegerFor 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.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Post podcast rss by idLISTENNOTES_REFRESH_RSS_FEED_OF_A_PODCASTAcciónRetrieves or generates an rss feed for a specific podcast identified by its unique id. this endpoint allows users to access the podcast's content in a standardized rss format, which can be used for syndication or integration with podcast players and aggregators. the rss feed typically includes information such as episode titles, descriptions, publication dates, and audio file urls. use this endpoint when you need to programmatically access a podcast's rss feed, for example, to set up notifications for new episodes or to integrate the podcast content into another application. note that this endpoint does not create or modify the podcast itself; it only provides access to the existing podcast data in rss format.
LISTENNOTES_REFRESH_RSS_FEED_OF_A_PODCASTAcciónRetrieves or generates an rss feed for a specific podcast identified by its unique id. this endpoint allows users to access the podcast's content in a standardized rss format, which can be used for syndication or integration with podcast players and aggregators. the rss feed typically includes information such as episode titles, descriptions, publication dates, and audio file urls. use this endpoint when you need to programmatically access a podcast's rss feed, for example, to set up notifications for new episodes or to integrate the podcast content into another application. note that this endpoint does not create or modify the podcast itself; it only provides access to the existing podcast data in rss format.
Parámetros de entrada
idstringObligatorioPodcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`...
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete podcast by idLISTENNOTES_REQUEST_TO_DELETE_A_PODCASTAcciónDeletes a specific podcast from the system based on its unique identifier. this endpoint should be used when you want to permanently remove a podcast and all its associated data from the platform. it's important to note that this action is irreversible, so it should be used with caution. once a podcast is deleted, it cannot be recovered, and all related notifications and updates for that podcast will cease. this endpoint is typically used for managing outdated content, removing test data, or complying with content removal requests.
LISTENNOTES_REQUEST_TO_DELETE_A_PODCASTAcciónDeletes a specific podcast from the system based on its unique identifier. this endpoint should be used when you want to permanently remove a podcast and all its associated data from the platform. it's important to note that this action is irreversible, so it should be used with caution. once a podcast is deleted, it cannot be recovered, and all related notifications and updates for that podcast will cease. this endpoint is typically used for managing outdated content, removing test data, or complying with content removal requests.
Parámetros de entrada
idstringObligatorioPodcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`...
reasonstringThe 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.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Spell check retrievalLISTENNOTES_SPELL_CHECK_ON_A_SEARCH_TERMAcciónThe spellcheck endpoint provides a spell-checking service for text input. it allows users to verify the spelling of words or phrases, likely related to audio content or podcast descriptions within the listennotestest platform. this tool should be used when there's a need to ensure the correctness of textual content, such as titles, descriptions, or tags associated with audio files or podcasts. the endpoint doesn't specify any parameters, suggesting it might use query parameters for input or have a default behavior. it's important to note that without more specific information, the exact input method and response format are not clear, which may require additional documentation or testing to fully understand its usage.
LISTENNOTES_SPELL_CHECK_ON_A_SEARCH_TERMAcciónThe spellcheck endpoint provides a spell-checking service for text input. it allows users to verify the spelling of words or phrases, likely related to audio content or podcast descriptions within the listennotestest platform. this tool should be used when there's a need to ensure the correctness of textual content, such as titles, descriptions, or tags associated with audio files or podcasts. the endpoint doesn't specify any parameters, suggesting it might use query parameters for input or have a default behavior. it's important to note that without more specific information, the exact input method and response format are not clear, which may require additional documentation or testing to fully understand its usage.
Parámetros de entrada
qstringObligatorioSearch term, e.g., person, place, topic...
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Submit podcast rss urlLISTENNOTES_SUBMIT_A_PODCAST_TO_LISTEN_NOTES_DATABASEAcciónThe submit podcast endpoint allows users to submit a podcast for inclusion in the listen notes database. this tool should be used when a user wants to add a new podcast to the listen notes platform or update an existing podcast's information. it requires the rss feed url of the podcast and optionally accepts an email address for status notifications. the endpoint is designed for simplicity, focusing solely on podcast submission without providing additional podcast management features. note that submission does not guarantee immediate inclusion; podcasts are subject to review before being added to the database.
LISTENNOTES_SUBMIT_A_PODCAST_TO_LISTEN_NOTES_DATABASEAcciónThe submit podcast endpoint allows users to submit a podcast for inclusion in the listen notes database. this tool should be used when a user wants to add a new podcast to the listen notes platform or update an existing podcast's information. it requires the rss feed url of the podcast and optionally accepts an email address for status notifications. the endpoint is designed for simplicity, focusing solely on podcast submission without providing additional podcast management features. note that submission does not guarantee immediate inclusion; podcasts are subject to review before being added to the database.
Parámetros de entrada
rssstringObligatorioA valid podcast rss url.
emailstringA valid email address. If **email** is specified, then we"ll notify this email address once the podcast is accepted.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get typeahead suggestionsLISTENNOTES_TYPEAHEAD_SEARCHAcciónThe typeahead endpoint provides real-time search suggestions as users type their queries. it's designed to enhance the user experience by offering relevant autocomplete options, making it easier for users to find podcasts, episodes, or other content on the listen notes platform. this endpoint should be used to implement a dynamic search box that updates suggestions with each keystroke. it's particularly useful for improving search efficiency and accuracy by guiding users towards valid search terms. the endpoint likely returns a json array of matching results, which may include basic information like titles, ids, and possibly thumbnail images for each suggestion. it's important to note that this endpoint is intended for quick, lightweight suggestions and may not provide full details about each result - for comprehensive information, additional api calls might be necessary.
LISTENNOTES_TYPEAHEAD_SEARCHAcciónThe typeahead endpoint provides real-time search suggestions as users type their queries. it's designed to enhance the user experience by offering relevant autocomplete options, making it easier for users to find podcasts, episodes, or other content on the listen notes platform. this endpoint should be used to implement a dynamic search box that updates suggestions with each keystroke. it's particularly useful for improving search efficiency and accuracy by guiding users towards valid search terms. the endpoint likely returns a json array of matching results, which may include basic information like titles, ids, and possibly thumbnail images for each suggestion. it's important to note that this endpoint is intended for quick, lightweight suggestions and may not provide full details about each result - for comprehensive information, additional api calls might be necessary.
Parámetros de entrada
qstringObligatorioSearch 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.
safe_modeintegerWhether or not to exclude podcasts/episodes with explicit language. 1 is yes and 0 is no. It works only when **show_podcasts** is *1*.
show_genresintegerWhether or not to autosuggest genres. 1 is yes, 0 is no.
show_podcastsintegerAutosuggest 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.
Parámetros de salida
dataobjectObligatorioThe response schema
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not