{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://apizie.tech"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/entertainment:listennotes/get-best-podcasts":{"get":{"operationId":"entertainment_listennotes_get_best_podcasts","summary":"Fetch a list of best podcasts by genre","description":"GET /best_podcasts","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"genre_id","in":"query","required":false,"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.","schema":{"type":"string","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."}},{"name":"page","in":"query","required":false,"description":"Page number of those podcasts in this genre.","schema":{"type":"integer","description":"Page number of those podcasts in this genre."}},{"name":"region","in":"query","required":false,"description":"Filter best podcasts by country/region. Please note that podcasts that are \"best\" in a country/region may not be produced in that…","schema":{"type":"string","default":"us","description":"Filter best podcasts by country/region. Please note that podcasts that are \"best\" in a country/region may not be produced in that…"}},{"name":"publisher_region","in":"query","required":false,"description":"Filter best podcasts by the publisher's country/region. This is to narrow down the results to include \"best podcasts\" produced in a…","schema":{"type":"string","description":"Filter best podcasts by the publisher's country/region. This is to narrow down the results to include \"best podcasts\" produced in a…"}},{"name":"language","in":"query","required":false,"description":"Filter best podcasts by language. You can get a list of supported languages (e.g., English, Chinese, Japanese...) from `GET /languages`.…","schema":{"type":"string","description":"Filter best podcasts by language. You can get a list of supported languages (e.g., English, Chinese, Japanese...) from `GET /languages`.…"}},{"name":"sort","in":"query","required":false,"description":"How do you want to sort these podcasts? If you'd like to sort by popularity, please use **listen_score**.","schema":{"type":"string","enum":["recent_added_first","oldest_added_first","recent_published_first","oldest_published_first","listen_score"],"default":"recent_added_first","description":"How do you want to sort these podcasts? If you'd like to sort by popularity, please use **listen_score**."},"example":"listen_score"},{"name":"safe_mode","in":"query","required":false,"description":"Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.","schema":{"type":"integer","enum":[0,1],"default":0,"description":"Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-curated-podcasts":{"get":{"operationId":"entertainment_listennotes_get_curated_podcasts","summary":"Fetch curated lists of podcasts","description":"GET /curated_podcasts","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"page","in":"query","required":false,"description":"Page number of curated lists.","schema":{"type":"integer","default":1,"description":"Page number of curated lists."},"example":2}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-curated-podcast-by-id":{"get":{"operationId":"entertainment_listennotes_get_curated_podcast_by_id","summary":"Fetch a curated list of podcasts by id","description":"GET /curated_podcasts/{id}","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"id","in":"query","required":true,"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`.","schema":{"type":"string","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`."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-episodes-in-batch":{"post":{"operationId":"entertainment_listennotes_get_episodes_in_batch","summary":"Batch fetch basic meta data for episodes","description":"POST /episodes","tags":["entertainment"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["X-ListenAPI-Key","body"],"properties":{"X-ListenAPI-Key":{"type":"string","description":"Get API Key on listennotes.com/api"},"body":{"type":"object","description":"Form fields as a JSON object"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-episode-by-id":{"get":{"operationId":"entertainment_listennotes_get_episode_by_id","summary":"Fetch detailed meta data for an episode by id","description":"GET /episodes/{id}","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"id","in":"query","required":true,"description":"id for a specific episode. You can get episode id from using other endpoints, e.g., `GET /search`...","schema":{"type":"string","description":"id for a specific episode. You can get episode id from using other endpoints, e.g., `GET /search`..."}},{"name":"show_transcript","in":"query","required":false,"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…","schema":{"type":"integer","default":0,"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…"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-episode-recommendations":{"get":{"operationId":"entertainment_listennotes_get_episode_recommendations","summary":"Fetch recommendations for an episode","description":"GET /episodes/{id}/recommendations","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"id","in":"query","required":true,"description":"Episode id.","schema":{"type":"string","description":"Episode id."},"example":"254444fa6cf64a43a95292a70eb6869b"},{"name":"safe_mode","in":"query","required":false,"description":"Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.","schema":{"type":"integer","enum":[0,1],"default":0,"description":"Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-genres":{"get":{"operationId":"entertainment_listennotes_get_genres","summary":"Fetch a list of podcast genres","description":"GET /genres","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"top_level_only","in":"query","required":false,"description":"Just show top level genres? If 1, yes, just show top level genres. If 0, no, show all genres.","schema":{"type":"integer","enum":[0,1],"default":0,"description":"Just show top level genres? If 1, yes, just show top level genres. If 0, no, show all genres."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/just-listen":{"get":{"operationId":"entertainment_listennotes_just_listen","summary":"Fetch a random podcast episode","description":"GET /just_listen","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-languages":{"get":{"operationId":"entertainment_listennotes_get_languages","summary":"Fetch a list of supported languages for podcasts","description":"GET /languages","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-playlists":{"get":{"operationId":"entertainment_listennotes_get_playlists","summary":"Fetch a list of your playlists.","description":"GET /playlists","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"sort","in":"query","required":false,"description":"How do you want to sort playlists?","schema":{"type":"string","enum":["recent_added_first","oldest_added_first","name_a_to_z","name_z_to_a"],"default":"recent_added_first","description":"How do you want to sort playlists?"}},{"name":"page","in":"query","required":false,"description":"Page number of playlists.","schema":{"type":"integer","default":1,"description":"Page number of playlists."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-playlist-by-id":{"get":{"operationId":"entertainment_listennotes_get_playlist_by_id","summary":"Fetch a playlist's info and items (i.e., episodes or podcasts).","description":"GET /playlists/{id}","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"id","in":"query","required":true,"description":"Playlist id (always 11 characters, e.g., m1pe7z60bsw). You can get the podcast id from the url of a playlist, e.g., m1pe7z60bsw is the…","schema":{"type":"string","description":"Playlist id (always 11 characters, e.g., m1pe7z60bsw). You can get the podcast id from the url of a playlist, e.g., m1pe7z60bsw is the…"},"example":"m1pe7z60bsw"},{"name":"type","in":"query","required":false,"description":"The type of this playlist, which should be either **episode_list** or **podcast_list**.","schema":{"type":"string","enum":["episode_list","podcast_list"],"default":"episode_list","description":"The type of this playlist, which should be either **episode_list** or **podcast_list**."}},{"name":"last_timestamp_ms","in":"query","required":false,"description":"For playlist items pagination. It's the value of **last_timestamp_ms** from the response of last request. If it's 0 or not specified, just…","schema":{"type":"integer","default":0,"description":"For playlist items pagination. It's the value of **last_timestamp_ms** from the response of last request. If it's 0 or not specified, just…"}},{"name":"sort","in":"query","required":false,"description":"How do you want to sort playlist items?","schema":{"type":"string","enum":["recent_added_first","oldest_added_first","recent_published_first","oldest_published_first"],"default":"recent_added_first","description":"How do you want to sort playlist items?"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-podcasts-in-batch":{"post":{"operationId":"entertainment_listennotes_get_podcasts_in_batch","summary":"Batch fetch basic meta data for podcasts","description":"POST /podcasts","tags":["entertainment"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["X-ListenAPI-Key"],"properties":{"X-ListenAPI-Key":{"type":"string","description":"Get API Key on listennotes.com/api"},"body":{"type":"object","description":"Form fields as a JSON object"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-podcasts-by-domain-name":{"get":{"operationId":"entertainment_listennotes_get_podcasts_by_domain_name","summary":"Fetch podcasts by a publisher's domain name","description":"GET /podcasts/domains/{domain_name}","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"domain_name","in":"query","required":true,"description":"A publisher's domain name, e.g., nytimes.com, wondery.com, npr.org...","schema":{"type":"string","description":"A publisher's domain name, e.g., nytimes.com, wondery.com, npr.org..."},"example":"nytimes.com"},{"name":"page","in":"query","required":false,"description":"Page number of the podcasts from this domain name","schema":{"type":"integer","default":1,"description":"Page number of the podcasts from this domain name"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/submit-podcast":{"post":{"operationId":"entertainment_listennotes_submit_podcast","summary":"Submit a podcast to Listen Notes database","description":"POST /podcasts/submit","tags":["entertainment"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["X-ListenAPI-Key","body"],"properties":{"X-ListenAPI-Key":{"type":"string","description":"Get API Key on listennotes.com/api"},"body":{"type":"object","description":"Form fields as a JSON object"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-podcast-by-id":{"get":{"operationId":"entertainment_listennotes_get_podcast_by_id","summary":"Fetch detailed meta data and episodes for a podcast by id","description":"GET /podcasts/{id}","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"id","in":"query","required":true,"description":"Podcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`...","schema":{"type":"string","description":"Podcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`..."},"example":"4d3fe717742d4963a85562e9f84d8c79"},{"name":"next_episode_pub_date","in":"query","required":false,"description":"For episodes pagination. It's the value of **next_episode_pub_date** from the response of last request. If not specified, just return…","schema":{"type":"integer","description":"For episodes pagination. It's the value of **next_episode_pub_date** from the response of last request. If not specified, just return…"},"example":1479154463000},{"name":"sort","in":"query","required":false,"description":"How do you want to sort the episodes of this podcast?","schema":{"type":"string","enum":["recent_first","oldest_first"],"default":"recent_first","description":"How do you want to sort the episodes of this podcast?"},"example":"recent_first"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/delete-podcast-by-id":{"post":{"operationId":"entertainment_listennotes_delete_podcast_by_id","summary":"Request to delete a podcast","description":"DELETE /podcasts/{id}","tags":["entertainment"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["X-ListenAPI-Key","id"],"properties":{"X-ListenAPI-Key":{"type":"string","description":"Get API Key on listennotes.com/api"},"id":{"type":"string","description":"Podcast id. You can get podcast id from using other endpoints, e.g., `GET /search`, `GET /best_podcasts`..."},"reason":{"type":"string","description":"The reason why this podcast should be deleted, e.g., copyright violation, the podcaster wants to delete it... You can put \"testing\" here…"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-podcast-audience":{"get":{"operationId":"entertainment_listennotes_get_podcast_audience","summary":"Fetch audience demographics for a podcast","description":"GET /podcasts/{id}/audience","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"id","in":"query","required":true,"description":"Podcast id.","schema":{"type":"string","description":"Podcast id."},"example":"25212ac3c53240a880dd5032e547047b"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-podcast-recommendations":{"get":{"operationId":"entertainment_listennotes_get_podcast_recommendations","summary":"Fetch recommendations for a podcast","description":"GET /podcasts/{id}/recommendations","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"id","in":"query","required":true,"description":"Podcast id.","schema":{"type":"string","description":"Podcast id."},"example":"25212ac3c53240a880dd5032e547047b"},{"name":"safe_mode","in":"query","required":false,"description":"Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no.","schema":{"type":"integer","enum":[0,1],"default":0,"description":"Whether or not to exclude podcasts with explicit language. 1 is yes, and 0 is no."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-regions":{"get":{"operationId":"entertainment_listennotes_get_regions","summary":"Fetch a list of supported countries/regions for best podcasts","description":"GET /regions","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-related-searches":{"get":{"operationId":"entertainment_listennotes_get_related_searches","summary":"Fetch related search terms","description":"GET /related_searches","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"q","in":"query","required":true,"description":"Search term, e.g., person, place, topic...","schema":{"type":"string","description":"Search term, e.g., person, place, topic..."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/search":{"get":{"operationId":"entertainment_listennotes_search","summary":"Full-text search","description":"GET /search","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"q","in":"query","required":true,"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…","schema":{"type":"string","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…"}},{"name":"sort_by_date","in":"query","required":false,"description":"Sort by date or not? If 0, then sort by relevance. If 1, then sort by date.","schema":{"type":"integer","enum":[0,1],"default":0,"description":"Sort by date or not? If 0, then sort by relevance. If 1, then sort by date."}},{"name":"type","in":"query","required":false,"description":"What type of contents do you want to search for?","schema":{"type":"string","enum":["episode","podcast","curated"],"default":"episode","description":"What type of contents do you want to search for?"}},{"name":"offset","in":"query","required":false,"description":"Offset for search results, for pagination. You'll use **next_offset** from response for this parameter.","schema":{"type":"integer","default":0,"description":"Offset for search results, for pagination. You'll use **next_offset** from response for this parameter."}},{"name":"len_min","in":"query","required":false,"description":"Minimum audio length in minutes. Applicable only when **type** parameter is **episode** or **podcast**. If **type** parameter is…","schema":{"type":"integer","default":0,"description":"Minimum audio length in minutes. Applicable only when **type** parameter is **episode** or **podcast**. If **type** parameter is…"}},{"name":"len_max","in":"query","required":false,"description":"Maximum audio length in minutes. Applicable only when **type** parameter is **episode** or **podcast**. If **type** parameter is…","schema":{"type":"integer","description":"Maximum audio length in minutes. Applicable only when **type** parameter is **episode** or **podcast**. If **type** parameter is…"}},{"name":"episode_count_min","in":"query","required":false,"description":"Minimum number of episodes. Applicable only when type parameter is **podcast**.","schema":{"type":"integer","description":"Minimum number of episodes. Applicable only when type parameter is **podcast**."}},{"name":"episode_count_max","in":"query","required":false,"description":"Maximum number of episodes. Applicable only when type parameter is **podcast**.","schema":{"type":"integer","description":"Maximum number of episodes. Applicable only when type parameter is **podcast**."}},{"name":"update_freq_min","in":"query","required":false,"description":"Minimum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find \"weekly\"…","schema":{"type":"integer","description":"Minimum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find \"weekly\"…"}},{"name":"update_freq_max","in":"query","required":false,"description":"Maximum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find \"weekly\"…","schema":{"type":"integer","description":"Maximum update frequency in hours (how frequently does a podcast release a new episode). For example, if you want to find \"weekly\"…"}},{"name":"genre_ids","in":"query","required":false,"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…","schema":{"type":"string","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…"}},{"name":"published_before","in":"query","required":false,"description":"Only show episodes/podcasts/curated lists published before this timestamp (in milliseconds). If **published_before** & **published_after**…","schema":{"type":"integer","description":"Only show episodes/podcasts/curated lists published before this timestamp (in milliseconds). If **published_before** & **published_after**…"}},{"name":"published_after","in":"query","required":false,"description":"Only show episodes/podcasts/curated lists published after this timestamp (in milliseconds). If **published_before** & **published_after**…","schema":{"type":"integer","default":0,"description":"Only show episodes/podcasts/curated lists published after this timestamp (in milliseconds). If **published_before** & **published_after**…"}},{"name":"only_in","in":"query","required":false,"description":"A comma-delimited string to search only in specific fields. Allowed values are title, description, author, and audio. If not specified,…","schema":{"type":"string","default":"title,description,author,audio","description":"A comma-delimited string to search only in specific fields. Allowed values are title, description, author, and audio. If not specified,…"}},{"name":"language","in":"query","required":false,"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…","schema":{"type":"string","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…"}},{"name":"region","in":"query","required":false,"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…","schema":{"type":"string","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…"}},{"name":"ocid","in":"query","required":false,"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…","schema":{"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…"}},{"name":"ncid","in":"query","required":false,"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…","schema":{"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…"}},{"name":"safe_mode","in":"query","required":false,"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…","schema":{"type":"integer","enum":[0,1],"default":0,"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…"}},{"name":"unique_podcasts","in":"query","required":false,"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*.","schema":{"type":"integer","enum":[0,1],"default":0,"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*."}},{"name":"page_size","in":"query","required":false,"description":"The maximum number of search results per page. A valid value should be an integer between 1 and 10 (inclusive).","schema":{"type":"integer","default":10,"description":"The maximum number of search results per page. A valid value should be an integer between 1 and 10 (inclusive)."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/spellcheck":{"get":{"operationId":"entertainment_listennotes_spellcheck","summary":"Spell check on a search term","description":"GET /spellcheck","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"q","in":"query","required":true,"description":"Search term, e.g., person, place, topic...","schema":{"type":"string","description":"Search term, e.g., person, place, topic..."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/get-trending-searches":{"get":{"operationId":"entertainment_listennotes_get_trending_searches","summary":"Fetch trending search terms","description":"GET /trending_searches","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}},"/v1/entertainment:listennotes/typeahead":{"get":{"operationId":"entertainment_listennotes_typeahead","summary":"Typeahead search","description":"GET /typeahead","tags":["entertainment"],"parameters":[{"name":"X-ListenAPI-Key","in":"query","required":true,"description":"Get API Key on listennotes.com/api","schema":{"type":"string","description":"Get API Key on listennotes.com/api"}},{"name":"q","in":"query","required":true,"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…","schema":{"type":"string","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…"}},{"name":"show_podcasts","in":"query","required":false,"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…","schema":{"type":"integer","enum":[0,1],"default":0,"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…"}},{"name":"show_genres","in":"query","required":false,"description":"Whether or not to autosuggest genres. 1 is yes, 0 is no.","schema":{"type":"integer","enum":[0,1],"default":0,"description":"Whether or not to autosuggest genres. 1 is yes, 0 is no."}},{"name":"safe_mode","in":"query","required":false,"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*.","schema":{"type":"integer","enum":[0,1],"default":0,"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*."}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":60,"x-apizie-min-plan":null,"x-apizie-bulk":true,"x-apizie-status":"live"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}