kino-is (Python)

Official Python client for the kino.is API — a movie & TV catalogue with people, ratings, where-to-watch and live cinema showtimes. Zero third-party dependencies (standard library only), Python 3.8+.

pip install kino-is

Usage

from kino_is import KinoIs

kino = KinoIs(lang="en")

# Search
films = kino.search("interstellar")["films"]

# Full film details (ratings, cast, genres, where-to-watch, similar)
film = kino.get_film(films[0]["id"])["film"]

# A person and their filmography
person = kino.get_person(6193)["person"]

# What's in cinemas + real showtimes
now = kino.now_in_cinemas("KZ")
showtimes = kino.showtimes_kz(city="almaty")

API

KinoIs(base_url="https://kino.is", lang="ru", token=None, timeout=30.0)

• search(query, lang=None) — films/series/cartoons/anime by title or keywords.
• get_film(film_id, lang=None) — full details for a film.
• get_person(person_id, lang=None) — a person and filmography.
• catalog(**params) — browse/filter (type, genre, year, country, sort, page…).
• now_in_cinemas(country, lang=None) — films currently in cinemas (ISO-2 country).
• now_showing(lang=None), showtimes_kz(city=None), cinemas_ua().
• boxoffice(), calendar(**params), lists().

Languages: ru, en, uk, kk, uz, be, de, he. Non-2xx responses raise KinoIsError (with .status and .path).

Also

• TypeScript/JS: @kino-is/sdk · sdk-js
• MCP server (use kino.is from Claude/Cursor/VS Code): kino-is/mcp

License

MIT © kino.is