kino-is/sdk

Official PHP client for the kino.is API — films, people, ratings, where-to-watch & live cinema showtimes. Zero dependencies.

dev-main 2026-08-05 19:01 UTC

Requires

• php: >=8.0
• ext-curl: *
• ext-json: *

MIT

• kino.is

• api
• client
• sdk
• movies
• tv
• cinema
• film
• kino.is
• showtimes

Published on Packagist.org on 2026-08-05 19:04 UTC

README

Official PHP client for the kino.is API — a movie & TV catalogue with people, ratings, where-to-watch and live cinema showtimes. Zero dependencies (ext-curl, ext-json), PHP 8.0+.

composer require kino-is/sdk

Usage

<?php
require 'vendor/autoload.php';

$kino = new \KinoIs\Client(lang: 'en');

// Search
$films = $kino->search('interstellar')['films'];

// Full film details (ratings, cast, genres, where-to-watch, similar)
$film = $kino->getFilm($films[0]['id'])['film'];

// A person and their filmography
$person = $kino->getPerson(6193)['person'];

// What's in cinemas + real showtimes
$now = $kino->nowInCinemas('KZ');
$showtimes = $kino->showtimesKz('almaty');

API

new \KinoIs\Client(string $baseUrl = 'https://kino.is', string $lang = 'ru', ?string $token = null, int $timeout = 30)

• search($query, $lang = null) · getFilm($id, $lang = null) · getPerson($id, $lang = null)
• catalog(array $params = []) · nowInCinemas($country, $lang = null) · nowShowing($lang = null)
• showtimesKz($city = null) · cinemasUa() · boxoffice() · calendar(array $params = []) · lists()

All methods return array (decoded JSON). Non-2xx responses throw \KinoIs\KinoIsException (->statusCode, ->path). Languages: ru en uk kk uz be de he.

Also

TypeScript: @kino-is/sdk · Python: kino-is · Go: sdk-go · OpenAPI: kino-is/api · MCP: kino-is/mcp

License

MIT © kino.is