Карточка человека

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

Кто это: имена, даты, фото, биография, семья, награды, факты, роли за всю карьеру и самые известные работы.

Карточка открывается по ID любого из четырёх каталогов: /persons/kp/41477, /persons/imdb/nm0634240, /persons/tmdb/525 и /persons/kinorium/476400 — это Кристофер Нолан.

ID людей приходят в составе тайтла и в поиске. Карточка показывает до 12 известных работ; все работы с ролями — в фильмографии.

Появления в роли себя — церемонии, ток-шоу, документальные фильмы о кино — отдельная роль self, архивные кадры — archive. Поэтому roles у Нолана честные: режиссёр — 19 работ, актёр — 2, в роли себя — 90, архивные кадры — 12.

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

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

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

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

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

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

• fieldscsv

  Какие блоки карточки вернуть — person, roles, known_for, relatives, awards, facts, photos — и какие поля человека (как в поиске): fields=awards,birth_date — награды и человек с ID и датой рождения. Со знаком - — какие блоки убрать: fields=-photos,-awards. Смешивать оставляемые и убираемые нельзя.

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

  все блоки

  Пример: fields=person,awards
• langru | en

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

  Пример: lang=en

Поля ответа

• personobject

  Человек — тот же объект, что в поиске.

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

  • imdb_id · kp_id · tmdb_id · kinorium_idstring | null

    ID человека в каталогах. По любому из них открывается карточка.

  • name_ru · name_enstring | null

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

  • name_originalstring | null

    Имя на родном языке, если он пишется не латиницей и не кириллицей: «宮崎 駿» у Хаяо Миядзаки.

  • birth_namestring | null

    Имя при рождении, если оно отличается от известного: «Christopher Edward Nolan».

  • birth_year · death_yearinteger | null

    Годы рождения и смерти. death_year равен null, если человек жив или год неизвестен.

  • birth_date · death_datestring | null

    Даты рождения и смерти — настолько точно, насколько их знают источники: 1961-10-21, 1961-10 или 1961. Когда источники расходятся, побеждает тот, кто знает точнее, а при противоречии — Кинопоиск, затем Кинориум, затем TMDB.

  • ageinteger | null

    Возраст — сегодня или на момент смерти. Только когда день рождения известен точно, а у умерших — ещё и день смерти.

  • zodiacobject | null

    Знак зодиака: slug из набора zodiac_signs в /enums и подписи label_ru, label_en. Только при точной дате рождения.

  • genderenum | null

    Пол: male или female.

  • birthplace_ru · birthplace_enstring | null

    Место рождения. Русское — с Кинопоиска или Кинориума («Лондон, Англия, Великобритания»), английское — с TMDB («Westminster, London, England, UK»).

  • deathplace_ru · deathplace_enstring | null

    Место смерти.

  • height_cminteger | null

    Рост в сантиметрах.

  • nationalityarray

    Гражданство: code (ISO 3166-1), name_ru, name_en — как страны у тайтлов.

  • photo_urlstring | null

    Главный портрет — всегда одно из photos_by_source: первое, что есть, в порядке TMDB, Кинориум, Кинопоиск. У TMDB снимки крупнее всех, у Кинориума — 300 px, у Кинопоиска — 360 px.

  • photos_by_sourceobject

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

  • professionsarray

    Профессии, как их перечисляют источники, — значения из набора credit_roles в /enums. Сколько работ в каждой роли на самом деле, показывает roles в карточке.

  • career_start · career_endinteger | null

    Годы первой и последней работы — как их считает Кинопоиск. Пока карьера идёт (человек жив, последняя работа — в этом или прошлом году или анонсирована), career_end равен null. У умерших career_end не позже года смерти: посмертные премьеры и архивные кадры карьеру не продлевают.

  • genresarray

    Главные жанры человека: slug, name_ru, name_en — как жанры тайтлов.

  • popularitynumber | null

    Популярность на TMDB: растёт, когда человека чаще смотрят и ищут. Шкала открытая — сравнивайте людей между собой, а не с порогом.

  • also_known_asarray

    Другие имена и написания: «Chris Nolan», «Sir Christopher Nolan».

  • tagline_ru · tagline_enstring | null

    Кто это, одной фразой: «Режиссёр и сценарист, прославившийся интеллектуальными блокбастерами…». Пока только на русском.

  • linksobject

    Все ссылки на человека в других местах, каждая — URL. Соцсети по ключам x, instagram, facebook, vk, telegram, youtube, tiktok и другим; website — личный сайт; wikipedia_ru и wikipedia_en — статьи в Википедии; wikidata — страница в Wikidata (ID — её последняя часть, Q38111). Пустой объект, если ссылок нет.

  • educationarray

    Где учился: title, type из набора education_types в /enums (school, high_school, college, university; null, если источник назвал тип иначе) с подписями label_ru и label_en, note, year. В поиске приходит только с fields.

  • biography_ru · biography_enstring | null

    Биография. Английская — из TMDB, русская — с Кинориума. В поиске приходит только с fields.

• rolesarray

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

• known_forarray

  До 12 самых известных тайтлов человека в любой роли — по оценкам и числу голосов. Та же карточка, что в каталоге.

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

  • 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.

• relativesarray

  Семья: супруги и отношения, дети, родители, братья и сёстры — сначала браки. У каждого relation из набора person_relations в /enums и подписи label_ru, label_en — с учётом пола, если он известен («Жена», «Сын»), иначе нейтральные («Супруг или супруга»); супруг после развода — «Бывшая жена», «Бывший муж». gender — пол из kinodata или из записи родственника у источника. person — этот человек в kinodata (ID и имена), иначе null. name_ru, name_en — имя от источника, дополненное из person. Мачеху от матери и сводных от родных источник не отличает. У браков ещё status (married, divorced, widowed, набор marriage_statuses) с подписями, children, married, divorced; у отношений — from_year и to_year. Даты — как birth_date. С lang родственник без имени на этом языке и без person не приходит.

• awardsobject

  Награды по церемониям — как у тайтла: wins, nominations (все, выигранные тоже) и ceremonies с иконками; у каждой номинации ещё title — за какой тайтл (ID и названия; ID есть, даже если тайтла нет в kinodata).

• factsarray

  Факты «Знаете ли вы» с Кинопоиска — все, что там есть: text_ru, text_en и is_spoiler. Факты только на русском: text_en пустой, а с lang=en список пуст.

• photosarray

  Фотографии: url — оригинал, preview_url — превью высотой 280 px, width, height оригинала, source.

Ошибки