{"openapi":"3.1.0","servers":[{"description":"API Production Server","url":"https://listen-api.listennotes.com/api/v2"}],"info":{"contact":{"email":"hello@listennotes.com","name":"Listen Notes","url":"https://www.listennotes.com/api/","x-twitter":"listennotes"},"description":"Simple & no-nonsense podcast search & directory API. Search all podcasts and episodes by people, places, or topics.\n","termsOfService":"https://www.listennotes.com/api/terms/","title":"Listen API: Podcast Search, Directory, and Insights API","version":"2.0","x-apisguru-categories":["entertainment"],"x-logo":{"url":"https://twitter.com/listennotes/profile_image?size=original"},"x-origin":[{"converter":{"url":"https://github.com/mermade/oas-kit","version":"7.0.4"},"format":"openapi","url":"https://listen-api.listennotes.com/api/v2/openapi.yaml","version":"3.1"}],"x-providerName":"listennotes.com"},"tags":[{"description":"Endpoints to search podcasts","name":"Search API"},{"description":"Endpoints to fetch podcasts data","name":"Directory API"},{"description":"Endpoints to fetch Listen Later playlists data","name":"Playlist API"},{"description":"Endpoints to improve the podcast database","name":"Podcaster API"},{"description":"Endpoints to get insights of podcasts, e.g., audience demographics","name":"Insights API"}],"paths":{"/best_podcasts":{"get":{"description":"Get a list of curated best podcasts by genre,\nwhich are curated by Listen Notes staffs based on various signals from the Internet, e.g.,\ntop charts on other podcast platforms, recommendations from mainstream media,\nuser activities on listennotes.com...\nYou can get the genre ids from `GET /genres` endpoint.\nThis endpoint returns same data as https://www.listennotes.com/best-podcasts/\n","operationId":"getBestPodcasts","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"$ref":"#/components/parameters/genreIdParam"},{"description":"Page number of those podcasts in this genre.","in":"query","name":"page","required":false,"schema":{"examples":[2],"type":"integer"}},{"description":"Filter best podcasts by country/region.\nPlease note that podcasts that are \"best\" in a country/region may not be produced in that country/region.\nFor example, a podcast from the US may be very popular in Canada.\nYou can get the supported country codes (e.g., us, jp, gb...) from `GET /regions`.\nIf not specified, you'll get \"best podcasts\" in United States.\n","in":"query","name":"region","required":false,"schema":{"default":"us","examples":["us"],"type":"string"}},{"description":"Filter best podcasts by the publisher's country/region.\nThis is to narrow down the results to include \"best podcasts\" produced in a specific country/region.\nYou can get the supported country codes (e.g., us, jp, gb...) from `GET /regions`.\nIf not specified, you'll get \"best podcasts\" produced in any country/region.\nIf you want to get a country/region's \"best podcasts\" that are also produced in that country/region,\nthen you need to specify both **region** and **publisher_region**,\ne.g., `region=jp` and `publisher_region=jp`.\n","in":"query","name":"publisher_region","required":false,"schema":{"type":"string"}},{"description":"Filter best podcasts by language.\nYou can get a list of supported languages (e.g., English, Chinese, Japanese...) from `GET /languages`.\nIf not specified, you'll get \"best podcasts\" in any language.\n","in":"query","name":"language","required":false,"schema":{"type":"string"}},{"description":"How do you want to sort these podcasts?\nIf you'd like to sort by popularity, please use **listen_score**.\n","example":"listen_score","explode":true,"in":"query","name":"sort","required":false,"schema":{"default":"recent_added_first","enum":["recent_added_first","oldest_added_first","recent_published_first","oldest_published_first","listen_score"],"type":"string"},"style":"form"},{"$ref":"#/components/parameters/safeModeParam"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BestPodcastsResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}},"links":{"paginate":{"description":"Pagination through podcasts.","operationId":"getBestPodcasts","parameters":{"page":"$response.body#/next_page_number"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch a list of best podcasts by genre","tags":["Directory API"]}},"/curated_podcasts":{"get":{"description":"A bunch of curated lists from online media. For each list, you'll get basic info of up to 5 podcasts. To get detailed meta data of all podcasts in a specific list, you need to use `GET /curated_podcasts/{id}`. We add new curated lists to the database on a daily basis.\n","operationId":"getCuratedPodcasts","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"Page number of curated lists.","example":2,"explode":true,"in":"query","name":"page","required":false,"schema":{"default":1,"type":"integer"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCuratedPodcastsResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}},"links":{"paginate":{"description":"Pagination through curated lists.","operationId":"getCuratedPodcasts","parameters":{"page":"$response.body#/next_page_number"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch curated lists of podcasts","tags":["Directory API"]}},"/curated_podcasts/{id}":{"get":{"description":"Get detailed meta data of all podcasts in a specific curated list.\nThis endpoint returns same data as https://www.listennotes.com/curated-podcasts/\n","operationId":"getCuratedPodcastById","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"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`.\n","explode":false,"in":"path","name":"id","required":true,"schema":{"examples":["SDFKduyJ47r"],"type":"string"},"style":"simple"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CuratedListFull"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch a curated list of podcasts by id","tags":["Directory API"]}},"/episodes":{"post":{"description":"Batch fetch basic meta data for up to 10 episodes. This endpoint could be used to implement custom playlists for individual episodes. For detailed meta data of an individual episode, you need to use `GET /episodes/{id}`. This endpoint is available only in the PRO/ENTERPRISE plan.\n","operationId":"getEpisodesInBatch","parameters":[{"$ref":"#/components/parameters/apiKeyParam"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/GetEpisodesInBatchForm"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetEpisodesInBatchResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Batch fetch basic meta data for episodes","tags":["Directory API"]}},"/episodes/{id}":{"get":{"description":"Fetch detailed meta data for a specific episode.","operationId":"getEpisodeById","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"id for a specific episode. You can get episode id from using other endpoints, e.g., `GET /search`...","explode":false,"in":"path","name":"id","required":true,"schema":{"examples":["6b6d65930c5a4f71b254465871fed370"],"type":"string"},"style":"simple"},{"description":"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.","explode":false,"in":"query","name":"show_transcript","required":false,"schema":{"default":0,"examples":[1],"type":"integer"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodeFull"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch detailed meta data for an episode by id","tags":["Directory API"]}},"/episodes/{id}/recommendations":{"get":{"description":"Fetch up to 8 episode recommendations based on the given episode id.","operationId":"getEpisodeRecommendations","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"Episode id.","example":"254444fa6cf64a43a95292a70eb6869b","explode":false,"in":"path","name":"id","required":true,"schema":{"type":"string"},"style":"simple"},{"$ref":"#/components/parameters/safeModeParam"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetEpisodeRecommendationsResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch recommendations for an episode","tags":["Directory API"]}},"/genres":{"get":{"description":"Get a list of podcast genres that are supported in Listen Notes.\nThe genre id can be passed to other endpoints as a parameter to get podcasts in a specific genre,\ne.g., `GET /best_podcasts`, `GET /search`...\nYou may want to cache the list of genres on the client side.\n","operationId":"getGenres","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"Just show top level genres? If 1, yes, just show top level genres. If 0, no, show all genres.\n","explode":true,"in":"query","name":"top_level_only","required":false,"schema":{"default":0,"enum":[0,1],"examples":[1],"type":"integer"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetGenresResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch a list of podcast genres","tags":["Directory API"]}},"/just_listen":{"get":{"description":"Recently published episodes are more likely to be fetched. Good luck!","operationId":"justListen","parameters":[{"$ref":"#/components/parameters/apiKeyParam"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodeSimple"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch a random podcast episode","tags":["Directory API"]}},"/languages":{"get":{"description":"Get a list of languages that are supported in Listen Notes database. You can use the language string as query parameter in `GET /search`.\n","operationId":"getLanguages","parameters":[{"$ref":"#/components/parameters/apiKeyParam"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetLanguagesResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch a list of supported languages for podcasts","tags":["Directory API"]}},"/playlists":{"get":{"description":"This endpoint returns same data as listennotes.com/listen under your account.\nYou can use the **page** parameter to do pagination and fetch more playlists.\n","operationId":"getPlaylists","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"How do you want to sort playlists?\n","in":"query","name":"sort","required":false,"schema":{"default":"recent_added_first","enum":["recent_added_first","oldest_added_first","name_a_to_z","name_z_to_a"],"examples":["recent_added_first"],"type":"string"}},{"description":"Page number of playlists.\n","in":"query","name":"page","required":false,"schema":{"default":1,"examples":[1],"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaylistsResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}},"links":{"paginate":{"description":"Pagination through playlists.","operationId":"getPlaylists","parameters":{"page":"$response.body#/page"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch a list of your playlists.","tags":["Playlist API"]}},"/playlists/{id}":{"get":{"description":"A playlist can be an episode list (i.e., all items are episodes) or a podcast list (i.e., all items are podcasts),\nwhich is essentially the same as those created via listennotes.com/listen/.\nThis endpoint fetches a list of items (i.e., episodes or podcasts) in the playlist.\nYou can use the **last_pub_date_ms** parameter to do pagination and fetch more items.\nA playlist can be **public** (discoverable on ListenNotes.com),\n**unlisted** (accessible to anyone who knows the playlist id),\nor **private** (accessible to its owner).\nYou can fetch all playlists created by you, and **public** / **unlisted** playlists created by others.\n","operationId":"getPlaylistById","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"Playlist id (always 11 characters, e.g., m1pe7z60bsw).\nYou can get the podcast id from the url of a playlist, e.g.,\nm1pe7z60bsw is the playlist id of listennotes.com/listen/podcasts-about-podcasting-m1pe7z60bsw\n","example":"m1pe7z60bsw","explode":false,"in":"path","name":"id","required":true,"schema":{"type":"string"},"style":"simple"},{"description":"The type of this playlist, which should be either **episode_list** or **podcast_list**.\n","in":"query","name":"type","required":false,"schema":{"default":"episode_list","enum":["episode_list","podcast_list"],"examples":["episode_list"],"type":"string"}},{"description":"For playlist items pagination.\nIt's the value of **last_timestamp_ms** from the response of last request.\nIf it's 0 or not specified, just return the latest or the oldest 20 items,\ndepending on the value of the **sort** parameter.\n","in":"query","name":"last_timestamp_ms","required":false,"schema":{"default":0,"examples":[0],"type":"integer"}},{"description":"How do you want to sort playlist items?\n","in":"query","name":"sort","required":false,"schema":{"default":"recent_added_first","enum":["recent_added_first","oldest_added_first","recent_published_first","oldest_published_first"],"examples":["recent_added_first"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaylistResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}},"links":{"paginate":{"description":"Pagination through playlist items.","operationId":"getPlaylistById","parameters":{"last_timestamp_ms":"$response.body#/last_timestamp_ms"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch a playlist's info and items (i.e., episodes or podcasts).","tags":["Playlist API"]}},"/podcasts":{"post":{"description":"Batch fetch basic meta data for up to 10 podcasts.\nThis endpoint could be used to build something like OPML import,\nallowing users to import a bunch of podcasts via rss urls.\nFor detailed meta data (including episodes) of an individual podcast, you need to use `GET /podcasts/{id}`. This endpoint is available only in the PRO/ENTERPRISE plan.\n","operationId":"getPodcastsInBatch","parameters":[{"$ref":"#/components/parameters/apiKeyParam"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/GetPodcastsInBatchForm"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPodcastsInBatchResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}},"links":{"paginate":{"description":"Pagination through latest episodes.","operationId":"getPodcastsInBatch","parameters":{"next_episode_pub_date":"$response.body#/next_episode_pub_date"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Batch fetch basic meta data for podcasts","tags":["Directory API"]}},"/podcasts/domains/{domain_name}":{"get":{"description":"Fetch podcasts by a publisher's domain name, e.g., nytimes.com, wondery.com, npr.org...\nEach request will return up to 10 podcasts. You can use the `page` parameter to paginate.\n","operationId":"getPodcastsByDomainName","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"A publisher's domain name, e.g., nytimes.com, wondery.com, npr.org...","example":"nytimes.com","explode":false,"in":"path","name":"domain_name","required":true,"schema":{"type":"string"},"style":"simple"},{"description":"Page number of the podcasts from this domain name","in":"query","name":"page","required":false,"schema":{"default":1,"examples":[1],"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PodcastDomainResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}},"links":{"paginate":{"description":"Pagination through podcasts.","operationId":"getPodcastsByDomainName","parameters":{"page":"$response.body#/next_page_number"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch podcasts by a publisher's domain name","tags":["Insights API"]}},"/podcasts/submit":{"post":{"description":"Podcast hosting services can use this endpoint to help your users directly submit a new podcast to Listen Notes database. If the podcast doesn't exist in the database, \"status\" in the response will be \"in review\", and we'll review it within 12 hours. If the podcast exists, \"status\" in the response will be \"found\". If this submission is rejected, \"status\" in the response will be \"rejected\". You can use `POST /podcasts` to check if multiple podcasts exist in the database. If you want to get a notification once the podcast is accepted, you can either specify the \"email\" parameter or configure a webhook url in the dashboard: listennotes.com/api/dashboard/#webhooks\n","operationId":"submitPodcast","parameters":[{"$ref":"#/components/parameters/apiKeyParam"}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/SubmitPodcastForm"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitPodcastResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Submit a podcast to Listen Notes database","tags":["Podcaster API"]}},"/podcasts/{id}":{"delete":{"description":"Podcast hosting services can use this endpoint to streamline the process of podcast deletion on behave of their users (podcasters). We will review the deletion request within 12 hours. If the podcast is already deleted, the \"status\" field in the response will be \"deleted\". Otherwise, the status field will be \"in review\". If you want to get a notification once the podcast is deleted, you can configure a webhook url in the dashboard: listennotes.com/api/dashboard/#webhooks\n","operationId":"deletePodcastById","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"Podcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`...","example":"4d3fe717742d4963a85562e9f84d8c79","explode":false,"in":"path","name":"id","required":true,"schema":{"type":"string"},"style":"simple"},{"description":"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.","example":"the podcaster wants to delete it","explode":true,"in":"query","name":"reason","required":false,"schema":{"type":"string"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletePodcastResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Request to delete a podcast","tags":["Podcaster API"]},"get":{"description":"Fetch detailed meta data and episodes for a specific podcast (up to 10 episodes each time).\nYou can use the **next_episode_pub_date** parameter to do pagination and fetch more episodes.\n","operationId":"getPodcastById","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"Podcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`...","example":"4d3fe717742d4963a85562e9f84d8c79","explode":false,"in":"path","name":"id","required":true,"schema":{"type":"string"},"style":"simple"},{"description":"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.\n","example":1479154463000,"explode":true,"in":"query","name":"next_episode_pub_date","required":false,"schema":{"type":"integer"},"style":"form"},{"description":"How do you want to sort the episodes of this podcast?\n","example":"recent_first","explode":true,"in":"query","name":"sort","required":false,"schema":{"default":"recent_first","enum":["recent_first","oldest_first"],"type":"string"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PodcastFull"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}},"links":{"paginate":{"description":"Pagination through episodes.","operationId":"getPodcastById","parameters":{"next_episode_pub_date":"$response.body#/next_episode_pub_date"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch detailed meta data and episodes for a podcast by id","tags":["Directory API"]}},"/podcasts/{id}/audience":{"get":{"description":"Fetch audience demographics for a podcast - 1) directly measured on the Listen Notes platform; 2) only supports audience breakdown by regions for now; 3) not every podcast has data.","operationId":"getPodcastAudience","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"Podcast id.","example":"25212ac3c53240a880dd5032e547047b","explode":false,"in":"path","name":"id","required":true,"schema":{"type":"string"},"style":"simple"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PodcastAudienceResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch audience demographics for a podcast","tags":["Insights API"]}},"/podcasts/{id}/recommendations":{"get":{"description":"Fetch up to 8 podcast recommendations based on the given podcast id.","operationId":"getPodcastRecommendations","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"Podcast id.","example":"25212ac3c53240a880dd5032e547047b","explode":false,"in":"path","name":"id","required":true,"schema":{"type":"string"},"style":"simple"},{"$ref":"#/components/parameters/safeModeParam"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPodcastRecommendationsResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch recommendations for a podcast","tags":["Directory API"]}},"/regions":{"get":{"description":"It returns a dictionary of country codes (e.g., us, gb...) & country names (United States, United Kingdom...). The country code is used in the query parameter **region** of `GET /best_podcasts`.\n","operationId":"getRegions","parameters":[{"$ref":"#/components/parameters/apiKeyParam"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRegionsResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch a list of supported countries/regions for best podcasts","tags":["Directory API"]}},"/related_searches":{"get":{"description":"Suggest related search terms. The results are more comprehensive than from `GET /typeahead`. This endpoint is available only in the PRO/ENTERPRISE plan.","operationId":"getRelatedSearches","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"Search term, e.g., person, place, topic...\n","explode":true,"in":"query","name":"q","required":true,"schema":{"examples":["evergrande"],"type":"string"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelatedSearchesResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch related search terms","tags":["Search API"]}},"/search":{"get":{"description":"Full-text search on episodes, podcasts, or curated lists of podcasts.\nUse the `offset` parameter to paginate through search results.\nThe FREE plan allows to see up to 30 search results (or `offset` < 30) per query.\nThe PRO plan allows to see up to 300 search results (or `offset` < 300) per query.\nThe ENTERPRISE plan allows to see up to 10,000 search results (or `offset` < 10000) per query.\n","operationId":"search","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"$ref":"#/components/parameters/queryParam"},{"description":"Sort by date or not? If 0, then sort by relevance. If 1, then sort by date.\n","explode":true,"in":"query","name":"sort_by_date","required":false,"schema":{"default":0,"enum":[0,1],"examples":[0],"type":"integer"},"style":"form"},{"description":"What type of contents do you want to search for? \n","explode":true,"in":"query","name":"type","required":false,"schema":{"default":"episode","enum":["episode","podcast","curated"],"examples":["episode"],"type":"string"},"style":"form"},{"description":"Offset for search results, for pagination. You'll use **next_offset** from response for this parameter.\n","explode":true,"in":"query","name":"offset","required":false,"schema":{"default":0,"examples":[0],"type":"integer"},"style":"form"},{"description":"Minimum audio length in minutes. Applicable only when **type** parameter is **episode** or **podcast**.\nIf **type** parameter is **episode**, it's for audio length of an episode.\nIf **type** parameter is **podcast**, it's for average audio length of all episodes in a podcast.\n","explode":true,"in":"query","name":"len_min","required":false,"schema":{"default":0,"examples":[10],"type":"integer"},"style":"form"},{"description":"Maximum audio length in minutes. Applicable only when **type** parameter is **episode** or **podcast**.\nIf **type** parameter is **episode**, it's for audio length of an episode.\nIf **type** parameter is **podcast**, it's for average audio length of all episodes in a podcast.\n","explode":true,"in":"query","name":"len_max","required":false,"schema":{"examples":[30],"type":"integer"},"style":"form"},{"description":"Minimum number of episodes. Applicable only when type parameter is **podcast**.\n","explode":true,"in":"query","name":"episode_count_min","required":false,"schema":{"type":"integer"},"style":"form"},{"description":"Maximum number of episodes. Applicable only when type parameter is **podcast**.\n","explode":true,"in":"query","name":"episode_count_max","required":false,"schema":{"type":"integer"},"style":"form"},{"description":"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**.\n","explode":true,"in":"query","name":"update_freq_min","required":false,"schema":{"type":"integer"},"style":"form"},{"description":"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**.\n","explode":true,"in":"query","name":"update_freq_max","required":false,"schema":{"type":"integer"},"style":"form"},{"description":"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*.\n","explode":true,"in":"query","name":"genre_ids","required":false,"schema":{"examples":["68,82"],"type":"string"},"style":"form"},{"description":"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**.\n","explode":true,"in":"query","name":"published_before","required":false,"schema":{"examples":[1580172454000],"type":"integer"},"style":"form"},{"description":"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**.\n","explode":true,"in":"query","name":"published_after","required":false,"schema":{"default":0,"examples":[0],"type":"integer"},"style":"form"},{"description":"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.\n","explode":true,"in":"query","name":"only_in","required":false,"schema":{"default":"title,description,author,audio","examples":["title,description"],"type":"string"},"style":"form"},{"description":"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*.\n","explode":true,"in":"query","name":"language","required":false,"schema":{"examples":["English"],"type":"string"},"style":"form"},{"description":"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*.\n","in":"query","name":"region","required":false,"schema":{"examples":[""],"type":"string"}},{"description":"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*.\n","explode":true,"in":"query","name":"ocid","required":false,"schema":{"type":"string"},"style":"form"},{"description":"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*.\n","explode":true,"in":"query","name":"ncid","required":false,"schema":{"type":"string"},"style":"form"},{"description":"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*.\n","explode":true,"in":"query","name":"safe_mode","required":false,"schema":{"default":0,"enum":[0,1],"examples":[0],"type":"integer"},"style":"form"},{"description":"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*.\n","explode":true,"in":"query","name":"unique_podcasts","required":false,"schema":{"default":0,"enum":[0,1],"examples":[0],"type":"integer"},"style":"form"},{"description":"The maximum number of search results per page. A valid value should be an integer between 1 and 10 (inclusive).\n","explode":true,"in":"query","name":"page_size","required":false,"schema":{"default":10,"examples":[10],"type":"integer"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}},"links":{"paginate":{"description":"Pagination through search results.","operationId":"search","parameters":{"offset":"$response.body#/next_offset"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Full-text search","tags":["Search API"]}},"/spellcheck":{"get":{"description":"Suggest a list of words that correct the spelling errors of a search term. This endpoint is available only in the PRO/ENTERPRISE plan.","operationId":"spellcheck","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"description":"Search term, e.g., person, place, topic...\n","explode":true,"in":"query","name":"q","required":true,"schema":{"examples":["evergrand stok"],"type":"string"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpellCheckResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Spell check on a search term","tags":["Search API"]}},"/trending_searches":{"get":{"description":"Fetch up to 10 most recent trending search terms on the Listen Notes platform.","operationId":"getTrendingSearches","parameters":[{"$ref":"#/components/parameters/apiKeyParam"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendingSearchesResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Fetch trending search terms","tags":["Search API"]}},"/typeahead":{"get":{"description":"Suggest search terms, podcast genres, and podcasts.","operationId":"typeahead","parameters":[{"$ref":"#/components/parameters/apiKeyParam"},{"$ref":"#/components/parameters/queryParam"},{"description":"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.\n","explode":true,"in":"query","name":"show_podcasts","required":false,"schema":{"default":0,"enum":[0,1],"examples":[1],"type":"integer"},"style":"form"},{"description":"Whether or not to autosuggest genres. 1 is yes, 0 is no.\n","explode":true,"in":"query","name":"show_genres","required":false,"schema":{"default":0,"enum":[0,1],"examples":[1],"type":"integer"},"style":"form"},{"description":"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*.\n","explode":true,"in":"query","name":"safe_mode","required":false,"schema":{"default":0,"enum":[0,1],"examples":[0],"type":"integer"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TypeaheadResponse"}}},"description":"OK","headers":{"X-ListenAPI-FreeQuota":{"$ref":"#/components/headers/X-ListenAPI-FreeQuota"},"X-ListenAPI-NextBillingDate":{"$ref":"#/components/headers/X-ListenAPI-NextBillingDate"},"X-ListenAPI-Usage":{"$ref":"#/components/headers/X-ListenAPI-Usage"},"X-listenAPI-Latency-Seconds":{"$ref":"#/components/headers/X-listenAPI-Latency-Seconds"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/TooManyRequests"},"5XX":{"$ref":"#/components/responses/ServerError"}},"summary":"Typeahead search","tags":["Search API"]}}},"components":{"headers":{"X-ListenAPI-FreeQuota":{"description":"Free quotas of API requests included in your api plan.","explode":false,"schema":{"examples":[25000],"type":"integer"},"style":"simple"},"X-ListenAPI-NextBillingDate":{"description":"The timestamp for the start of next billing cycle. In ISO 8601 format.","schema":{"examples":["2025-08-15T13:50:47.784Z"],"format":"date-time","type":"string"},"style":"simple"},"X-ListenAPI-Usage":{"description":"The number of API requests that you've used in current billing cycle.","explode":false,"schema":{"examples":[19231],"type":"integer"},"style":"simple"},"X-listenAPI-Latency-Seconds":{"description":"Latency for this api call, in seconds.","explode":false,"schema":{"examples":[0.056],"type":"number"},"style":"simple"}},"parameters":{"apiKeyParam":{"description":"Get API Key on listennotes.com/api","explode":false,"in":"header","name":"X-ListenAPI-Key","required":true,"schema":{"type":"string"},"style":"simple"},"genreIdParam":{"description":"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.","in":"query","name":"genre_id","required":false,"schema":{"examples":[93],"type":"string"}},"queryParam":{"description":"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.\n","explode":true,"in":"query","name":"q","required":true,"schema":{"examples":["star wars"],"type":"string"},"style":"form"},"safeModeParam":{"description":"Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.","in":"query","name":"safe_mode","required":false,"schema":{"default":0,"enum":[0,1],"examples":[0],"type":"integer"}}},"responses":{"BadRequest":{"description":"Something wrong on your end (Client side errors), e.g., missing required parameters."},"NotFound":{"description":"Endpoint not exist, or podcast / episode not exist."},"ServerError":{"description":"Something wrong on our end (Unexpected server errors)."},"TooManyRequests":{"description":"For FREE plan, exceeding the quota limit; or for all plans, sending too many requests too fast and exceeding the rate limit."},"Unauthorized":{"description":"Wrong api key, or your account is suspended."}},"schemas":{"AudioField":{"description":"Audio url of this episode, which can be played directly.","examples":["https://www.listennotes.com/e/p/11b34041e804491b9704d11f283c74de/"],"type":"string"},"AudioLengthSecField":{"description":"Audio length of this episode. In seconds.","examples":[567],"type":"integer"},"AvgAudioLengthSecField":{"description":"Average audio length of all episodes of this podcast. In seconds.","examples":[1291],"type":"integer"},"BestPodcastsLNUrlField":{"description":"Url of the list of best podcasts on [ListenNotes.com](https://www.ListenNotes.com).","examples":["https://www.listennotes.com/best-business-news-podcasts-95/"],"type":"string"},"BestPodcastsResponse":{"properties":{"has_next":{"examples":[true],"type":"boolean"},"has_previous":{"examples":[true],"type":"boolean"},"id":{"description":"The id of this genre","examples":[95],"type":"integer"},"listennotes_url":{"$ref":"#/components/schemas/BestPodcastsLNUrlField"},"name":{"description":"This genre's name.","examples":["Business News"],"type":"string"},"next_page_number":{"examples":[3],"type":"integer"},"page_number":{"examples":[2],"type":"integer"},"parent_id":{"description":"The id of parent genre.","examples":[93],"type":"integer"},"podcasts":{"items":{"$ref":"#/components/schemas/PodcastSimple"},"type":"array"},"previous_page_number":{"examples":[1],"type":"integer"},"total":{"examples":[325],"type":"integer"}},"required":["has_next","has_previous","id","listennotes_url","name","next_page_number","page_number","parent_id","podcasts","previous_page_number","total"],"type":"object"},"CountryField":{"description":"The country where this podcast is produced.","examples":["United States"],"type":"string"},"CuratedDescriptionField":{"description":"This curated list's description.","examples":["Commuting to work is always better when you have a great new podcast to listen to, and this year, we have discovered some of our favorite podcasts yet for readers and book-lovers. These podcasts for readers entertain us and provide no shortage of new book recommendations too."],"type":"string"},"CuratedIdField":{"description":"Curated list id, which can be used to further fetch detailed curated list metadata via `GET /curated_podcasts/{id}`.","examples":["Vb017Sx3l8F"],"type":"string"},"CuratedLNUrlField":{"description":"The url of this curated list on [ListenNotes.com](https://www.ListenNotes.com).","examples":["https://www.listennotes.com/curated-podcasts/7-bookish-podcasts-for-avid-readers-on-H2r-TCWai8K/"],"type":"string"},"CuratedListFull":{"properties":{"description":{"$ref":"#/components/schemas/CuratedDescriptionField"},"id":{"$ref":"#/components/schemas/CuratedIdField"},"listennotes_url":{"$ref":"#/components/schemas/CuratedLNUrlField"},"podcasts":{"description":"Complete meta data of all podcasts in this curated list.","items":{"$ref":"#/components/schemas/PodcastSimple"},"type":"array"},"pub_date_ms":{"$ref":"#/components/schemas/CuratedPubDateMsField"},"source_domain":{"$ref":"#/components/schemas/CuratedSourceDomainField"},"source_url":{"$ref":"#/components/schemas/CuratedSourceUrlField"},"title":{"$ref":"#/components/schemas/CuratedNameField"},"total":{"$ref":"#/components/schemas/CuratedTotalPodcastsField"}},"type":"object"},"CuratedListSearchResult":{"description":"When **type** is *curated*.","properties":{"description_highlighted":{"description":"Highlighted segment of this curated list's description","examples":["...<span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> fans in Reddit shared their favorite podcasts."],"type":"string"},"description_original":{"description":"Plain text of this curated list's description","examples":["Star Wars fans in Reddit shared their favorite podcasts."],"type":"string"},"id":{"$ref":"#/components/schemas/CuratedIdField"},"listennotes_url":{"$ref":"#/components/schemas/CuratedLNUrlField"},"podcasts":{"description":"Up to 5 podcasts in this curated list.","items":{"$ref":"#/components/schemas/PodcastMinimum"},"type":"array"},"pub_date_ms":{"$ref":"#/components/schemas/CuratedPubDateMsField"},"source_domain":{"$ref":"#/components/schemas/CuratedSourceDomainField"},"source_url":{"$ref":"#/components/schemas/CuratedSourceUrlField"},"title_highlighted":{"description":"Highlighted segment of this curated list's title","examples":["What are some good <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> Podcast to listen to?\n"],"type":"string"},"title_original":{"description":"Plain text of this curated list's title","examples":["What are some good Star Wars Podcast to listen to?"],"type":"string"},"total":{"$ref":"#/components/schemas/CuratedTotalPodcastsField"}},"type":"object"},"CuratedListSimple":{"properties":{"description":{"$ref":"#/components/schemas/CuratedDescriptionField"},"id":{"$ref":"#/components/schemas/CuratedIdField"},"listennotes_url":{"$ref":"#/components/schemas/CuratedLNUrlField"},"podcasts":{"description":"Minimum meta data of up to 5 podcasts in this curated list.","items":{"$ref":"#/components/schemas/PodcastMinimum"},"type":"array"},"pub_date_ms":{"$ref":"#/components/schemas/CuratedPubDateMsField"},"source_domain":{"$ref":"#/components/schemas/CuratedSourceDomainField"},"source_url":{"$ref":"#/components/schemas/CuratedSourceUrlField"},"title":{"$ref":"#/components/schemas/CuratedNameField"},"total":{"$ref":"#/components/schemas/CuratedTotalPodcastsField"}},"type":"object"},"CuratedNameField":{"description":"Curated list name.","examples":["7 Bookish Podcasts for Avid Readers On the Go"],"type":"string"},"CuratedPubDateMsField":{"description":"Published date of this curated list. In milliseconds.","examples":[1556843484301],"type":"integer"},"CuratedSourceDomainField":{"description":"The domain name of the source of this curated list.","examples":["parade.com"],"type":"string"},"CuratedSourceUrlField":{"description":"Url of the source of this curated list.","examples":["https://parade.com/718913/ashley_johnson/7-bookish-podcasts-for-avid-readers-on-the-go/"],"type":"string"},"CuratedTotalPodcastsField":{"description":"The total number of podcasts in this curated list.","examples":[25],"type":"integer"},"CustomAudio":{"description":"A custom audio in a playlist, which is a type of playlist item.","properties":{"audio":{"description":"Audio url, which can be played directly.","examples":["https://example.com/audio.mp3"],"type":"string"},"audio_length_sec":{"description":"Audio length in seconds.","examples":[253],"type":"integer"},"image":{"description":"High resolution image url of this custom audio.","examples":["https://cdn-images-1.listennotes.com/playlist/image/6907e8ff6b6c45df94cc059753f369cc.JPEG"],"type":"string"},"pub_date_ms":{"description":"Published date (in milliseconds) of this custom audio.\nFor now, it's the same as **added_at_ms** of this playlist item.\n","examples":[1595567028133],"type":"integer"},"thumbnail":{"description":"Low resolution image url of this custom audio.","examples":["https://d3sv2eduhewoas.cloudfront.net/playlist/image/48477deae02649d7ab9d3f1b3966af38.JPEG"],"type":"string"},"title":{"description":"Custom audio title.","examples":["An awesome audio to listen."],"type":"string"}},"type":"object"},"DeletePodcastResponse":{"properties":{"status":{"description":"The status of this podcast deletion request.","enum":["deleted","in review"],"examples":["deleted"],"type":"string"}},"required":["status"],"type":"object"},"DeletedItem":{"description":"A deleted episode or podcast.\nAn episode or a podcast could be deleted from our podcast database.\nPossible reasons: 1) Podcast producers sometimes delete their old episodes. 2) Copyright issues.\n","properties":{"error":{"description":"Why this episode or podcast is deleted?","examples":["This episode is deleted from the podcast database, because..."],"type":"string"},"id":{"description":"Episode id or podcast id.","examples":["96fc400171364e32897b25d84a8ed8ec"],"type":"string"},"status":{"description":"The status of this episode or podcast. For now, the only possible value is **deleted**.","examples":["deleted"],"type":"string"},"title":{"description":"Episode title or podcast title.","examples":["This is a test episode"],"type":"string"}},"type":"object"},"EarliestPubDateMsField":{"description":"The published date of the oldest episode of this podcast. In milliseconds","examples":[1470667902000],"type":"integer"},"EmailField":{"description":"The email of this podcast's producer. This field is available only in the PRO/ENTERPRISE plan.","examples":["hello@example.com"],"type":"string"},"EpisodeDescriptionField":{"description":"Html of this episode's full description","examples":["<p>Disney chief Bob Iger shared news about Star Wars movies in 2020 and beyond, but some media outlets gave conflicting reports about it. Here's the real scoop. Punch it!</p> <p>***We’re listener supported! Go to http://Patreon.com/sw7x7 to donate to the Star Wars 7x7 podcast, and you’ll get some fabulous rewards for your pledge.*** </p> <p>Check out SW7x7.com for full Star Wars 7x7 show notes and links, and to comment on any of the content of this episode! If you like what you've heard, please leave us a rating or review on iTunes or Stitcher, which will also help more people discover this Star Wars podcast.</p> <p>Don't forget to join the Star Wars 7x7 fun on Facebook at Facebook.com/SW7x7, and follow the breaking news Twitter feed at Twitter.com/SW7x7Podcast. We're also on Pinterest and Instagram as \"SW7x7\" too, and we'd love to connect with you there!</p>\n"],"type":"string"},"EpisodeFull":{"properties":{"audio":{"$ref":"#/components/schemas/AudioField"},"audio_length_sec":{"$ref":"#/components/schemas/AudioLengthSecField"},"description":{"$ref":"#/components/schemas/EpisodeDescriptionField"},"explicit_content":{"$ref":"#/components/schemas/ExplicitField"},"id":{"$ref":"#/components/schemas/EpisodeIdField"},"image":{"$ref":"#/components/schemas/EpisodeImageField"},"link":{"$ref":"#/components/schemas/LinkField"},"listennotes_edit_url":{"$ref":"#/components/schemas/EpisodeLNEditUrlField"},"listennotes_url":{"$ref":"#/components/schemas/EpisodeLNUrlField"},"maybe_audio_invalid":{"$ref":"#/components/schemas/MaybeAudioInvalidField"},"podcast":{"$ref":"#/components/schemas/PodcastSimple"},"pub_date_ms":{"$ref":"#/components/schemas/EpisodePubDateMsField"},"thumbnail":{"$ref":"#/components/schemas/EpisodeThumbnailField"},"title":{"$ref":"#/components/schemas/EpisodeNameField"},"transcript":{"$ref":"#/components/schemas/TranscriptField"}},"type":"object"},"EpisodeIdField":{"description":"Episode id, which can be used to further fetch detailed episode metadata via `GET /episodes/{id}`.","examples":["4d82e50314174754a3b603912448e812"],"type":"string"},"EpisodeImageField":{"description":"Image url for this episode.\nIf an episode doesn't have its own image, then this field would be the url of the podcast artwork image.\nIf you are using PRO/ENTERPRISE plan, then it's\na high resolution image (1400x1400). If you are using FREE plan, then it's the same as **thumbnail**,\nlow resolution image (300x300).\n","examples":["https://cdn-images-1.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg"],"type":"string"},"EpisodeLNEditUrlField":{"description":"Edit url of this episode where you can update the audio url if you find the audio is broken.","examples":["https://www.listennotes.com/e/11b34041e804491b9704d11f283c74de/#edit"],"type":"string"},"EpisodeLNUrlField":{"description":"The url of this episode on [ListenNotes.com](https://www.ListenNotes.com).","examples":["https://www.listennotes.com/e/4d82e50314174754a3b603912448e812/"],"type":"string"},"EpisodeMinimum":{"properties":{"audio":{"$ref":"#/components/schemas/AudioField"},"audio_length_sec":{"$ref":"#/components/schemas/AudioLengthSecField"},"description":{"$ref":"#/components/schemas/EpisodeDescriptionField"},"explicit_content":{"$ref":"#/components/schemas/ExplicitField"},"id":{"$ref":"#/components/schemas/EpisodeIdField"},"image":{"$ref":"#/components/schemas/ImageField"},"link":{"$ref":"#/components/schemas/LinkField"},"listennotes_edit_url":{"$ref":"#/components/schemas/EpisodeLNEditUrlField"},"listennotes_url":{"$ref":"#/components/schemas/EpisodeLNUrlField"},"maybe_audio_invalid":{"$ref":"#/components/schemas/MaybeAudioInvalidField"},"pub_date_ms":{"$ref":"#/components/schemas/EpisodePubDateMsField"},"thumbnail":{"$ref":"#/components/schemas/ThumbnailField"},"title":{"$ref":"#/components/schemas/EpisodeNameField"}},"type":"object"},"EpisodeNameField":{"description":"Episode name.","examples":["Celebration Recap, Jason Fry and Christian Blauvelt Interviews – SWBW #101"],"type":"string"},"EpisodePubDateMsField":{"description":"Published date for this episode. In millisecond.","examples":[1474873200000],"type":"integer"},"EpisodeSearchResult":{"description":"When **type** is *episode*.","properties":{"audio":{"$ref":"#/components/schemas/AudioField"},"audio_length_sec":{"$ref":"#/components/schemas/AudioLengthSecField"},"description_highlighted":{"description":"Highlighted segment of this episode's description","examples":["...Go to http://Patreon.com/sw7x7 to donate to the <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> 7x7 podcast, and you'll get some fabulous rewards for your pledge.***  Check out SW7x7.com for full <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> 7x7 show notes and links, and to\n"],"type":"string"},"description_original":{"description":"Plain text of this episode's description","examples":["Yeah, Star Wars Celebration Orlando is 32 days away, but what's the scoop on Celebration 2018? Plus, Rebels Day is Saturday, and much more in our update. Punch it! ***We're listener supported! Go to http://Patreon.com/sw7x7 to donate to the Star Wars 7x7 podcast, and you’ll get some fabulous rewards for your pledge.***  Check out SW7x7.com for full Star Wars 7x7 show notes and links, and to comment on any of the content of this episode! If you like what you've heard, please leave us a rating or review on iTunes or Stitcher, which will also help more people discover this Star Wars podcast. Don't forget to join the Star Wars 7x7 fun on Facebook at Facebook.com/SW7x7, and follow the breaking news Twitter feed at Twitter.com/SW7x7Podcast. We're also on Pinterest and Instagram as \"SW7x7\" too, and we'd love to connect with you there!\n"],"type":"string"},"explicit_content":{"$ref":"#/components/schemas/ExplicitField"},"id":{"$ref":"#/components/schemas/EpisodeIdField"},"image":{"$ref":"#/components/schemas/EpisodeImageField"},"itunes_id":{"$ref":"#/components/schemas/iTunesIdField"},"link":{"$ref":"#/components/schemas/LinkField"},"listennotes_url":{"$ref":"#/components/schemas/EpisodeLNUrlField"},"podcast":{"description":"The podcast that this episode belongs to.","properties":{"genre_ids":{"$ref":"#/components/schemas/GenreIdsField"},"id":{"$ref":"#/components/schemas/PodcastIdField"},"image":{"$ref":"#/components/schemas/ImageField"},"listen_score":{"$ref":"#/components/schemas/ListenScoreField"},"listen_score_global_rank":{"$ref":"#/components/schemas/ListenScoreGlobalRankField"},"listennotes_url":{"$ref":"#/components/schemas/PodcastLNUrlField"},"publisher_highlighted":{"$ref":"#/components/schemas/PublisherHighlightedField"},"publisher_original":{"$ref":"#/components/schemas/PublisherOriginalField"},"thumbnail":{"$ref":"#/components/schemas/ThumbnailField"},"title_highlighted":{"$ref":"#/components/schemas/PodcastTitleHighlightedField"},"title_original":{"$ref":"#/components/schemas/PodcastTitleOriginalField"}},"type":"object"},"pub_date_ms":{"$ref":"#/components/schemas/EpisodePubDateMsField"},"rss":{"$ref":"#/components/schemas/RssField"},"thumbnail":{"$ref":"#/components/schemas/EpisodeThumbnailField"},"title_highlighted":{"description":"Highlighted segment of this episode's title","examples":["815: <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> 2020 Movie and Beyond!"],"type":"string"},"title_original":{"description":"Plain text of this episode' title","examples":["815: Star Wars 2020 Movie and Beyond!"],"type":"string"},"transcripts_highlighted":{"description":"Up to 2 highlighted segments of the audio transcript of this episode.","items":{"examples":["00:21:27  when Disney bought the <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> franchise from George Lucas they had a plan lots of <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> movies new <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> movies every month another one was just released while I was talking\n"],"type":"string"},"type":"array"}},"type":"object"},"EpisodeSimple":{"properties":{"audio":{"$ref":"#/components/schemas/AudioField"},"audio_length_sec":{"$ref":"#/components/schemas/AudioLengthSecField"},"description":{"$ref":"#/components/schemas/EpisodeDescriptionField"},"explicit_content":{"$ref":"#/components/schemas/ExplicitField"},"id":{"$ref":"#/components/schemas/EpisodeIdField"},"image":{"$ref":"#/components/schemas/EpisodeImageField"},"link":{"$ref":"#/components/schemas/LinkField"},"listennotes_edit_url":{"$ref":"#/components/schemas/EpisodeLNEditUrlField"},"listennotes_url":{"$ref":"#/components/schemas/EpisodeLNUrlField"},"maybe_audio_invalid":{"$ref":"#/components/schemas/MaybeAudioInvalidField"},"podcast":{"$ref":"#/components/schemas/PodcastMinimum"},"pub_date_ms":{"$ref":"#/components/schemas/EpisodePubDateMsField"},"thumbnail":{"$ref":"#/components/schemas/EpisodeThumbnailField"},"title":{"$ref":"#/components/schemas/EpisodeNameField"}},"type":"object"},"EpisodeThumbnailField":{"description":"Thumbnail image (300x300) url for this episode.\nIf an episode doesn't have its own image, then this field would be the url of the podcast artwork thumbnail image.\n","examples":["https://cdn-images-1.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg"],"type":"string"},"ExplicitField":{"description":"Whether this podcast contains explicit language.","examples":[false],"type":"boolean"},"Genre":{"examples":[{"id":140,"name":"Web Design","parent_id":127}],"properties":{"id":{"description":"Genre id","examples":[93],"type":"integer"},"name":{"description":"Genre name.","examples":["Business"],"type":"string"},"parent_id":{"description":"Parent genre id.","examples":[95],"type":"integer"}},"type":"object"},"GenreIdsField":{"examples":[[138,86,160,68,82,100,101]],"items":{"description":"Genre ids.","type":"integer"},"type":"array"},"GetCuratedPodcastsResponse":{"properties":{"curated_lists":{"items":{"$ref":"#/components/schemas/CuratedListSimple"},"type":"array"},"has_next":{"examples":[true],"type":"boolean"},"has_previous":{"examples":[true],"type":"boolean"},"next_page_number":{"examples":[3],"type":"integer"},"page_number":{"examples":[2],"type":"integer"},"previous_page_number":{"examples":[1],"type":"integer"},"total":{"examples":[25],"type":"integer"}},"required":["curated_lists","has_next","has_previous","next_page_number","page_number","previous_page_number","total"],"type":"object"},"GetEpisodeRecommendationsResponse":{"properties":{"recommendations":{"items":{"$ref":"#/components/schemas/EpisodeSimple"},"type":"array"}},"required":["recommendations"],"type":"object"},"GetEpisodesInBatchForm":{"properties":{"ids":{"description":"Comma-separated list of episode ids.","examples":["c577d55b2b2b483c969fae3ceb58e362,0f34a9099579490993eec9e8c8cebb82"],"type":"string"}},"required":["ids"],"type":"object"},"GetEpisodesInBatchResponse":{"properties":{"episodes":{"items":{"$ref":"#/components/schemas/EpisodeSimple"},"type":"array"}},"required":["episodes"],"type":"object"},"GetGenresResponse":{"properties":{"genres":{"items":{"$ref":"#/components/schemas/Genre"},"type":"array"}},"required":["genres"],"type":"object"},"GetLanguagesResponse":{"properties":{"languages":{"examples":[["Any language","Afar","Abkhazian","Afrikaans","Akan","Albanian","Arabic","Azerbaijani","Bambara","Bashkir","Basque","Belarusian","Bulgarian","Catalan","Chamorro","Chinese","Croatian","Czech","Danish","Dutch","English","Estonian","Faeroese","Finnish","French","Gaelic","Galician","German","Greek"]],"items":{"type":"string"},"type":"array"}},"required":["languages"],"type":"object"},"GetPodcastRecommendationsResponse":{"properties":{"recommendations":{"items":{"$ref":"#/components/schemas/PodcastSimple"},"type":"array"}},"required":["recommendations"],"type":"object"},"GetPodcastsInBatchForm":{"properties":{"ids":{"description":"Comma-separated list of podcast ids.","examples":["3302bc71139541baa46ecb27dbf6071a,68faf62be97149c280ebcc25178aa731,37589a3e121e40debe4cef3d9638932a,9cf19c590ff0484d97b18b329fed0c6a"],"type":"string"},"itunes_ids":{"description":"Comma-separated Apple Podcasts (iTunes) ids, e.g., 659155419","examples":["1457514703,1386234384,659155419"],"type":"string"},"next_episode_pub_date":{"description":"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.\n","examples":[1557394247000],"type":"integer"},"rsses":{"description":"Comma-separated rss urls.","examples":["https://rss.art19.com/recode-decode,https://rss.art19.com/the-daily,https://www.npr.org/rss/podcast.php?id=510331,https://www.npr.org/rss/podcast.php?id=510331"],"type":"string"},"show_latest_episodes":{"default":0,"description":"Whether or not to fetch up to 15 latest episodes from these podcasts, sorted by pub_date. 1 is yes, and 0 is no.\n","enum":[0,1],"examples":[1],"type":"integer"},"spotify_ids":{"description":"Comma-separated Spotify ids, e.g., 3DDfEsKDIDrTlnPOiG4ZF4","examples":["3DDfEsKDIDrTlnPOiG4ZF4,4qDNe5Gvl1XxdLinUGEXrC,23NZCM4ik6o3UYkM473Itz"],"type":"string"}},"type":"object"},"GetPodcastsInBatchResponse":{"properties":{"latest_episodes":{"description":"Up to 10 latest episodes from these podcasts, sorted by **pub_date**. This field shows up only when **show_latest_episodes** is 1.\n","items":{"$ref":"#/components/schemas/EpisodeSimple"},"type":"array"},"podcasts":{"items":{"$ref":"#/components/schemas/PodcastSimple"},"type":"array"}},"required":["podcasts"],"type":"object"},"GetRegionsResponse":{"properties":{"regions":{"examples":[{"au":"Australia","de":"Germany","ua":"Ukraine","us":"United States"}],"type":"object"}},"required":["regions"],"type":"object"},"ImageField":{"description":"Image url for this podcast's artwork. If you are using PRO/ENTERPRISE plan, then it's\na high resolution image (1400x1400). If you are using FREE plan, then it's the same as **thumbnail**,\nlow resolution image (300x300).\n","examples":["https://cdn-images-1.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.1400x1400.jpg"],"type":"string"},"IsClaimedField":{"description":"Whether this podcast is claimed by its producer on [ListenNotes.com](https://www.ListenNotes.com).","examples":[true],"type":"boolean"},"LanguageField":{"description":"The language of this podcast. You can get all supported languages from `GET /languages`.","examples":["English"],"type":"string"},"LatestEpisodeIdField":{"description":"The id of the most recently published episode of this podcast, which can be used to further fetch detailed episode metadata via `GET /episodes/{id}`.","examples":["d057092e57cc4ced80e0efaa196593d9"],"type":"string"},"LatestPubDateMsField":{"description":"The published date of the latest episode of this podcast. In milliseconds","examples":[1557499770000],"type":"integer"},"LinkField":{"description":"Web link of this episode.","examples":["https://www.npr.org/2020/01/22/798532179/soleimanis-iran"],"type":"string"},"ListenScoreField":{"description":"The estimated popularity score of a podcast compared to all other rss-based public podcasts in the world on a scale from 0 to 100.\nIf the score is not available, it'll be null. Learn more at listennotes.com/listen-score\n","examples":[81],"type":"integer"},"ListenScoreGlobalRankField":{"description":"The estimated popularity ranking of a podcast compared to all other rss-based public podcasts in the world.\nFor example, if the value is 0.5%, then this podcast is one of the top 0.5% most popular shows out of all podcasts globally, ranked by Listen Score.\nIf the ranking is not available, it'll be null. Learn more at listennotes.com/listen-score\n","examples":["0.5%"],"type":"string"},"MaybeAudioInvalidField":{"description":"Whether or not this episode's audio is invalid. Podcasters may delete the original audio.","examples":[false],"type":"boolean"},"NextEpisodePubDateField":{"description":"Passed to the **next_episode_pub_date** parameter of `GET /podcasts/{id}` to paginate through episodes of that podcast.","examples":[1470667902000],"type":"integer"},"PlaylistDescriptionField":{"description":"Playlist description.","examples":["A curated playlist of podcasts about podcasting."],"type":"string"},"PlaylistIdField":{"description":"A 11-character playlist id, which can be used to further fetch detailed playlist metadata via `GET /playlists/{id}`.","examples":["m1pe7z60bsw"],"type":"string"},"PlaylistImageField":{"description":"High resolution image url of the playlist.","examples":["https://cdn-images-1.listennotes.com/playlist/image/6907e8ff6b6c45df94cc059753f369cc.JPEG"],"type":"string"},"PlaylistItem":{"description":"An item in a playlist","properties":{"added_at_ms":{"description":"Timestamp (in milliseconds) when this item is added.","examples":[1595567004958],"type":"integer"},"data":{"oneOf":[{"$ref":"#/components/schemas/EpisodeSimple"},{"$ref":"#/components/schemas/PodcastSimple"},{"$ref":"#/components/schemas/CustomAudio"},{"$ref":"#/components/schemas/DeletedItem"}]},"id":{"description":"Playlist item id.","examples":[23],"type":"integer"},"notes":{"description":"Notes for this item.","examples":["This is a good episode."],"type":"string"},"type":{"description":"The type of this playlist item.\nIf a playlist is **episode_list**, then an item could be either **episode** or **custom_audio**.\nIf it's **podcast_list**, then an item can only be **podcast**.\n","enum":["episode","custom_audio","podcast"],"examples":["episode"],"type":"string"}},"type":"object"},"PlaylistLastTimestampMsField":{"description":"Passed to the **last_timestamp_ms** parameter of `GET /playlists/{id}` to paginate through items of that playlist.\n","examples":[1595641092907],"type":"integer"},"PlaylistListennotesUrlField":{"description":"The url of this playlist on ListenNotes.com.","examples":["https://www.listennotes.com/listen/podcasts-about-podcasting-m1pe7z60bsw/?display=episode"],"type":"string"},"PlaylistNameField":{"description":"Playlist name.","examples":["My podcast playlist"],"type":"string"},"PlaylistResponse":{"properties":{"description":{"$ref":"#/components/schemas/PlaylistDescriptionField"},"id":{"$ref":"#/components/schemas/PlaylistIdField"},"image":{"$ref":"#/components/schemas/PlaylistImageField"},"items":{"description":"A list of playlist items.","items":{"$ref":"#/components/schemas/PlaylistItem"},"type":"array"},"last_timestamp_ms":{"$ref":"#/components/schemas/PlaylistLastTimestampMsField"},"listennotes_url":{"$ref":"#/components/schemas/PlaylistListennotesUrlField"},"name":{"$ref":"#/components/schemas/PlaylistNameField"},"thumbnail":{"$ref":"#/components/schemas/PlaylistThumbnailField"},"total":{"description":"Total number of items in this playlist.","examples":[325],"type":"integer"},"total_audio_length_sec":{"description":"Total audio length of all episodes in this playlist, in seconds. It will have a valid value only when type is **episode_list**. In other words, it will be 0 if type is **podcast_list**.","examples":[234567],"type":"integer"},"type":{"description":"The type of this playlist, which should be either **episode_list** or **podcast_list**.\n","enum":["episode_list","podcast_list"],"examples":["episode_list"],"type":"string"},"visibility":{"$ref":"#/components/schemas/PlaylistVisibilityField"}},"type":"object"},"PlaylistThumbnailField":{"description":"Low resolution image url of the playlist.","examples":["https://d3sv2eduhewoas.cloudfront.net/playlist/image/48477deae02649d7ab9d3f1b3966af38.JPEG"],"type":"string"},"PlaylistVisibilityField":{"description":"Visibility of this playlist.","enum":["public","unlisted","private"],"examples":["public"],"type":"string"},"PlaylistsResponse":{"properties":{"has_next":{"examples":[true],"type":"boolean"},"has_previous":{"examples":[true],"type":"boolean"},"next_page_number":{"examples":[3],"type":"integer"},"page_number":{"examples":[2],"type":"integer"},"playlists":{"items":{"description":"A playlist","properties":{"description":{"$ref":"#/components/schemas/PlaylistDescriptionField"},"episode_count":{"description":"The number of episodes (including custom audio) in this playlist.","examples":[23],"type":"integer"},"id":{"$ref":"#/components/schemas/PlaylistIdField"},"image":{"$ref":"#/components/schemas/PlaylistImageField"},"last_timestamp_ms":{"$ref":"#/components/schemas/PlaylistLastTimestampMsField"},"listennotes_url":{"$ref":"#/components/schemas/PlaylistListennotesUrlField"},"name":{"$ref":"#/components/schemas/PlaylistNameField"},"podcast_count":{"description":"The number of podcasts in this playlist.","examples":[10],"type":"integer"},"thumbnail":{"$ref":"#/components/schemas/PlaylistThumbnailField"},"total_audio_length_sec":{"description":"Total audio length of all episodes in this playlist, in seconds.","examples":[234567],"type":"integer"},"visibility":{"$ref":"#/components/schemas/PlaylistVisibilityField"}},"type":"object"},"type":"array"},"previous_page_number":{"examples":[1],"type":"integer"},"total":{"examples":[325],"type":"integer"}},"type":"object"},"PodcastAudienceResponse":{"properties":{"by_regions":{"items":{"properties":{"ratio":{"description":"percentage of audience from this specific region","examples":["20.22%"],"type":"string"},"region":{"description":"2-letter country code of a region.","examples":["us"],"type":"string"}},"type":"object"},"type":"array"}},"type":"object"},"PodcastDescriptionField":{"description":"Html of this episode's full description","examples":["<p>The Star Wars 7x7 Podcast is Rebel-rousing fun for everyday Jedi, between 7 and 14 minutes a day, 7 days a week. Join host Allen Voivod for Star Wars news, history, interviews, trivia, and deep dives into the Star Wars story as told in movies, books, comics, games, cartoons, and more. Subscribe now for your daily dose of Star Wars joy. It's destiny unleashed!</p>"],"type":"string"},"PodcastDomainResponse":{"properties":{"has_next":{"examples":[true],"type":"boolean"},"has_previous":{"examples":[true],"type":"boolean"},"next_page_number":{"examples":[3],"type":"integer"},"page_number":{"examples":[2],"type":"integer"},"podcasts":{"items":{"$ref":"#/components/schemas/PodcastSimple"},"type":"array"},"previous_page_number":{"examples":[1],"type":"integer"}},"type":"object"},"PodcastExtraField":{"properties":{"amazon_music_url":{"description":"Amazon Music url for this podcast","examples":["https://music.amazon.com/podcasts/6fc6d683-9ef3-4850-9c35-8e8b1a42a147/the-lock-sportscast"],"type":"string"},"facebook_handle":{"description":"Facebook username affiliated with this podcast","examples":["sw7x7"],"type":"string"},"google_url":{"description":"Google Podcasts url for this podcast","examples":["https://podcasts.google.com/feed/aHR0cHM6Ly9yc3MuYXJ0MTkuY29tL2pvaG4tc29sb21vbi1yZXBvcnRz"],"type":"string"},"instagram_handle":{"description":"Instagram username affiliated with this podcast","examples":["sw7x7"],"type":"string"},"linkedin_url":{"description":"LinkedIn url affiliated with this podcast","type":"string"},"patreon_handle":{"description":"Patreon username affiliated with this podcast","examples":["sw7x7"],"type":"string"},"spotify_url":{"description":"Spotify url for this podcast","examples":["https://open.spotify.com/show/2rQJUP9Y3HxemiW3JHt9WV"],"type":"string"},"twitter_handle":{"description":"Twitter username affiliated with this podcast","examples":["SW7x7podcast"],"type":"string"},"url1":{"description":"Url affiliated with this podcast","type":"string"},"url2":{"description":"Url affiliated with this podcast","type":"string"},"url3":{"description":"Url affiliated with this podcast","type":"string"},"wechat_handle":{"description":"WeChat username affiliated with this podcast","type":"string"},"youtube_url":{"description":"YouTube url affiliated with this podcast","examples":["https://www.youtube.com/sw7x7"],"type":"string"}},"type":"object"},"PodcastFull":{"properties":{"audio_length_sec":{"$ref":"#/components/schemas/AvgAudioLengthSecField"},"country":{"$ref":"#/components/schemas/CountryField"},"description":{"$ref":"#/components/schemas/PodcastDescriptionField"},"earliest_pub_date_ms":{"$ref":"#/components/schemas/EarliestPubDateMsField"},"email":{"$ref":"#/components/schemas/EmailField"},"episodes":{"items":{"$ref":"#/components/schemas/EpisodeMinimum"},"type":"array"},"explicit_content":{"$ref":"#/components/schemas/ExplicitField"},"extra":{"$ref":"#/components/schemas/PodcastExtraField"},"genre_ids":{"$ref":"#/components/schemas/GenreIdsField"},"id":{"$ref":"#/components/schemas/PodcastIdField"},"image":{"$ref":"#/components/schemas/ImageField"},"is_claimed":{"$ref":"#/components/schemas/IsClaimedField"},"itunes_id":{"$ref":"#/components/schemas/iTunesIdField"},"language":{"$ref":"#/components/schemas/LanguageField"},"latest_episode_id":{"$ref":"#/components/schemas/LatestEpisodeIdField"},"latest_pub_date_ms":{"$ref":"#/components/schemas/LatestPubDateMsField"},"listen_score":{"$ref":"#/components/schemas/ListenScoreField"},"listen_score_global_rank":{"$ref":"#/components/schemas/ListenScoreGlobalRankField"},"listennotes_url":{"$ref":"#/components/schemas/PodcastLNUrlField"},"looking_for":{"$ref":"#/components/schemas/PodcastLookingForField"},"next_episode_pub_date":{"$ref":"#/components/schemas/NextEpisodePubDateField"},"publisher":{"$ref":"#/components/schemas/PublisherField"},"rss":{"$ref":"#/components/schemas/RssField"},"thumbnail":{"$ref":"#/components/schemas/ThumbnailField"},"title":{"$ref":"#/components/schemas/PodcastNameField"},"total_episodes":{"$ref":"#/components/schemas/TotalEpisodesField"},"type":{"$ref":"#/components/schemas/PodcastTypeField"},"update_frequency_hours":{"$ref":"#/components/schemas/UpdateFrequencyHoursField"},"website":{"$ref":"#/components/schemas/WebsiteField"}},"type":"object"},"PodcastIdField":{"description":"Podcast id, which can be used to further fetch detailed podcast metadata via `GET /podcasts/{id}`.","examples":["4d3fe717742d4963a85562e9f84d8c79"],"type":"string"},"PodcastLNUrlField":{"description":"The url of this podcast on [ListenNotes.com](https://www.ListenNotes.com).","examples":["https://www.listennotes.com/c/4d3fe717742d4963a85562e9f84d8c79/"],"type":"string"},"PodcastLookingForField":{"properties":{"cohosts":{"description":"Whether this podcast is looking for cohosts.","examples":[true],"type":"boolean"},"cross_promotion":{"description":"Whether this podcast is looking for cross promotion opportunities with other podcasts.","examples":[true],"type":"boolean"},"guests":{"description":"Whether this podcast is looking for guests.","examples":[true],"type":"boolean"},"sponsors":{"description":"Whether this podcast is looking for sponsors.","examples":[true],"type":"boolean"}},"type":"object"},"PodcastMinimum":{"properties":{"id":{"$ref":"#/components/schemas/PodcastIdField"},"image":{"$ref":"#/components/schemas/ImageField"},"listen_score":{"$ref":"#/components/schemas/ListenScoreField"},"listen_score_global_rank":{"$ref":"#/components/schemas/ListenScoreGlobalRankField"},"listennotes_url":{"$ref":"#/components/schemas/PodcastLNUrlField"},"publisher":{"$ref":"#/components/schemas/PublisherField"},"thumbnail":{"$ref":"#/components/schemas/ThumbnailField"},"title":{"$ref":"#/components/schemas/PodcastNameField"}},"type":"object"},"PodcastMinimumRss":{"properties":{"id":{"$ref":"#/components/schemas/PodcastIdField"},"image":{"$ref":"#/components/schemas/ImageField"},"listennotes_url":{"$ref":"#/components/schemas/PodcastLNUrlField"},"publisher":{"$ref":"#/components/schemas/PublisherField"},"rss":{"$ref":"#/components/schemas/RssField"},"thumbnail":{"$ref":"#/components/schemas/ThumbnailField"},"title":{"$ref":"#/components/schemas/PodcastNameField"}},"type":"object"},"PodcastNameField":{"description":"Podcast name.","examples":["Star Wars 7x7 | Star Wars News, Interviews, and More!"],"type":"string"},"PodcastSearchResult":{"description":"When **type** is *podcast*.","properties":{"audio_length_sec":{"$ref":"#/components/schemas/AvgAudioLengthSecField"},"description_highlighted":{"description":"Highlighted segment of podcast description","examples":["...Join host Allen Voivod for <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> news, history, interviews, trivia, and deep dives into the <span class=\"ln-search-highlight\">Star</span> <span class=\"ln-search-highlight\">Wars</span> story as told in movies, books, comics, games, cartoons, and more.\n"],"type":"string"},"description_original":{"description":"Plain text of podcast description","examples":["The Star Wars 7x7 Podcast is Rebel-rousing fun for everyday Jedi, between 7 and 14 minutes a day, 7 days a week. Join host Allen Voivod for Star Wars news, history, interviews, trivia, and deep dives into the Star Wars story as told in movies, books, comics, games, cartoons, and more. Subscribe now for your daily dose of Star Wars joy. It's destiny unleashed! #SW7x7\n"],"type":"string"},"earliest_pub_date_ms":{"$ref":"#/components/schemas/EarliestPubDateMsField"},"email":{"$ref":"#/components/schemas/EmailField"},"explicit_content":{"$ref":"#/components/schemas/ExplicitField"},"genre_ids":{"$ref":"#/components/schemas/GenreIdsField"},"id":{"$ref":"#/components/schemas/PodcastIdField"},"image":{"$ref":"#/components/schemas/ImageField"},"itunes_id":{"$ref":"#/components/schemas/iTunesIdField"},"latest_episode_id":{"$ref":"#/components/schemas/LatestEpisodeIdField"},"latest_pub_date_ms":{"$ref":"#/components/schemas/LatestPubDateMsField"},"listen_score":{"$ref":"#/components/schemas/ListenScoreField"},"listen_score_global_rank":{"$ref":"#/components/schemas/ListenScoreGlobalRankField"},"listennotes_url":{"$ref":"#/components/schemas/PodcastLNUrlField"},"publisher_highlighted":{"$ref":"#/components/schemas/PublisherHighlightedField"},"publisher_original":{"$ref":"#/components/schemas/PublisherOriginalField"},"rss":{"$ref":"#/components/schemas/RssField"},"thumbnail":{"$ref":"#/components/schemas/ThumbnailField"},"title_highlighted":{"$ref":"#/components/schemas/PodcastTitleHighlightedField"},"title_original":{"$ref":"#/components/schemas/PodcastTitleOriginalField"},"total_episodes":{"$ref":"#/components/schemas/TotalEpisodesField"},"update_frequency_hours":{"$ref":"#/components/schemas/UpdateFrequencyHoursField"},"website":{"$ref":"#/components/schemas/WebsiteField"}},"type":"object"},"PodcastSimple":{"properties":{"audio_length_sec":{"$ref":"#/components/schemas/AvgAudioLengthSecField"},"country":{"$ref":"#/components/schemas/CountryField"},"description":{"$ref":"#/components/schemas/PodcastDescriptionField"},"earliest_pub_date_ms":{"$ref":"#/components/schemas/EarliestPubDateMsField"},"email":{"$ref":"#/components/schemas/EmailField"},"explicit_content":{"$ref":"#/components/schemas/ExplicitField"},"extra":{"$ref":"#/components/schemas/PodcastExtraField"},"genre_ids":{"$ref":"#/components/schemas/GenreIdsField"},"id":{"$ref":"#/components/schemas/PodcastIdField"},"image":{"$ref":"#/components/schemas/ImageField"},"is_claimed":{"$ref":"#/components/schemas/IsClaimedField"},"itunes_id":{"$ref":"#/components/schemas/iTunesIdField"},"language":{"$ref":"#/components/schemas/LanguageField"},"latest_episode_id":{"$ref":"#/components/schemas/LatestEpisodeIdField"},"latest_pub_date_ms":{"$ref":"#/components/schemas/LatestPubDateMsField"},"listen_score":{"$ref":"#/components/schemas/ListenScoreField"},"listen_score_global_rank":{"$ref":"#/components/schemas/ListenScoreGlobalRankField"},"listennotes_url":{"$ref":"#/components/schemas/PodcastLNUrlField"},"looking_for":{"$ref":"#/components/schemas/PodcastLookingForField"},"publisher":{"$ref":"#/components/schemas/PublisherField"},"rss":{"$ref":"#/components/schemas/RssField"},"thumbnail":{"$ref":"#/components/schemas/ThumbnailField"},"title":{"$ref":"#/components/schemas/PodcastNameField"},"total_episodes":{"$ref":"#/components/schemas/TotalEpisodesField"},"type":{"$ref":"#/components/schemas/PodcastTypeField"},"update_frequency_hours":{"$ref":"#/components/schemas/UpdateFrequencyHoursField"},"website":{"$ref":"#/components/schemas/WebsiteField"}},"type":"object"},"PodcastTitleHighlightedField":{"description":"Highlighted segment of podcast name.","examples":["<span class=\\\"ln-search-highlight\\\">Star</span> <span class=\\\"ln-search-highlight\\\">Wars</span> 7x7 | <span class=\\\"ln-search-highlight\\\">Star</span> <span class=\\\"ln-search-highlight\\\">Wars</span> News, Interviews, and More!"],"type":"string"},"PodcastTitleOriginalField":{"description":"Plain text of podcast name.","examples":["Star Wars 7x7 | Star Wars News, Interviews, and More!"],"type":"string"},"PodcastTypeField":{"description":"The type of this podcast - episodic or serial.","enum":["episodic","serial"],"examples":["episodic"],"type":"string"},"PodcastTypeaheadResult":{"properties":{"explicit_content":{"$ref":"#/components/schemas/ExplicitField"},"id":{"$ref":"#/components/schemas/PodcastIdField"},"image":{"$ref":"#/components/schemas/ImageField"},"publisher_highlighted":{"$ref":"#/components/schemas/PublisherHighlightedField"},"publisher_original":{"$ref":"#/components/schemas/PublisherOriginalField"},"thumbnail":{"$ref":"#/components/schemas/ThumbnailField"},"title_highlighted":{"$ref":"#/components/schemas/PodcastTitleHighlightedField"},"title_original":{"$ref":"#/components/schemas/PodcastTitleOriginalField"}},"type":"object"},"PublisherField":{"description":"Podcast publisher name.","examples":["Planet Broadcasting"],"type":"string"},"PublisherHighlightedField":{"description":"Highlighted segment of this podcast's publisher name.","examples":["<span class=\\\"ln-search-highlight\\\">Star</span> <span class=\\\"ln-search-highlight\\\">Wars</span> Daily, by Allen Voivod"],"type":"string"},"PublisherOriginalField":{"description":"Plain text of this podcast's publisher name.","examples":["Star Wars Daily, by Allen Voivod"],"type":"string"},"RelatedSearchesResponse":{"properties":{"terms":{"description":"Related search terms","examples":[["evergrande stock","evergrande china","evergrande group","evergrande news"]],"items":{"type":"string"},"type":"array"}},"required":["terms"],"type":"object"},"RssField":{"description":"RSS url of this podcast. This field is available only in the PRO/ENTERPRISE plan.","examples":["https://sw7x7.libsyn.com/rss"],"type":"string"},"SearchResponse":{"properties":{"count":{"description":"The number of search results in this page.","examples":[10],"type":"integer"},"next_offset":{"description":"Pass this value to the **offset** parameter to do pagination of search results.","examples":[10],"type":"integer"},"results":{"description":"A list of search results.","items":{"oneOf":[{"$ref":"#/components/schemas/EpisodeSearchResult"},{"$ref":"#/components/schemas/PodcastSearchResult"},{"$ref":"#/components/schemas/CuratedListSearchResult"}]},"type":"array"},"took":{"description":"The time it took to fetch these search results. In seconds.","examples":[0.093],"type":"number"},"total":{"description":"The total number of search results.","examples":[1989],"type":"integer"}},"type":"object"},"SpellCheckResponse":{"properties":{"corrected_text_html":{"description":"The corrected text for the entire search term (multiple words/tokens), where misspelled tokens are replaced with the correct texts and html tags <b><i>","examples":["<b><i>evergrande</i></b> stock"],"type":"string"},"tokens":{"description":"The word in the text query string that is not spelled correctly","items":{"properties":{"offset":{"description":"The zero-based offset from the beginning of the text query string to the word that is misspelled","examples":[5],"type":"integer"},"suggestion":{"description":"A word that corrects the spelling error","examples":["evergrande"],"type":"string"},"token":{"description":"The misspelled word","examples":["evergrand"],"type":"string"}},"type":"object"},"type":"array"}},"required":["tokens","corrected_text_html"],"type":"object"},"SubmitPodcastForm":{"properties":{"email":{"description":"A valid email address. If **email** is specified, then we'll notify this email address once the podcast is accepted.","examples":["hello@example.com"],"type":"string"},"rss":{"description":"A valid podcast rss url.","examples":["https://feeds.megaphone.fm/committed"],"type":"string"}},"required":["rss"],"type":"object"},"SubmitPodcastResponse":{"properties":{"podcast":{"$ref":"#/components/schemas/PodcastMinimum"},"status":{"description":"The status of this submission.","enum":["found","in review","rejected"],"examples":["found"],"type":"string"}},"required":["podcast","status"],"type":"object"},"ThumbnailField":{"description":"Thumbnail image url for this podcast's artwork (300x300).","examples":["https://cdn-images-1.listennotes.com/podcasts/exponent-ben-thompson-james-allworth-OaJSjb4xQv3.300x300.jpg"],"type":"string"},"TotalEpisodesField":{"description":"Total number of episodes in this podcast.","examples":[324],"type":"integer"},"TranscriptField":{"description":"The transcript of this episode, in plain text (with the newline character \\n). If there's not transcript, it is null. This field is available only in the PRO/ENTERPRISE plan.","examples":["00:00:07 Welcome to this podcast...\n"],"type":"string"},"TrendingSearchesResponse":{"properties":{"terms":{"description":"Trending search terms","examples":[["Taliban","Andrew Cuomo","john McAfee"]],"items":{"type":"string"},"type":"array"}},"required":["terms"],"type":"object"},"TypeaheadResponse":{"properties":{"genres":{"description":"Genre suggestions. It'll show up when the **show_genres** parameter is *1*.","items":{"$ref":"#/components/schemas/Genre"},"type":"array"},"podcasts":{"description":"Podcast suggestions. It'll show up when the **show_podcasts** parameter is 1.","items":{"$ref":"#/components/schemas/PodcastTypeaheadResult"},"type":"array"},"terms":{"description":"Search term suggestions.","examples":[["startup sales","startup","startups","star wars"]],"items":{"type":"string"},"type":"array"}},"required":["terms"],"type":"object"},"UpdateFrequencyHoursField":{"description":"How frequently does this podcast release a new episode? In hours. For example, if the value is 166, then it's every 166 hours (or weekly).","examples":[168],"type":"integer"},"WebsiteField":{"description":"Website url of this podcast.","examples":["http://sw7x7.com/"],"type":"string"},"iTunesIdField":{"description":"iTunes id for this podcast.","examples":[896354638],"type":"integer"}}},"webhooks":{"podcastDeleted":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PodcastMinimumRss"}}},"description":"Triggered by your request to DELETE /podcasts/{id}, if the podcast is actually deleted."},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"podcastsSubmitAccepted":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PodcastMinimumRss"}}},"description":"Triggered by your request to POST /podcasts/submit, if the podcast submission is accepted."},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}},"podcastsSubmitRejected":{"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"podcast":{"properties":{"rss":{"$ref":"#/components/schemas/RssField"}},"type":"object"}},"type":"object"}}},"description":"Triggered by your request to POST /podcasts/submit, if the podcast submission is rejected."},"responses":{"200":{"description":"Return a 200 status to indicate that the data was received successfully"}}}}}}