Совместные работы

GET/v1.3/persons/{type}/{id}/with/{type2}/{id2}

Тайтлы, над которыми работали оба человека, и кем был в них каждый.

Каталоги у двух людей могут быть разными: /persons/kp/37859/with/imdb/nm0634240 — это Леонардо ДиКаприо и Кристофер Нолан. У каждого тайтла — роли обоих: credits_first для первого человека в пути, credits_second для второго.

Роли задаются для каждого отдельно. role_first=actor&role_second=director у ДиКаприо и Нолана даёт ровно «Начало»: Кобб и режиссёр. role — роль, общая для обоих: role=actor — где они играли вместе, role=self — эфиры и церемонии, где оба были гостями. Чтобы убрать эфиры и хронику, исключите эти роли: из 20 общих тайтлов ДиКаприо и Нолана role.not=self,archive оставляет одно «Начало».

Список собирает движок каталога: работают все фильтры и сортировки, пресеты, поиск по названию q и fields. Без sort — от новых работ к старым, order=asc — наоборот. В примере «Общие фильмы» справа так собраны общие фильмы Киану Ривза и Лоренса Фишбёрна — по оценке IMDb, с ролями обоих. Те же тайтлы без ролей, но с курсором даёт каталог: /titles?person=kp:37859&person=imdb:nm0634240.

Если оба человека в пути — один и тот же, ответ 400 с подсказкой открыть фильмографию.

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

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

  Каталог, из которого ID первого человека: IMDb, Кинопоиск, TMDB или Кинориум.

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

  ID первого человека в этом каталоге. У IMDb — nm и цифры (nm0634240), у остальных — цифры (41477).

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

  Каталог, из которого ID второго человека: IMDb, Кинопоиск, TMDB или Кинориум.

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

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

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

• role_firstcsv

  Роль первого человека. Несколько через запятую — любая из них. role_first.not — убрать тайтлы, где у человека только такие роли.

  directoractorselfarchivewriterproducercinematographercomposersoundarteditorvoice_directorvoiceauthortranslatorproducer_ussrcrew
  Пример: role_first=actor
• role_secondcsv

  Роль второго человека. Несколько через запятую — любая из них. role_second.not — убрать тайтлы, где у человека только такие роли.

  directoractorselfarchivewriterproducercinematographercomposersoundarteditorvoice_directorvoiceauthortranslatorproducer_ussrcrew
  Пример: role_second=director
• rolecsv

  Роль, которая есть у обоих. Несколько через запятую — любая из них. role.not — убрать тайтлы, где хотя бы у одного из них только такие роли.

  directoractorselfarchivewriterproducercinematographercomposersoundarteditorvoice_directorvoiceauthortranslatorproducer_ussrcrew
  Пример: role=actor
• фильтры, q и sort

  Фильтры, поиск и сортировка каталога: kind=movie, q=матрица, sort=-rating_imdb. Подробно — в Фильтры и сортировка.

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

  sort=-year

• orderenum

  Направление сортировки по умолчанию: order=asc — от старых работ к новым. Если задан sort, направление берётся из его знака.

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

  desc

  Пример: order=asc
• fieldscsv

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

  Пример: fields=title,year,credits_first,credits_second
• langru | en

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

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

  Сколько тайтлов вернуть, целое от 1 до 1000.

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

  1000

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

  Сколько тайтлов пропустить, целое от 0.

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

  0

Поля ответа

• itemsarray

  Общие тайтлы — та же карточка, что в каталоге, с ролями обоих людей.

  +−Показать 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.

  • credits_first · credits_secondarray

    Роли первого и второго человека в этом тайтле — те же поля, что у роли в фильмографии.

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

    • roleenum

      Роль. Подписи — в /enums, набор credit_roles.

    • character_ru · character_enstring | null

      Персонаж — у актёров и в дубляже, без пометок источника, как в составе. У self — кем человек появляется: «гость», «Guest».

    • job_ru · job_enstring | null

      Должность в съёмочной группе: «Исполнительный продюсер», «Executive Producer».

    • ordinteger | null

      Место в титрах: у актёров — порядок в титрах, у съёмочной группы — внутри своего цеха. null — место неизвестно: роль взята из фильмографии человека, а не из титров тайтла.

    • sourcesarray

      Какие каталоги подтвердили кредит: kp, tmdb, kinorium, всегда в этом порядке.

    • uncreditedboolean

      true — человека нет в титрах тайтла: источник пометил роль «в титрах не указан» или “uncredited”.

    • disputedboolean

      true — кредит есть только у TMDB, а в составе тайтла на Кинопоиске или Кинориуме этого человека нет. В составе тайтла такие кредиты не показываются; в списке работ скройте их условием disputed.

• totalinteger | null

  Сколько общих тайтлов подходит под запрос. С поиском q — null.

• limit · offset · has_more

  Пагинация — как в любом списке.

Ошибки