kinodata API

Один фильм существует в каждом каталоге под своим номером. У «Начала» есть tt1375666 на IMDb, 447301 на Кинопоиске, 27205 на TMDB — и ничто в этих числах не подсказывает, что речь об одном и том же фильме.

kinodata связывает их и отдаёт метаданные поверх этой связи: названия на трёх языках, рейтинги по источникам, состав, медиа, связи между тайтлами, фильмографии.

Базовый URL

https://api.kinodata.space/v1.2

Все пути в этом справочнике указаны относительно него: /titles/tmdb/27205 означает https://api.kinodata.space/v1.2/titles/tmdb/27205.

Формат

Ответы — JSON, UTF-8. Успех отдаётся телом напрямую, без обёртки:

{ "imdb_id": "tt1375666", "kp_id": "447301", "tmdb_id": "27205",
  "tmdb_tv_id": null, "kinorium_id": "472809" }

Ошибка — объект error и не-2xx статус:

{ "error": { "code": "not_found", "message": "mapping not found" } }

Различать успех и ошибку по HTTP-статусу, не по форме тела.

Пять типов идентификаторов

тип	пример	что это
imdb	tt1375666	IMDb
kp	447301	Кинопоиск
tmdb	27205	TMDB, фильм
tmdb_tv	1399	TMDB, сериал
kinorium	472809	Кинориум

tmdb и tmdb_tv — разные пространства номеров: один и тот же номер означает в них разные произведения. Тайтл принадлежит либо одному, либо другому.

Любой из пяти подходит везде, где путь содержит {type}/{id}. Карточка «Начала» по imdb/tt1375666, kp/447301 и tmdb/27205 — байт в байт одна и та же.

С чего начать

Быстрый старт — рабочий запрос за пять минут. Соглашения — пагинация, сортировка, фильтры, лимиты. Эндпоинты — полный список.

Машинный справочник: /openapi.json.