# Поиск людей

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

> Оглавление документации для агентов: https://kinodata.space/ru/llms.txt — вся документация одним файлом: https://kinodata.space/ru/llms-full.txt

Запрос: `GET https://api.kinodata.space/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`.

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

- `q` (string, обязательный) — Имя или его часть, на русском или на английском.
  Пример: `q=нолан`.
- `birth_year` (integer) — Год рождения. Диапазон — `birth_year.gte` и `birth_year.lte`.
  Пример: `birth_year.lte=1950`.
- `fields` (csv) — Какие поля человека вернуть: `fields=name,photo_url`. Со знаком `-` — какие убрать. `name` оставляет `name_ru` и `name_en`, `biography` — `biography_ru` и `biography_en`. ID приходят всегда.
  По умолчанию: всё, кроме биографии. Пример: `fields=name,biography`.
- `lang` (ru | en) — Оставить в ответе один язык. Без него текстовые поля приходят парами `_ru` и `_en`. Подробнее — [Языки ответа](https://kinodata.space/ru/docs/languages.md).
  Пример: `lang=en`.
- `limit` (integer) — Сколько человек вернуть, целое от 1 до 50.
  По умолчанию: 50. Пример: `limit=10`.
- `offset` (integer) — Сколько человек пропустить, целое от 0.
  По умолчанию: 0.

## Поля ответа

- `items` (array) — Найденные люди — тот же объект, что в карточке, но без биографии.
  - `imdb_id`, `kp_id`, `tmdb_id`, `kinorium_id` (string | null) — ID человека в каталогах. По любому из них открывается [карточка](https://kinodata.space/ru/docs/persons/card.md).
  - `name_ru`, `name_en` (string | null) — Имя на русском и на английском.
  - `name_original` (string | null) — Имя на родном языке, если он пишется не латиницей и не кириллицей: «宮崎 駿» у Хаяо Миядзаки.
  - `birth_name` (string | null) — Имя при рождении, если оно отличается от известного: «Christopher Edward Nolan».
  - `birth_year`, `death_year` (integer | null) — Годы рождения и смерти. `death_year` равен `null`, если человек жив или год неизвестен.
  - `birth_date`, `death_date` (string | null) — Даты рождения и смерти — настолько точно, насколько их знают источники: `1961-10-21`, `1961-10` или `1961`. Когда источники расходятся, побеждает тот, кто знает точнее, а при противоречии — Кинопоиск, затем Кинориум, затем TMDB.
  - `age` (integer | null) — Возраст — сегодня или на момент смерти. Только когда день рождения известен точно, а у умерших — ещё и день смерти.
  - `zodiac` (object | null) — Знак зодиака: `slug` из набора `zodiac_signs` в `/enums` и подписи `label_ru`, `label_en`. Только при точной дате рождения.
  - `gender` (enum | null) — Пол: `male` или `female`.
  - `birthplace_ru`, `birthplace_en` (string | null) — Место рождения. Русское — с Кинопоиска или Кинориума («Лондон, Англия, Великобритания»), английское — с TMDB («Westminster, London, England, UK»).
  - `deathplace_ru`, `deathplace_en` (string | null) — Место смерти.
  - `height_cm` (integer | null) — Рост в сантиметрах.
  - `nationality` (array) — Гражданство: `code` (ISO 3166-1), `name_ru`, `name_en` — как страны у тайтлов.
  - `photo_url` (string | null) — Главный портрет — всегда одно из `photos_by_source`: первое, что есть, в порядке TMDB, Кинориум, Кинопоиск. У TMDB снимки крупнее всех, у Кинориума — 300 px, у Кинопоиска — 360 px.
  - `photos_by_source` (object) — Фото каждого источника: `kp`, `tmdb`, `kinorium`. Снимки TMDB в карточке — в исходном размере, в списках (поиск, состав) — 185 px шириной (`/t/p/w185/`). Другой размер — замените этот сегмент ссылки: `w45`, `w185`, `h632`, `original`.
  - `professions` (array) — Профессии, как их перечисляют источники, — значения из набора `credit_roles` в `/enums`. Сколько работ в каждой роли на самом деле, показывает `roles` в карточке.
  - `career_start`, `career_end` (integer | null) — Годы первой и последней работы — как их считает Кинопоиск. Пока карьера идёт (человек жив, последняя работа — в этом или прошлом году или анонсирована), `career_end` равен `null`. У умерших `career_end` не позже года смерти: посмертные премьеры и архивные кадры карьеру не продлевают.
  - `genres` (array) — Главные жанры человека: `slug`, `name_ru`, `name_en` — как жанры тайтлов.
  - `popularity` (number | null) — Популярность на TMDB: растёт, когда человека чаще смотрят и ищут. Шкала открытая — сравнивайте людей между собой, а не с порогом.
  - `also_known_as` (array) — Другие имена и написания: «Chris Nolan», «Sir Christopher Nolan».
  - `tagline_ru`, `tagline_en` (string | null) — Кто это, одной фразой: «Режиссёр и сценарист, прославившийся интеллектуальными блокбастерами…». Пока только на русском.
  - `links` (object) — Все ссылки на человека в других местах, каждая — URL. Соцсети по ключам `x`, `instagram`, `facebook`, `vk`, `telegram`, `youtube`, `tiktok` и другим; `website` — личный сайт; `wikipedia_ru` и `wikipedia_en` — статьи в Википедии; `wikidata` — страница в Wikidata (ID — её последняя часть, `Q38111`). Пустой объект, если ссылок нет.
  - `education` (array) — Где учился: `title`, `type` из набора `education_types` в `/enums` (`school`, `high_school`, `college`, `university`; `null`, если источник назвал тип иначе) с подписями `label_ru` и `label_en`, `note`, `year`. В поиске приходит только с `fields`.
  - `biography_ru`, `biography_en` (string | null) — Биография. Английская — из TMDB, русская — с Кинориума. В поиске приходит только с `fields`.
- `total` (null) — Поиск не считает общее число совпадений. Листайте по `has_more`.
- `limit`, `offset` (integer) — Размер страницы и смещение.
- `has_more` (boolean) — Есть ли следующая страница.

## Ошибки

| статус | код | когда |
|---|---|---|
| 400 | `invalid_request` | Нет `q` или он пустой; `birth_year` не число; `limit` не целое от 1 или `offset` меньше 0; неизвестное поле в `fields`; параметр, которого поиск не понимает (`sort`, `group`), — в ответе список допустимых; `cursor` — поиск листается `offset`. |
| 401 | `unauthorized` | Нет заголовка `X-API-Key`, ключ неизвестен или отозван. |
| 429 | `rate_limited` | Исчерпан предел в секунду или квота на сутки. |

Все коды и что с ними делать — на странице [Ошибки](https://kinodata.space/ru/docs/errors.md).

## Примеры

### Поиск

```bash
curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "q=нолан" \
  --data-urlencode "limit=2" \
  "https://api.kinodata.space/v1.3/persons"
```

Ответ `200`:

```json
{
  "has_more": true,
  "items": [
    {
      "imdb_id": "nm0634240",
      "kp_id": "41477",
      "tmdb_id": "525",
      "kinorium_id": "476400",
      "name_ru": "Кристофер Нолан",
      "name_en": "Christopher Nolan",
      "name_original": null,
      "birth_name": "Christopher Edward Nolan",
      "birth_year": 1970,
      "death_year": null,
      "birth_date": "1970-07-30",
      "death_date": null,
      "age": 56,
      "zodiac": {
        "slug": "leo",
        "label_ru": "Лев",
        "label_en": "Leo"
      },
      "gender": "male",
      "birthplace_ru": "Лондон, Англия, Великобритания",
      "birthplace_en": "Westminster, London, England, UK",
      "deathplace_ru": null,
      "deathplace_en": null,
      "height_cm": 181,
      "nationality": [
        {
          "code": "gb",
          "name_ru": "Великобритания",
          "name_en": "United Kingdom"
        },
        {
          "code": "us",
          "name_ru": "США",
          "name_en": "United States"
        }
      ],
      "photo_url": "https://image.tmdb.org/t/p/w185/xuAIuYSmsUzKlUMBFGVZaWsY3DZ.jpg",
      "photos_by_source": {
        "kp": "https://st.kp.yandex.net/images/actor_iphone/iphone360_41477.jpg",
        "tmdb": "https://image.tmdb.org/t/p/w185/xuAIuYSmsUzKlUMBFGVZaWsY3DZ.jpg",
        "kinorium": "https://images.kinorium.com/persona/300/476400.jpg?20260829201207"
      },
      "professions": [
        "actor",
        "cinematographer",
        "composer",
        "director",
        "editor",
        "producer",
        "writer",
        "author"
      ],
      "career_start": 1989,
      "career_end": null,
      "genres": [
        {
          "slug": "speculative_fiction",
          "name_ru": "Фантастика",
          "name_en": "Speculative Fiction"
        },
        {
          "slug": "action",
          "name_ru": "Боевик",
          "name_en": "Action"
        },
        {
          "slug": "thriller",
          "name_ru": "Триллер",
          "name_en": "Thriller"
        }
      ],
      "popularity": 9.174,
      "tagline_ru": "Режиссёр и сценарист, прославившийся интеллектуальными блокбастерами и сложными повествовательными структурами в фильмах «Начало», «Интерстеллар», «Тёмный рыцарь» и «Оппенгеймер».",
      "tagline_en": null,
      "also_known_as": [
        "Christopher Edward Nolan",
        "Chris Nolan",
        "Sir Christopher Nolan",
        "Sir Christopher Edward Nolan",
        "Christopher E. Nolan"
      ],
      "links": {
        "wikidata": "https://www.wikidata.org/wiki/Q25191",
        "wikipedia_en": "https://en.wikipedia.org/wiki/Christopher_Nolan",
        "wikipedia_ru": "https://ru.wikipedia.org/wiki/%D0%9D%D0%BE%D0%BB%D0%B0%D0%BD%2C_%D0%9A%D1%80%D0%B8%D1%81%D1%82%D0%BE%D1%84%D0%B5%D1%80"
      }
    },
    {
      "imdb_id": "nm0636046",
      "kp_id": "250538",
      "tmdb_id": "19508",
      "kinorium_id": "477739",
      "name_ru": "Нолан Норт",
      "name_en": "Nolan North",
      "name_original": null,
      "birth_name": "Nolan Ramsay North",
      "birth_year": 1970,
      "death_year": null,
      "birth_date": "1970-10-31",
      "death_date": null,
      "age": 55,
      "zodiac": {
        "slug": "scorpio",
        "label_ru": "Скорпион",
        "label_en": "Scorpio"
      },
      "gender": "male",
      "birthplace_ru": "Нью-Хейвен, Коннектикут, США",
      "birthplace_en": "New Haven, Connecticut, USA",
      "deathplace_ru": null,
      "deathplace_en": null,
      "height_cm": 183,
      "nationality": [
        {
          "code": "us",
          "name_ru": "США",
          "name_en": "United States"
        }
      ],
      "photo_url": "https://image.tmdb.org/t/p/w185/gb499KZIoBTZnKCGKE4zwzlcfSe.jpg",
      "photos_by_source": {
        "kp": "https://st.kp.yandex.net/images/actor_iphone/iphone360_250538.jpg",
        "tmdb": "https://image.tmdb.org/t/p/w185/gb499KZIoBTZnKCGKE4zwzlcfSe.jpg",
        "kinorium": "https://images.kinorium.com/persona/300/477739.jpg?20180610152636"
      },
      "professions": [
        "actor"
      ],
      "career_start": 1995,
      "career_end": null,
      "genres": [
        {
          "slug": "animation",
          "name_ru": "Мультфильм",
          "name_en": "Animation"
        },
        {
          "slug": "action",
          "name_ru": "Боевик",
          "name_en": "Action"
        },
        {
          "slug": "comedy",
          "name_ru": "Комедия",
          "name_en": "Comedy"
        }
      ],
      "popularity": 2.609,
      "tagline_ru": null,
      "tagline_en": null,
      "also_known_as": [
        "Zachary Samuels",
        "Nolan Ramsey North",
        "諾蘭·諾斯",
        "诺兰·诺斯"
      ],
      "links": {
        "instagram": "https://instagram.com/reallynolannorth",
        "tiktok": "https://www.tiktok.com/@nolannorthofficial",
        "wikidata": "https://www.wikidata.org/wiki/Q1147104",
        "wikipedia_en": "https://en.wikipedia.org/wiki/Nolan_North",
        "wikipedia_ru": "https://ru.wikipedia.org/wiki/%D0%9D%D0%BE%D1%80%D1%82%2C_%D0%9D%D0%BE%D0%BB%D0%B0%D0%BD",
        "x": "https://x.com/nolan_north"
      }
    }
  ],
  "limit": 2,
  "offset": 0,
  "total": null
}
```

### Тёзки по году

```bash
curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "q=нолан" \
  --data-urlencode "birth_year.lte=1950" \
  --data-urlencode "limit=2" \
  "https://api.kinodata.space/v1.3/persons"
```

Ответ `200`:

```json
{
  "has_more": true,
  "items": [
    {
      "imdb_id": "nm0634297",
      "kp_id": "69157",
      "tmdb_id": "70225",
      "kinorium_id": "476437",
      "name_ru": "Джон Нолан",
      "name_en": "John Nolan",
      "name_original": null,
      "birth_name": "John Francis Nolan",
      "birth_year": 1938,
      "death_year": 2026,
      "birth_date": "1938-05-22",
      "death_date": "2026-04-11",
      "age": 87,
      "zodiac": {
        "slug": "gemini",
        "label_ru": "Близнецы",
        "label_en": "Gemini"
      },
      "gender": "male",
      "birthplace_ru": "Лондон, Англия, Великобритания",
      "birthplace_en": "London, England, UK",
      "deathplace_ru": "США",
      "deathplace_en": "USA",
      "height_cm": 178,
      "nationality": [],
      "photo_url": "https://image.tmdb.org/t/p/w185/7cxsJPPPxdyLVFMmtvj6uaGSqWW.jpg",
      "photos_by_source": {
        "kp": "https://st.kp.yandex.net/images/actor_iphone/iphone360_69157.jpg",
        "tmdb": "https://image.tmdb.org/t/p/w185/7cxsJPPPxdyLVFMmtvj6uaGSqWW.jpg",
        "kinorium": "https://images.kinorium.com/persona/300/476437.jpg?20260413203704"
      },
      "professions": [
        "actor"
      ],
      "career_start": 1967,
      "career_end": 2024,
      "genres": [
        {
          "slug": "drama",
          "name_ru": "Драма",
          "name_en": "Drama"
        },
        {
          "slug": "speculative_fiction",
          "name_ru": "Фантастика",
          "name_en": "Speculative Fiction"
        },
        {
          "slug": "crime",
          "name_ru": "Криминал",
          "name_en": "Crime"
        }
      ],
      "popularity": 2.344,
      "tagline_ru": null,
      "tagline_en": null,
      "also_known_as": [],
      "links": {
        "wikidata": "https://www.wikidata.org/wiki/Q12858652",
        "wikipedia_en": "https://en.wikipedia.org/wiki/John_Nolan_(British_actor)",
        "wikipedia_ru": "https://ru.wikipedia.org/wiki/%D0%9D%D0%BE%D0%BB%D0%B0%D0%BD,_%D0%94%D0%B6%D0%BE%D0%BD"
      }
    },
    {
      "imdb_id": "nm0634282",
      "kp_id": "69060",
      "tmdb_id": "7520",
      "kinorium_id": "476427",
      "name_ru": "Жанетт Нолан",
      "name_en": "Jeanette Nolan",
      "name_original": null,
      "birth_name": null,
      "birth_year": 1911,
      "death_year": 1998,
      "birth_date": "1911-12-30",
      "death_date": "1998-06-05",
      "age": 86,
      "zodiac": {
        "slug": "capricorn",
        "label_ru": "Козерог",
        "label_en": "Capricorn"
      },
      "gender": "female",
      "birthplace_ru": "Лос-Анджелес, Калифорния, США",
      "birthplace_en": "Los Angeles, California, USA",
      "deathplace_ru": "Лос-Анджелес, Калифорния, США",
      "deathplace_en": "Los Angeles, California, USA",
      "height_cm": null,
      "nationality": [
        {
          "code": "us",
          "name_ru": "США",
          "name_en": "United States"
        }
      ],
      "photo_url": "https://image.tmdb.org/t/p/w185/wb9G3heeItXTpXqPy4HlNDMJWrE.jpg",
      "photos_by_source": {
        "kp": "https://st.kp.yandex.net/images/actor_iphone/iphone360_69060.jpg",
        "tmdb": "https://image.tmdb.org/t/p/w185/wb9G3heeItXTpXqPy4HlNDMJWrE.jpg",
        "kinorium": "https://images.kinorium.com/persona/300/476427.jpg?20181225232509"
      },
      "professions": [
        "actor"
      ],
      "career_start": 1948,
      "career_end": 1998,
      "genres": [
        {
          "slug": "drama",
          "name_ru": "Драма",
          "name_en": "Drama"
        },
        {
          "slug": "crime",
          "name_ru": "Криминал",
          "name_en": "Crime"
        },
        {
          "slug": "western",
          "name_ru": "Вестерн",
          "name_en": "Western"
        }
      ],
      "popularity": 2.045,
      "tagline_ru": null,
      "tagline_en": null,
      "also_known_as": [
        "جنت نولان"
      ],
      "links": {
        "wikidata": "https://www.wikidata.org/wiki/Q442980",
        "wikipedia_en": "https://en.wikipedia.org/wiki/Jeanette_Nolan",
        "wikipedia_ru": "https://ru.wikipedia.org/wiki/%D0%9D%D0%BE%D0%BB%D0%B0%D0%BD%2C_%D0%96%D0%B0%D0%BD%D0%B5%D1%82%D1%82"
      }
    }
  ],
  "limit": 2,
  "offset": 0,
  "total": null
}
```

### С биографией

```bash
curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "q=нолан" \
  --data-urlencode "limit=1" \
  --data-urlencode "fields=name,biography" \
  "https://api.kinodata.space/v1.3/persons"
```

Ответ `200`:

```json
{
  "has_more": true,
  "items": [
    {
      "imdb_id": "nm0634240",
      "kp_id": "41477",
      "tmdb_id": "525",
      "kinorium_id": "476400",
      "name_ru": "Кристофер Нолан",
      "name_en": "Christopher Nolan",
      "biography_ru": "Родился в Вестминстере в Лондоне. Вырос в Хайгейте. Отец, британец Брендан Джеймс Нолан, был менеджером по рекламе, а мать, американка Кристина (урождённая Дженсен), работала стюардессой и преподавательницей английского языка. Детство прошло между Лондоном и Эванстоном в Иллинойсе. Нолан имеет британское и американское гражданства. Его старший брат, Мэтью Фрэнсис Нолан, — бывший осуждённый преступник за попытку бегства из исправительного учреждения, был осуждён на 14 месяцев которые он отбыл и освобождён (был известен в криминальных кругах под псевдонимом «Оппенгеймер», которое не имеет отношение к учёному Роберту Оппенгеймеру, а получил в честь южноафриканской семьи торговцев алмазами). Считается, что в дальнейшем такое прозвище брата могло повлиять на замысел фильма «Оппенгеймер». По словам критика Василия Покровского, существует «шутливая конспирологическая теория, что Нолан нарочно снял фильм про создателя атомной бомбы, чтобы изменить выдачу по поисковому запросу „Нолан Оппенгеймер“». Младший Джонатан — сценарист, продюсер и кинорежиссёр.\n\nНолан начал делать фильмы с 7 лет, снимая короткие фильмы с элементами экшена на отцовскую камеру Super 8. В детстве на режиссёра особенно повлияли «Космическая одиссея 2001 года» (1968) и «Звёздные войны» (1977), в честь которых он в возрасте около восьми лет создал кукольную мультипликацию Space Wars. Дядя, работавший в НАСА и создававший ракетные системы для «Аполлон», прислал племяннику видеоматериалы со старта ракет. «Я снял их с экрана и отредактировал, думая, что никто их не заметит», — отмечал позже Нолан, который решил стать режиссёром в 11 лет.",
      "biography_en": "Christopher Nolan (born 30 July 1970) is a British and American filmmaker. Known for his Hollywood blockbusters with complex storytelling, Nolan is considered a leading filmmaker of the 21st century. His films have earned over $7.7 billion worldwide, making him the third-highest-grossing film director of all time. Nolan's accolades include two Academy Awards, a Golden Globe Award, and two British Academy Film Awards. He was also appointed a Commander of the British Empire (CBE) in 2019 and was knighted in 2024 for his contributions to film.\n\nNolan developed an interest in filmmaking from a young age. After studying English literature at University College London, he made several short films before his feature film debut with Following (1998). Nolan gained international recognition with his second film, Memento (2000), and transitioned into studio filmmaking with Insomnia (2002). He became a high-profile director with The Dark Knight trilogy (2005–2012) and found further success with The Prestige (2006), Inception (2010), Interstellar (2014) and Dunkirk (2017). After the release of the critically polarising Tenet (2020), Nolan parted ways with longtime distributor Warner Bros. Pictures over their streaming release strategy and signed with Universal Pictures for the highly successful Oppenheimer (2023) and The Odyssey (2026). The former won him Academy Awards for Best Director and Best Picture.\n\nThree of Nolan's films have been inducted into the United States National Film Registry. Additionally, two of his films are among the highest-grossing films of all time. Infused with a metaphysical outlook, his works thematise epistemology, existentialism, ethics, the construction of time and the malleable nature of memory and personal identity. They feature mathematically inspired images and concepts, unconventional narrative structures, practical special effects, experimental soundscapes, large-format film photography and materialistic perspectives. His enthusiasm for the use and preservation of analogue and IMAX film cameras in cinema production, as opposed to digital, has also garnered significant attention. He has co-written several of his films with his brother, Jonathan, and runs the production company Syncopy Inc. with his wife, Emma Thomas. Nolan has also been president of the Directors Guild of America since 2025.\n\nDescription above from the Wikipedia article Christopher Nolan, licensed under CC-BY-SA, full list of contributors on Wikipedia."
    }
  ],
  "limit": 1,
  "offset": 0,
  "total": null
}
```

### Только английский

```bash
curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "q=nolan" \
  --data-urlencode "limit=2" \
  --data-urlencode "lang=en" \
  "https://api.kinodata.space/v1.3/persons"
```

Ответ `200`:

```json
{
  "has_more": true,
  "items": [
    {
      "imdb_id": "nm0634240",
      "kp_id": "41477",
      "tmdb_id": "525",
      "kinorium_id": "476400",
      "name_en": "Christopher Nolan",
      "name_original": null,
      "birth_name": "Christopher Edward Nolan",
      "birth_year": 1970,
      "death_year": null,
      "birth_date": "1970-07-30",
      "death_date": null,
      "age": 56,
      "zodiac": {
        "slug": "leo",
        "label_en": "Leo"
      },
      "gender": "male",
      "birthplace_en": "Westminster, London, England, UK",
      "deathplace_en": null,
      "height_cm": 181,
      "nationality": [
        {
          "code": "gb",
          "name_en": "United Kingdom"
        },
        {
          "code": "us",
          "name_en": "United States"
        }
      ],
      "photo_url": "https://image.tmdb.org/t/p/w185/xuAIuYSmsUzKlUMBFGVZaWsY3DZ.jpg",
      "photos_by_source": {
        "kp": "https://st.kp.yandex.net/images/actor_iphone/iphone360_41477.jpg",
        "tmdb": "https://image.tmdb.org/t/p/w185/xuAIuYSmsUzKlUMBFGVZaWsY3DZ.jpg",
        "kinorium": "https://images.kinorium.com/persona/300/476400.jpg?20260829201207"
      },
      "professions": [
        "actor",
        "cinematographer",
        "composer",
        "director",
        "editor",
        "producer",
        "writer",
        "author"
      ],
      "career_start": 1989,
      "career_end": null,
      "genres": [
        {
          "slug": "speculative_fiction",
          "name_en": "Speculative Fiction"
        },
        {
          "slug": "action",
          "name_en": "Action"
        },
        {
          "slug": "thriller",
          "name_en": "Thriller"
        }
      ],
      "popularity": 9.174,
      "tagline_en": null,
      "also_known_as": [
        "Christopher Edward Nolan",
        "Chris Nolan",
        "Sir Christopher Nolan",
        "Sir Christopher Edward Nolan",
        "Christopher E. Nolan"
      ],
      "links": {
        "wikidata": "https://www.wikidata.org/wiki/Q25191",
        "wikipedia_en": "https://en.wikipedia.org/wiki/Christopher_Nolan",
        "wikipedia_ru": "https://ru.wikipedia.org/wiki/%D0%9D%D0%BE%D0%BB%D0%B0%D0%BD%2C_%D0%9A%D1%80%D0%B8%D1%81%D1%82%D0%BE%D1%84%D0%B5%D1%80"
      }
    },
    {
      "imdb_id": "nm0636046",
      "kp_id": "250538",
      "tmdb_id": "19508",
      "kinorium_id": "477739",
      "name_en": "Nolan North",
      "name_original": null,
      "birth_name": "Nolan Ramsay North",
      "birth_year": 1970,
      "death_year": null,
      "birth_date": "1970-10-31",
      "death_date": null,
      "age": 55,
      "zodiac": {
        "slug": "scorpio",
        "label_en": "Scorpio"
      },
      "gender": "male",
      "birthplace_en": "New Haven, Connecticut, USA",
      "deathplace_en": null,
      "height_cm": 183,
      "nationality": [
        {
          "code": "us",
          "name_en": "United States"
        }
      ],
      "photo_url": "https://image.tmdb.org/t/p/w185/gb499KZIoBTZnKCGKE4zwzlcfSe.jpg",
      "photos_by_source": {
        "kp": "https://st.kp.yandex.net/images/actor_iphone/iphone360_250538.jpg",
        "tmdb": "https://image.tmdb.org/t/p/w185/gb499KZIoBTZnKCGKE4zwzlcfSe.jpg",
        "kinorium": "https://images.kinorium.com/persona/300/477739.jpg?20180610152636"
      },
      "professions": [
        "actor"
      ],
      "career_start": 1995,
      "career_end": null,
      "genres": [
        {
          "slug": "animation",
          "name_en": "Animation"
        },
        {
          "slug": "action",
          "name_en": "Action"
        },
        {
          "slug": "comedy",
          "name_en": "Comedy"
        }
      ],
      "popularity": 2.609,
      "tagline_en": null,
      "also_known_as": [
        "Zachary Samuels",
        "Nolan Ramsey North",
        "諾蘭·諾斯",
        "诺兰·诺斯"
      ],
      "links": {
        "instagram": "https://instagram.com/reallynolannorth",
        "tiktok": "https://www.tiktok.com/@nolannorthofficial",
        "wikidata": "https://www.wikidata.org/wiki/Q1147104",
        "wikipedia_en": "https://en.wikipedia.org/wiki/Nolan_North",
        "wikipedia_ru": "https://ru.wikipedia.org/wiki/%D0%9D%D0%BE%D1%80%D1%82%2C_%D0%9D%D0%BE%D0%BB%D0%B0%D0%BD",
        "x": "https://x.com/nolan_north"
      }
    }
  ],
  "limit": 2,
  "offset": 0,
  "total": null
}
```

### Пустой запрос

```bash
curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "q=" \
  "https://api.kinodata.space/v1.3/persons"
```

Ответ `400`:

```json
{
  "error": {
    "code": "invalid_request",
    "message": "q is required: a name or a part of one",
    "field": "q",
    "hint": "e.g. /persons?q=нолан"
  }
}
```
