{"openapi":"3.1.0","info":{"title":"kino.is Public API","version":"1.0.0","description":"Read-only movie catalog API: films, series, anime, people, ratings, where-to-watch, cinema showtimes. Free to use (Content-Signal: search/ai-input/ai-train = yes). Languages: ru (default), en, uk via ?lang. Optional agent auth: see /auth.md.","contact":{"url":"https://kino.is"},"license":{"name":"Data: aggregated (TMDB/Kinopoisk-derived)"}},"servers":[{"url":"https://kino.is"}],"paths":{"/api/search":{"get":{"operationId":"search","summary":"Search films and people","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","description":"Response language","schema":{"type":"string","enum":["ru","en","uk"],"default":"ru"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/catalog":{"get":{"operationId":"catalog","summary":"Filtered film catalog","parameters":[{"name":"type","in":"query","schema":{"type":"string","enum":["film","serial","cartoon","cartoon-series","anime"]}},{"name":"genre","in":"query","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"keyword","in":"query","schema":{"type":"integer"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["new","rating","popular"]}},{"name":"page","in":"query","schema":{"type":"integer"}},{"name":"lang","in":"query","description":"Response language","schema":{"type":"string","enum":["ru","en","uk"],"default":"ru"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/filters":{"get":{"operationId":"filters","summary":"Available catalog filter values","parameters":[{"name":"lang","in":"query","description":"Response language","schema":{"type":"string","enum":["ru","en","uk"],"default":"ru"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/film/{id}":{"get":{"operationId":"getFilm","summary":"Full film details (ratings, cast, synopsis, where-to-watch, similar)","parameters":[{"name":"id","in":"path","required":true,"description":"kino.is internal id","schema":{"type":"integer"}},{"name":"lang","in":"query","description":"Response language","schema":{"type":"string","enum":["ru","en","uk"],"default":"ru"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/person/{id}":{"get":{"operationId":"getPerson","summary":"Person details and filmography","parameters":[{"name":"id","in":"path","required":true,"description":"kino.is internal id","schema":{"type":"integer"}},{"name":"lang","in":"query","description":"Response language","schema":{"type":"string","enum":["ru","en","uk"],"default":"ru"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/cinema/countries":{"get":{"operationId":"cinemaCountries","summary":"Countries with cinema data + provider capabilities (sessions/cities/theaters)","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/cinema/now-showing":{"get":{"operationId":"cinemaNowShowing","summary":"Films now in cinemas — unified response for any country","parameters":[{"name":"country","in":"query","description":"ISO-2 country code (see /api/v1/cinema/countries)","schema":{"type":"string","example":"UA"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/cinema/cities":{"get":{"operationId":"cinemaCities","summary":"Cities of a country (where sessions are per-city, e.g. KZ)","parameters":[{"name":"country","in":"query","description":"ISO-2 country code (see /api/v1/cinema/countries)","schema":{"type":"string","example":"UA"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/cinema/theaters":{"get":{"operationId":"cinemaTheaters","summary":"Cinema/theater directory for a country","parameters":[{"name":"country","in":"query","description":"ISO-2 country code (see /api/v1/cinema/countries)","schema":{"type":"string","example":"UA"}},{"name":"city","in":"query","description":"City code (required for per-city providers, e.g. KZ)","schema":{"type":"string","example":"almaty"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/cinema/theaters/{slug}":{"get":{"operationId":"cinemaTheater","summary":"One theater with its films and showtimes","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"country","in":"query","description":"ISO-2 country code (see /api/v1/cinema/countries)","schema":{"type":"string","example":"UA"}},{"name":"city","in":"query","description":"City code (required for per-city providers, e.g. KZ)","schema":{"type":"string","example":"almaty"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/films/{id}/showtimes":{"get":{"operationId":"filmShowtimes","summary":"Showtimes for one film across cinemas (day → times, booking)","parameters":[{"name":"id","in":"path","required":true,"description":"kino.is internal id","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/lists":{"get":{"operationId":"lists","summary":"Curated film collections","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/list/{slug}":{"get":{"operationId":"getList","summary":"One curated collection","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/calendar":{"get":{"operationId":"calendar","summary":"Premiere calendar","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/mcp":{"post":{"operationId":"mcp","summary":"MCP server (JSON-RPC 2.0): tools search_films, get_film, get_person, now_in_cinemas, get_showtimes","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"x-markdown":"Append .md to any /film/{id} or /person/{id} URL, or send Accept: text/markdown, for a Markdown rendering."}