Связи

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

Похожие тайтлы, франшиза, отсылки к другим фильмам и упоминания в них.

Примеры справа — на «Властелине колец: Братство Кольца» (kp 328): у него есть и франшиза, и похожие тайтлы, и отсылки. Связи бывают четырёх видов:

• similar — похожие тайтлы;
• related — франшиза: сиквелы, приквелы, спин-оффы, ремейки. Идут по годам выхода, как хронология;
• reference — на какие фильмы ссылается этот тайтл;
• referenced_in — где упоминается этот тайтл.

Без параметров приходят четыре раздела, по 10 тайтлов в каждом. relation=similar даёт плоский список с пагинацией. Элемент — та же карточка, что в каталоге, и в связях работают те же фильтры и сортировка.

Если у тайтла нет ни одной связи «похожее», relation=similar подбирает соседей по его описанию: тот же вид, те же жанры, близкие годы. Такой ответ несёт basis: "content", а total у него null. Это соседство, а не рекомендация, — отличайте его от обычного списка.

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

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

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

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

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

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

• relationcsv

  Виды связей, через запятую. Один вид даёт плоский список с пагинацией.

  similarrelatedreferencereferenced_in
  По умолчанию:

  все четыре

  Пример: relation=related
• subtypecsv

  Сужает франшизу (related) до вида связи.

  sequelprequelspinoffparentchronologyremakeoriginalversion
  Пример: subtype=sequel
• sourceenum

  Оставить связи, которые дал этот каталог.

  kinoriumkptmdb
  Пример: source=kp
• фильтры и sort

  Фильтры и сортировка каталога: sort=-rating_imdb, votes_imdb.gte=100000, year.gte=2000. Подробно — в Фильтры и сортировка.

• fieldscsv

  Какие поля элемента вернуть, как в каталоге. ID приходят всегда.

  Пример: fields=title,year
• groupenum

  Разбить список на разделы. none — плоский список. Как устроены разделы — в Списки и пагинация.

  relationnone
  По умолчанию:

  relation

• langru | en

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

  Пример: lang=en
• limitinteger

  Сколько элементов вернуть, целое от 1. В разделах — на каждый раздел, до 50. В плоском списке — до 1000. Больше потолка — не ошибка: API срежет до него и покажет в limit.

  По умолчанию:

  10 в разделе, 1000 в плоском списке

  Пример: limit=20
• offsetinteger

  Сколько элементов пропустить, целое от 0. Только в плоском списке: с разделами — 400.

  По умолчанию:

  0

Поля ответа

• countsobject

  Сколько связей каждого вида: similar, related, reference, referenced_in. От relation не зависит — по нему подписываются вкладки. source и subtype сужают и числа.

• basisstring

  content, если похожие подобраны по описанию. У обычного списка поля нет.

• itemsarray

  Тайтлы. В разделах — разделы со своими relation, подписями, total и items.

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

  • imdb_id · kp_id · tmdb_id · tmdb_tv_id · kinorium_idstring | null

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

  • title_ru · title_en · title_originalstring | null

    Названия: на русском, на английском и на языке оригинала.

  • yearinteger | null

    Год выхода.

  • release_datestring | null

    Первая дата выхода, YYYY-MM-DD.

  • kindenum

    Вид тайтла: movie, series, mini_series, tv_show, anime, cartoon, short.

  • poster_url_ru · poster_url_enstring | null

    Постер для русской и английской витрины.

  • posters_by_sourceobject

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

  • rating_kp · rating_tmdb · rating_imdb · rating_kr · rating_letterboxdnumber | null

    Оценки Кинопоиска, TMDB, IMDb, Кинориума и Letterboxd, шкала 0–10.

  • votes_kp · votes_tmdb · votes_imdbinteger | null

    Голоса Кинопоиска, TMDB и IMDb.

  • countriesarray

    Страны: code, name_ru, name_en.

  • genresarray

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

  • relationenum

    Вид связи.

  • subtypeenum | null

    Чем связаны тайтлы франшизы. null — источник не указал.

    sequelprequelspinoffparentchronologyremakeoriginalversion
• total · limit · offset · has_more

  Пагинация — как в любом списке. С фильтрами total — null.

Ошибки