Metadata-Version: 2.4
Name: kino-is
Version: 0.1.0
Summary: Official Python client for the kino.is API — films, people, ratings, where-to-watch & live cinema showtimes. Zero dependencies.
Project-URL: Homepage, https://kino.is
Project-URL: Repository, https://github.com/kino-is/sdk-py
Project-URL: Issues, https://github.com/kino-is/sdk-py/issues
Author: kino.is
License: MIT
License-File: LICENSE
Keywords: api,catalog,cinema,film,imdb,kino.is,kinopoisk,movies,sdk,showtimes,tv
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# kino-is (Python)

**Official Python client for the [kino.is](https://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+.

```bash
pip install kino-is
```

## Usage

```python
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`](https://www.npmjs.com/package/@kino-is/sdk) · [sdk-js](https://github.com/kino-is/sdk-js)
- MCP server (use kino.is from Claude/Cursor/VS Code): [kino-is/mcp](https://github.com/kino-is/mcp)

## License

[MIT](./LICENSE) © [kino.is](https://kino.is)
