Поиск людей

GET/v1.3/persons

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

Ищет по именам на русском и английском и прощает опечатки: нолан, nolan и kristofer nolan находят Кристофера Нолана, decaprio — Леонардо ДиКаприо. Сначала идут точные совпадения, затем совпадения по началу имени, затем похожие; внутри — более известные люди.

Тёзок различает год рождения: birth_year=1970 или диапазон birth_year.gte=1960&birth_year.lte=1980.

Биографию поиск не отдаёт: она длинная, а для списка не нужна. Вернуть её можно через fields: fields=name,biography. Для подсказок при вводе берите limit=5–10.

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

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

  Имя или его часть, на русском или на английском.

  Пример: q=нолан
• birth_yearinteger

  Год рождения. Диапазон — birth_year.gte и birth_year.lte.

  Пример: birth_year.lte=1950
• fieldscsv

  Какие поля человека вернуть: fields=name,photo_url. Со знаком - — какие убрать. name оставляет name_ru и name_en, biography — biography_ru и biography_en. ID приходят всегда.

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

  всё, кроме биографии

  Пример: fields=name,biography
• langru | en

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

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

  Сколько человек вернуть, целое от 1 до 50.

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

  50

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

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

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

  0

Поля ответа

• itemsarray

  Найденные люди — тот же объект, что в карточке, но без биографии.

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

• totalnull

  Поиск не считает общее число совпадений. Листайте по has_more.

• limit · offsetinteger

  Размер страницы и смещение.

• has_moreboolean

  Есть ли следующая страница.

Ошибки