Состав

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

Актёры, дубляж и съёмочная группа тайтла, сведённые из Кинопоиска, TMDB и Кинориума.

Без параметров состав приходит разделами по ролям — режиссёры, актёры, сценаристы, продюсеры и дальше, по 10 человек в каждом. Чтобы получить всех людей одной роли, сузьте список: role=actor даёт плоский список с пагинацией.

roles описывает весь состав, а не страницу: сколько людей в каждой роли и подписи ролей. По нему рисуются вкладки, и они не меняются, пока вы листаете.

Дубляж — отдельная роль voice: актёр дубляжа, персонаж, которого он озвучил, и в dubs — актёр оригинала. Люди, которые появляются в роли себя — в ток-шоу, церемониях, документальном кино, — роль self, архивные кадры — archive.

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

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

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

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

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

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

• rolecsv

  Оставить роли, через запятую. Список становится плоским, его можно листать: role=director,writer — режиссёры и сценаристы одним списком. role.not — убрать роли и оставить остальные: role.not=self,archive — состав без эфиров и хроники. Разделы при этом остаются, плоский список — с group=none.

  directoractorselfarchivewriterproducercinematographercomposersoundarteditorvoice_directorvoiceauthortranslatorproducer_ussrcrew
  Пример: role=director,writer
• sourceenum

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

  kptmdbkinorium
  Пример: source=kp
• groupenum

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

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

  role

• langru | en

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

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

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

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

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

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

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

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

  0

Поля ответа

• rolesarray

  Сколько людей во всём составе по ролям: role, подписи label_ru и label_en, count. Порядок — как в титрах: режиссёры, актёры, в роли себя, архивные кадры, сценаристы, продюсеры и дальше.

• itemsarray

  Разделы по ролям — у каждого role, подписи, total, has_more и items. В плоском списке — сами кредиты.

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

  • personobject

    Человек. По любому его ID открывается карточка и фильмография.

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

    • imdb_id · kp_id · tmdb_id · kinorium_idstring | null

      ID человека в каталогах.

    • name_ru · name_enstring | null

      Имя на русском и на английском.

    • name_originalstring | null

      Имя на родном языке, если он пишется не латиницей и не кириллицей.

    • birth_year · death_yearinteger | null

      Годы рождения и смерти.

    • genderenum | null

      Пол: male или female.

    • photo_urlstring | null

      Портрет — одно из photos_by_source: первое, что есть, в порядке TMDB, Кинориум, Кинопоиск. Как в карточке человека.

    • photos_by_sourceobject

      Фото каждого источника: kp, tmdb, kinorium. Снимки TMDB в составе — 185 px шириной (/t/p/w185/); крупнее — замените этот сегмент ссылки на h632 или original.

    • professionsarray

      Профессии, как их перечисляют источники, — значения из набора credit_roles.

  • roleenum

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

  • character_ru · character_enstring | null

    Персонаж — у актёров и в дубляже. Пометок источника в нём нет: «в титрах не указан» — это uncredited, а «играет самого себя» и «хроника» уже сказаны ролью self или archive. Имя, которое источник не перевёл, приходит в character_en.

  • character_originalstring | null

    Имя персонажа на языке оригинала, если он не русский и не английский.

  • character_photo_urlstring | null

    Кадр с этим персонажем.

  • job_ru · job_enstring | null

    Должность в съёмочной группе. job_en — как её пишет TMDB, job_ru — перевод: «Director of Photography» → «Оператор-постановщик». У редких должностей перевода нет — job_ru равен null.

  • dubsobject | null

    В дубляже — кого озвучил актёр: его ID (imdb_id, kp_id, tmdb_id, kinorium_id) и имя (name_ru, name_en).

  • ordinteger | null

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

  • uncreditedboolean

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

  • sourcesarray

    Какие каталоги подтвердили кредит: kp, tmdb, kinorium. Два и больше значат, что человек сведён по совпадению, а не угадан. Порядок всегда один: kp, tmdb, kinorium. Кредита, который есть только у TMDB, когда состав тайтла есть у Кинопоиска или Кинориума и этого человека в нём нет, в составе нет.

• total · limit · offset · has_more

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

Ошибки