Карточка тайтла

GET/v1.3/titles/{type}/{id}

Всё о фильме или сериале одним запросом: названия, описания, оценки, даты, награды, медиа и состав.

Карточка открывается по ID любого из пяти каталогов: /titles/kp/447301 и /titles/imdb/tt1375666 возвращают одно и то же.

Целиком карточка — до 22 блоков и около 26 КБ, со сжатием около 8 КБ. Если нужна часть, перечислите блоки в fields: так ответ меньше, а разбирать его проще. Блок ids приходит всегда.

Параметры пути

• typestringобязательный

  Каталог, из которого ID: IMDb, Кинопоиск, TMDB (фильм или сериал) или Кинориум.

  imdbkptmdbtmdb_tvkinorium
• idstringобязательный

  ID в этом каталоге. У IMDb — tt и цифры (tt1375666), у остальных — цифры (447301).

Параметры запроса

• fieldscsv

  Какие блоки вернуть: fields=title,ratings. Со знаком - — какие убрать: fields=-akas,-tags. Смешивать нельзя. По умолчанию — все блоки.

  idsmetatitletypesynopsisreleaseratingsfinanceawardscountriesclassificationseriesmediagenrescompaniesakastagswatchparentalcredits_topfranchisecounts
  Пример: fields=title,ratings
• langru | en

  Оставить в ответе один язык. Без него текстовые поля приходят парами _ru и _en. Подробнее — Языки ответа.

Поля ответа

• idsobject

  ID тайтла во всех каталогах и ссылки на его страницы. Приходит всегда, даже если его нет в fields.

  +−Показать 6 полей

  • imdb_idstring | null

    ID в IMDb.

  • kp_idstring | null

    ID на Кинопоиске.

  • tmdb_idstring | null

    ID фильма в TMDB.

  • tmdb_tv_idstring | null

    ID сериала в TMDB. Заполнено не больше одного из tmdb_id и tmdb_tv_id.

  • kinorium_idstring | null

    ID на Кинориуме.

  • urlsobject

    Ссылки на страницы тайтла: imdb, kp, tmdb, kinorium. С lang=en ссылка на Кинориум ведёт на en.kinorium.com.

• metaobject

  Служебные сведения о карточке.

  +−Показать 1 поле

  • updated_atstring

    Когда данные тайтла последний раз обновлялись, ISO 8601 в UTC.

• titleobject

  Названия.

  +−Показать 3 поля

  • title_rustring | null

    Название на русском.

  • title_enstring | null

    Английское название. Только настоящее: оригинальное название неанглоязычного фильма или транслитерация сюда не попадают, тогда null.

  • title_originalstring | null

    Название на языке оригинала.

• typeobject

  Вид и статус тайтла.

  +−Показать 7 полей

  • kindenum

    Вид тайтла.

    movieseriesmini_seriestv_showanimecartoonshort
  • is_seriesboolean

    Многосерийный ли тайтл.

  • statusenum

    Статус выхода. Все значения — в /enums, набор statuses.

    releasedendedreturning_seriesin_productionpost_productionin_developmentplannedcanceled
  • kind_label_ru · kind_label_enstring

    Подпись вида: «Фильм» / «Movie».

  • status_label_ru · status_label_enstring

    Подпись статуса: «Вышел» / «Released».

• synopsisobject

  Описания и слоганы. Каждый текст — из своего источника, а не перевод соседнего.

  +−Показать 8 полей

  • overview_ru · overview_enstring | null

    Описание сюжета.

  • short_overview_ru · short_overview_enstring | null

    Описание в одну-две фразы.

  • tagline_ru · tagline_enstring | null

    Слоган.

  • overview_alter_ru · overview_alter_enstring | null

    Второе описание из другого источника, если оно отличается от первого.

• releaseobject

  Год, длительность и даты выхода.

  +−Показать 3 поля

  • yearinteger | null

    Год выхода.

  • runtimeinteger | null

    Длительность в минутах.

  • releasesarray

    Даты выхода по регионам. Каждая дата стоит один раз: если цифровой релиз в США совпал с мировым, он только в world.

    +−Показать 2 поля

    • regionstring

      Регион: world — самая ранняя дата в мире, us — США, ru — Россия.

    • datesarray

      Даты в регионе: type и date. Типы: premiere — премьера, release — выход в прокат, digital — цифровой релиз; подписи — в /enums, набор title_release_types. Дата — YYYY-MM-DD.

• ratingsobject

  Оценки по источникам. Общего балла нет намеренно: у источников разные шкалы и аудитории.

  +−Показать 4 поля

  • sourcesobject

    Оценки по источникам: ключ — источник (imdb, kp, tmdb, kinorium, letterboxd, rt, metacritic, critics, cr), значение — value, votes, scale (10 или 100), kind: "critics" у оценок критиков и url страницы. У Кинориума ещё distribution — сколько зрителей поставили каждую оценку от 1 до 10; Кинориум считает её отдельно, поэтому сумма не совпадает с votes. Подписи источников — в /enums, набор rating_sources. Источника нет — нет ключа.

  • votes_totalinteger | null

    Голоса Кинопоиска, IMDb и TMDB вместе.

  • divergence_kp_imdbnumber | null

    На сколько расходятся оценки Кинопоиска и IMDb, по модулю.

  • popularitynumber | null

    Индекс популярности TMDB. Это не сумма голосов.

• financeobject

  Деньги, в долларах США.

  +−Показать 3 поля

  • budgetinteger | null

    Бюджет.

  • box_office_usinteger | null

    Сборы в США.

  • revenue_worldinteger | null

    Сборы в мире.

• awardsobject

  Награды: итоги и разбор по церемониям.

  +−Показать 9 полей

  • wins_imdb · nominations_imdbinteger | null

    Победы и все номинации, включая выигранные, по данным IMDb, по всем премиям мира.

  • oscars_won · oscars_nominatedinteger | null

    «Оскары»: победы и все номинации, включая выигранные.

  • wins_ceremonies · nominations_ceremoniesinteger

    Победы и все номинации по церемониям из ceremonies.

  • summary_kinorium_rustring | null

    Сводка Кинориума по церемониям: «Оскар: 4/8; Британская академия: 5/10…».

  • summary_imdb_enstring | null

    Сводка IMDb: «Won 4 Oscars. 160 wins & 220 nominations total». Это другой текст, а не перевод сводки Кинориума.

  • ceremoniesarray

    Церемонии по престижу, «Оскар» первым.

    +−Показать 9 полей

    • slugstring | null

      Код церемонии: oscar, bafta, golden_globe…

    • ceremony_ru · ceremony_enstring

      Название церемонии.

    • iconstring | null

      Путь к иконке церемонии на api.kinodata.space: золотая при победе, серая при номинации.

    • wonboolean

      Есть ли хоть одна победа.

    • wins · nominationsinteger

      Победы и все номинации, включая выигранные.

    • yearsarray

      Годы церемоний.

    • itemsarray

      Категории: category_ru, category_en, won, year.

• countriesarray

  Страны производства: code (ISO 3166-1, строчными), name_ru, name_en.

• classificationobject

  Возраст и язык.

  +−Показать 4 поля

  • age_limitinteger | null

    Российский возрастной ценз: 0, 6, 12, 16 или 18.

  • mpaastring | null

    Американский сертификат: G, PG, PG-13, R, NC-17 или TV-*.

  • original_languagestring | null

    Язык оригинала, ISO 639-1.

  • is_adultboolean

    Контент для взрослых.

• seriesobject

  Сериал. У фильма все поля null.

  +−Показать 4 поля

  • seasons_total · episodes_totalinteger | null

    Сезонов и серий.

  • start_year · end_yearinteger | null

    Годы выхода. У идущего сериала end_year — null.

• mediaobject

  Постеры, задник, трейлеры и саундтрек. Остальные кадры и видео — в /titles/{type}/{id}/media.

  +−Показать 9 полей

  • poster_url_ru · poster_url_enstring | null

    Постер для русской и английской витрины. Английский — с надписями на английском, нет такого — null.

  • poster_source_ru · poster_source_enstring | null

    Откуда постер: kp, tmdb, imdb, kinorium.

  • posters_by_sourceobject

    Постер каждого источника: kp, tmdb, imdb, kinorium.

  • backdrop_urlstring | null

    Широкий кадр для фона.

  • poster_animatedstring

    Анимированный постер Кинориума — ролик mp4 до 7 МБ. Есть примерно у каждого десятого популярного тайтла; когда его нет, нет и ключа. Показывайте в <video autoplay muted loop playsinline> и грузите по требованию.

  • trailersarray

    Трейлеры: url и youtube_id, language, runtime_sec, thumbnail_url, preview_url, kind с подписями. Все видео — в /media.

  • soundtrackobject | null

    Альбом саундтрека: name и url в Apple Music.

• genresarray

  Жанры: slug, name_ru, name_en.

• companiesarray

  Компании: name, slug и роль kind — production, studio, network, special_effects, distributor_theatrical, distributor_online, dubbing.

• akasarray

  Альтернативные названия: title, regions (коды стран), source и language, если язык известен.

• tagsarray

  Метки Кинориума: kind (adjective — настроение, keyword — ключевое слово, subgenre — поджанр) с подписями, tag_ru, tag_en.

• watcharray

  Где смотреть и что почитать, по возрастанию rank: url, host и вид сайта kind с подписями — онлайн-кинотеатр, рейтинг, официальный сайт, энциклопедия… Все виды — в /enums, набор site_kinds.

• parentalarray

  Родительский гид по категориям: category, severity (mild, moderate, severe), подписи и source.

• credits_toparray

  Режиссёры и главные актёры, готовые к показу. Полный состав — в /titles/{type}/{id}/cast.

  +−Показать 12 полей

  • imdb_idstring | null

    ID в IMDb.

  • kp_idstring | null

    ID на Кинопоиске.

  • tmdb_idstring | null

    ID человека в TMDB.

  • kinorium_idstring | null

    ID на Кинориуме.

  • name_ru · name_enstring | null

    Имя.

  • photo_urlstring | null

    Фото.

  • roleenum

    Роль. Все значения — в /enums, набор credit_roles.

  • role_label_ru · role_label_enstring

    Подпись роли: «Режиссёр» / «Director».

  • character_ru · character_enstring | null

    Персонаж у актёра.

• franchiseobject

  Франшиза: name, poster_url и size — сколько в ней тайтлов. Блок есть только у тайтлов из франшизы. Состав франшизы — в /titles/{type}/{id}/relations?relation=related.

• countsobject

  Сколько чего на подресурсах: cast, images, videos, facts, faq, quotes, episodes, seasons, relations. По ним видно, за чем стоит идти отдельным запросом.

Ошибки