{"ok":true,"site":"tvmaze","host":"tvmaze.com","about":"TVmaze is a TV show database and guide. This CLI uses its free public JSON API (api.tvmaze.com) to search shows and people, look up shows by external IDs, and fetch show details, episodes, seasons, cast, crew, alternate titles, images, characters, person credits, TV and streaming schedules, and recent show updates.","commands":[{"command":"search-shows","summary":"Fuzzy-search shows by name; returns scored matches with full show objects","params":[{"name":"q","type":"string","required":true,"description":"Show name or keywords"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/search-shows?q=breaking+bad"},{"command":"search-people","summary":"Fuzzy-search people (actors, crew) by name","params":[{"name":"q","type":"string","required":true,"description":"Person name"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/search-people?q=bryan+cranston"},{"command":"single-search-show","summary":"Return the single best-matching show for a name, optionally with embedded episodes, cast or other data","params":[{"name":"q","type":"string","required":true,"description":"Show name"},{"name":"embed","type":"string","description":"Related resource to embed under _embedded","oneOf":["episodes","cast","seasons","crew","nextepisode","previousepisode","akas","images"]}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/single-search-show?q=breaking+bad"},{"command":"lookup-show","summary":"Find a show by external ID (IMDb, TheTVDB or TVRage). Pass exactly one ID.","params":[{"name":"imdb","type":"string","description":"IMDb ID, e.g. tt0903747"},{"name":"thetvdb","type":"string","description":"TheTVDB show ID, e.g. 81189"},{"name":"tvrage","type":"string","description":"TVRage show ID"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/lookup-show?imdb=tt0903747"},{"command":"get-show","summary":"Get a show's main details by TVmaze show ID, optionally with embedded cast or next/previous episode","params":[{"name":"id","type":"number","required":true,"description":"TVmaze show ID (from search results or the /shows/{id}/slug URL)"},{"name":"embed","type":"string","description":"Related resource to embed under _embedded","oneOf":["cast","nextepisode","previousepisode","episodes","seasons","crew","akas","images"]}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/get-show"},{"command":"list-show-episodes","summary":"List all episodes of a show in airing order, optionally including specials","params":[{"name":"id","type":"number","required":true,"description":"TVmaze show ID"},{"name":"specials","type":"number","description":"Set to 1 to include special episodes","oneOf":["1"]}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-show-episodes"},{"command":"get-episode-by-number","summary":"Get one episode of a show by season and episode number","params":[{"name":"id","type":"number","required":true,"description":"TVmaze show ID"},{"name":"season","type":"number","required":true,"description":"Season number"},{"name":"number","type":"number","required":true,"description":"Episode number within the season"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/get-episode-by-number?season=1&number=1"},{"command":"list-episodes-by-date","summary":"List a show's episodes that aired on a given date","params":[{"name":"id","type":"number","required":true,"description":"TVmaze show ID"},{"name":"date","type":"string","required":true,"description":"Air date in ISO 8601 format, e.g. 2008-01-20"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-episodes-by-date?date=2008-01-20"},{"command":"list-show-seasons","summary":"List a show's seasons with their season IDs, dates, episode counts and networks","params":[{"name":"id","type":"number","required":true,"description":"TVmaze show ID"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-show-seasons"},{"command":"list-season-episodes","summary":"List the episodes of a season by its TVmaze season ID (from list-show-seasons)","params":[{"name":"id","type":"number","required":true,"description":"TVmaze season ID (not the season number)"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-season-episodes"},{"command":"list-show-cast","summary":"List a show's main cast: each person with the character they play","params":[{"name":"id","type":"number","required":true,"description":"TVmaze show ID"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-show-cast"},{"command":"list-show-crew","summary":"List a show's crew (creators, producers and so on) with their crew type","params":[{"name":"id","type":"number","required":true,"description":"TVmaze show ID"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-show-crew"},{"command":"list-show-akas","summary":"List a show's alternate titles (AKAs) by country","params":[{"name":"id","type":"number","required":true,"description":"TVmaze show ID"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-show-akas"},{"command":"list-show-images","summary":"List a show's images (posters, banners, backgrounds) with their URLs","params":[{"name":"id","type":"number","required":true,"description":"TVmaze show ID"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-show-images"},{"command":"list-shows","summary":"Page through the full show index, ordered by show ID (up to 250 shows per page)","params":[{"name":"page","type":"number","description":"Zero-based page number. Each page covers a block of 250 show IDs.","default":0}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-shows?page=0"},{"command":"get-episode","summary":"Get an episode's details by episode ID, with its parent show embedded","params":[{"name":"id","type":"number","required":true,"description":"TVmaze episode ID (from episode lists or the /episodes/{id}/slug URL)"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/get-episode"},{"command":"list-episode-guest-cast","summary":"List the guest cast of an episode: each person with the character they play","params":[{"name":"id","type":"number","required":true,"description":"TVmaze episode ID"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-episode-guest-cast"},{"command":"get-person","summary":"Get a person's details (birthday, country, gender, image) by person ID","params":[{"name":"id","type":"number","required":true,"description":"TVmaze person ID (from search-people, cast lists or the /people/{id}/slug URL)"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/get-person"},{"command":"list-person-cast-credits","summary":"List the shows a person was main cast in, with show details embedded","params":[{"name":"id","type":"number","required":true,"description":"TVmaze person ID"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-person-cast-credits"},{"command":"list-person-crew-credits","summary":"List a person's crew credits (for example Creator or Executive Producer), with show details embedded","params":[{"name":"id","type":"number","required":true,"description":"TVmaze person ID"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-person-crew-credits"},{"command":"list-person-guest-credits","summary":"List the episodes a person guest-starred in, with episode details embedded","params":[{"name":"id","type":"number","required":true,"description":"TVmaze person ID"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-person-guest-credits"},{"command":"get-character","summary":"Get a character's details by character ID","params":[{"name":"id","type":"number","required":true,"description":"TVmaze character ID (from cast lists)"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/get-character"},{"command":"get-schedule","summary":"List the episodes airing on broadcast/cable TV in a country on a date, with show details","params":[{"name":"country","type":"string","description":"ISO 3166-1 alpha-2 country code","default":"US"},{"name":"date","type":"string","description":"ISO date, e.g. 2026-10-18; defaults to today"}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/get-schedule?country=US&date=2026-10-18"},{"command":"get-web-schedule","summary":"List the episodes released on web/streaming channels on a date, optionally for one country","params":[{"name":"date","type":"string","description":"ISO date, e.g. 2026-10-18; defaults to today"},{"name":"country","type":"string","description":"ISO 3166-1 alpha-2 country code. Omit to get global streaming releases."}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/get-web-schedule?date=2026-10-18"},{"command":"list-show-updates","summary":"Get the shows updated in a recent time window, as a map of show ID to last-updated Unix timestamp","params":[{"name":"since","type":"string","description":"Time window. Omit to get every show.","oneOf":["day","week","month"]}],"exampleUrl":"https://clify-dev.netlify.app/tvmaze/list-show-updates?since=day"}]}