> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Listen Notes

> Listen Notes is a powerful podcast search engine and database that allows you to discover, explore, and listen to millions of podcasts and episodes worldwide.

![Listen Notes logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/listennotes.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=f0025dbb94c36463b5912ba2688a5361)

* **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

> [accordion] Post episodes by ids
>
> **Slug:** `LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODES`
>
> Retrieves 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
>
> **ids** `string` *required*
>
> Comma-separated list of episode ids.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create podcast via form data
>
> **Slug:** `LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS`
>
> Retrieves 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
>
> **ids** `string`
>
> Comma-separated list of podcast ids.
>
> **rsses** `string`
>
> Comma-separated rss urls.
>
> **itunes\_ids** `string`
>
> Comma-separated Apple Podcasts (iTunes) ids, e.g., 659155419
>
> **spotify\_ids** `string`
>
> Comma-separated Spotify ids, e.g., 3DDfEsKDIDrTlnPOiG4ZF4
>
> **show\_latest\_episodes** `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.
>
> **next\_episode\_pub\_date** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve curated podcast by id
>
> **Slug:** `LISTENNOTES_FETCH_A_CURATED_LIST_OF_PODCASTS_BY_ID`
>
> Retrieves 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
>
> **id** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch best podcasts list
>
> **Slug:** `LISTENNOTES_FETCH_A_LIST_OF_BEST_PODCASTS_BY_GENRE`
>
> The 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
>
> **page** `integer`
>
> Page number of those podcasts in this genre.
>
> **sort** `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**.
>
> **region** `string`
>
> Filter best podcasts by country/region. Please note that podcasts that are "best" in a country/region may not be produced in that country/region. For example, a podcast from the US may be very popular in Canada. You can get the supported country codes (e.g., us, jp, gb...) from `GET /regions`. If not specified, you"ll get "best podcasts" in United States.
>
> **genre\_id** `string`
>
> You can get the id from `GET /genres`. If not specified, it"ll be the overall best podcasts, which can be considered as a special genre.
>
> **language** `string`
>
> Filter best podcasts by language. You can get a list of supported languages (e.g., English, Chinese, Japanese...) from `GET /languages`. If not specified, you"ll get "best podcasts" in any language.
>
> **safe\_mode** `integer`
>
> Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.
>
> **publisher\_region** `string`
>
> Filter best podcasts by the publisher"s country/region. This is to narrow down the results to include "best podcasts" produced in a specific country/region. You can get the supported country codes (e.g., us, jp, gb...) from `GET /regions`. If not specified, you"ll get "best podcasts" produced in any country/region. If you want to get a country/region"s "best podcasts" that are also produced in that country/region, then you need to specify both **region** and **publisher\_region**, e.g., `region=jp` and `publisher_region=jp`.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve genre list
>
> **Slug:** `LISTENNOTES_FETCH_A_LIST_OF_PODCAST_GENRES`
>
> The 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
>
> **top\_level\_only** `integer`
>
> Just show top level genres? If 1, yes, just show top level genres. If 0, no, show all genres.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get playlists
>
> **Slug:** `LISTENNOTES_FETCH_A_LIST_OF_YOUR_PLAYLISTS`
>
> Retrieves 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
>
> **page** `integer`
>
> Page number of playlists.
>
> **sort** `string ("name_a_to_z" | "name_z_to_a" | "oldest_added_first" | "recent_added_first")`
>
> How do you want to sort playlists?
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Listen to just listen endpoint
>
> **Slug:** `LISTENNOTES_FETCH_A_RANDOM_PODCAST_EPISODE`
>
> Retrieves 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get podcast audience by id
>
> **Slug:** `LISTENNOTES_FETCH_AUDIENCE_DEMOGRAPHICS_FOR_A_PODCAST`
>
> Retrieves 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
>
> **id** `string` *required*
>
> Podcast id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get curated podcasts
>
> **Slug:** `LISTENNOTES_FETCH_CURATED_LISTS_OF_PODCASTS`
>
> Retrieves 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
>
> **page** `integer`
>
> Page number of curated lists.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve episode by id
>
> **Slug:** `LISTENNOTES_FETCH_DETAILED_META_DATA_FOR_AN_EPISODE_BY_ID`
>
> Retrieves 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
>
> **id** `string` *required*
>
> id for a specific episode. You can get episode id from using other endpoints, e.g., `GET /search`...
>
> **show\_transcript** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch Podcast Details And Episodes
>
> **Slug:** `LISTENNOTES_FETCH_PODCAST_EPISODES_BY_ID`
>
> Retrieves 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
>
> **id** `string` *required*
>
> Podcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`...
>
> **sort** `string ("oldest_first" | "recent_first")`
>
> How do you want to sort the episodes of this podcast?
>
> **next\_episode\_pub\_date** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch podcast languages
>
> **Slug:** `LISTENNOTES_FETCH_PODCAST_LANGUAGES`
>
> Retrieves 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get podcast domains by name
>
> **Slug:** `LISTENNOTES_FETCH_PODCASTS_BY_A_PUBLISHER_S_DOMAIN_NAME`
>
> Retrieves 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
>
> **page** `integer`
>
> Page number of the podcasts from this domain name
>
> **domain\_name** `string` *required*
>
> A publisher"s domain name, e.g., nytimes.com, wondery.com, npr.org...
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get episode recommendations by id
>
> **Slug:** `LISTENNOTES_FETCH_RECOMMENDATIONS_FOR_AN_EPISODE`
>
> Retrieves 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
>
> **id** `string` *required*
>
> Episode id.
>
> **safe\_mode** `integer`
>
> Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get podcast recommendations by id
>
> **Slug:** `LISTENNOTES_FETCH_RECOMMENDATIONS_FOR_A_PODCAST`
>
> Retrieves 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
>
> **id** `string` *required*
>
> Podcast id.
>
> **safe\_mode** `integer`
>
> Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch related searches data
>
> **Slug:** `LISTENNOTES_FETCH_RELATED_SEARCH_TERMS`
>
> Retrieves search terms related to a supplied search query.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0.04 per successful API request
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Search term, e.g., person, place, topic...
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch Supported Regions
>
> **Slug:** `LISTENNOTES_FETCH_SUPPORTED_REGIONS`
>
> Retrieves 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve trending searches
>
> **Slug:** `LISTENNOTES_FETCH_TRENDING_SEARCH_TERMS`
>
> Retrieves 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 request
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Episode Titles
>
> **Slug:** `LISTENNOTES_FIND_EPISODES_BY_TITLE`
>
> Searches 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
>
> **q** `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.
>
> **podcast\_id** `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](https://cowenconvos.libsyn.com/rss)".
>
> **podcast\_id\_type** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search operation endpoint
>
> **Slug:** `LISTENNOTES_FULL_TEXT_SEARCH`
>
> Searches 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
>
> **q** `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.
>
> **ncid** `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*.
>
> **ocid** `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*.
>
> **type** `string ("curated" | "episode" | "podcast")`
>
> What type of contents do you want to search for?
>
> **offset** `integer`
>
> Offset for search results, for pagination. You"ll use **next\_offset** from response for this parameter.
>
> **region** `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*.
>
> **len\_max** `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.
>
> **len\_min** `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.
>
> **only\_in** `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.
>
> **language** `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*.
>
> **genre\_ids** `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*.
>
> **page\_size** `integer`
>
> The maximum number of search results per page. A valid value should be an integer between 1 and 10 (inclusive).
>
> **safe\_mode** `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*.
>
> **sort\_by\_date** `integer`
>
> Sort by date or not? If 0, then sort by relevance. If 1, then sort by date.
>
> **sponsored\_only** `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.
>
> **interviews\_only** `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.
>
> **published\_after** `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**.
>
> **unique\_podcasts** `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*.
>
> **update\_freq\_max** `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**.
>
> **update\_freq\_min** `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**.
>
> **published\_before** `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**.
>
> **episode\_count\_max** `integer`
>
> Maximum number of episodes. Applicable only when type parameter is **podcast**.
>
> **episode\_count\_min** `integer`
>
> Minimum number of episodes. Applicable only when type parameter is **podcast**.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch Playlist Info
>
> **Slug:** `LISTENNOTES_GET_PLAYLIST_BY_ID`
>
> Retrieves 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
>
> **id** `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
>
> **sort** `string ("oldest_added_first" | "oldest_published_first" | "recent_added_first" | "recent_published_first")`
>
> How do you want to sort playlist items?
>
> **type** `string ("episode_list" | "podcast_list")`
>
> The type of this playlist, which should be either **episode\_list** or **podcast\_list**.
>
> **last\_timestamp\_ms** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Post podcast rss by id
>
> **Slug:** `LISTENNOTES_REFRESH_RSS_FEED_OF_A_PODCAST`
>
> Requests 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
>
> **id** `string` *required*
>
> Podcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`...
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete podcast by id
>
> **Slug:** `LISTENNOTES_REQUEST_TO_DELETE_A_PODCAST`
>
> Requests 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
>
> **id** `string` *required*
>
> Podcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`...
>
> **reason** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Spell check retrieval
>
> **Slug:** `LISTENNOTES_SPELL_CHECK_ON_A_SEARCH_TERM`
>
> Checks 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
>
> **q** `string` *required*
>
> Search term, e.g., person, place, topic...
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit podcast rss url
>
> **Slug:** `LISTENNOTES_SUBMIT_A_PODCAST_TO_LISTEN_NOTES_DATABASE`
>
> Submits 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
>
> **rss** `string` *required*
>
> A valid podcast rss url.
>
> **email** `string`
>
> A valid email address. If **email** is specified, then we"ll notify this email address once the podcast is accepted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get typeahead suggestions
>
> **Slug:** `LISTENNOTES_TYPEAHEAD_SEARCH`
>
> Retrieves 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
>
> **q** `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.
>
> **safe\_mode** `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*.
>
> **show\_genres** `integer`
>
> Whether or not to autosuggest genres. 1 is yes, 0 is no.
>
> **show\_podcasts** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
