# Фильмография

> Все работы человека с его ролями — с фильтрами и сортировкой каталога.

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

Запрос: `GET https://api.kinodata.space/v1.3/persons/{type}/{id}/filmography`

Тайтл приходит один раз, со всеми ролями человека в нём: в «Тёмном рыцаре» Кристофер Нолан — режиссёр, сценарист и продюсер. Роли лежат в `credits`.

`roles` описывает всю карьеру, а не страницу: сколько тайтлов в каждой роли и подписи ролей. От `role`, фильтров и страницы он не зависит — по нему рисуются вкладки.

Появления в роли себя — эфиры, церемонии, фильмы о съёмках — отдельная роль `self`, архивные кадры — `archive`. `role=actor` их не захватывает, `role=self` собирает отдельно, а `role.not=self,archive` оставляет только работу в кино: у Нолана 33 тайтла из 131.

Без `sort` фильмография идёт от новых работ к старым, и первыми оказываются анонсы; `order=asc` переворачивает её. Чтобы начать с главного, сортируйте по голосам — `sort=-votes_imdb` — или возьмите пресет: `preset=top` идёт по оценке IMDb. Работают все [фильтры и сортировки каталога](https://kinodata.space/ru/docs/filters.md) и `fields`; роли в `fields` называются `credits`.

Тайтлы человека можно выбрать и в каталоге: `/titles?person=kp:41477`. Каталог листается курсором и сочетает человека с поиском по названию, но ролей в ответе нет.

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

- `type` (string, обязательный) — Каталог, из которого ID: IMDb, Кинопоиск, TMDB или Кинориум.
  Значения: `imdb`, `kp`, `tmdb`, `kinorium`.
- `id` (string, обязательный) — ID человека в этом каталоге. У IMDb — `nm` и цифры (`nm0634240`), у остальных — цифры (`41477`).

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

- `role` (csv) — Оставить тайтлы, где у человека есть одна из этих ролей. `role.not` — убрать тайтлы, где у него только такие роли: `role.not=self,archive` — всё, кроме эфиров и хроники. В `credits` остаются все его роли: режиссёрский фильм, где он ещё и продюсер, придёт с обеими.
  Значения: `director`, `actor`, `self`, `archive`, `writer`, `producer`, `cinematographer`, `composer`, `sound`, `art`, `editor`, `voice_director`, `voice`, `author`, `translator`, `producer_ussr`, `crew`.
  Пример: `role=director,writer`.
- `фильтры и sort` — Фильтры и сортировка каталога: `kind=movie`, `votes_imdb.gte=100000`, `sort=-rating_imdb`. Подробно — в [Фильтры и сортировка](https://kinodata.space/ru/docs/filters.md).
  По умолчанию: `sort=-year`.
- `order` (enum) — Направление сортировки по умолчанию: `order=asc` — от старых работ к новым. Если задан `sort`, направление берётся из его знака.
  Значения: `asc`, `desc`.
  По умолчанию: `desc`. Пример: `order=asc`.
- `fields` (csv) — Какие поля элемента вернуть, как в [каталоге](https://kinodata.space/ru/docs/titles.md), плюс `credits` — роли человека. ID приходят всегда.
  Пример: `fields=title,year,credits`.
- `group` (enum) — Разбить список на разделы. `none` — плоский список. Как устроены разделы — в [Списки и пагинация](https://kinodata.space/ru/docs/lists.md#разделы).
  Значения: `role`, `none`.
  По умолчанию: без разделов.
- `lang` (ru | en) — Оставить в ответе один язык. Без него текстовые поля приходят парами `_ru` и `_en`. Подробнее — [Языки ответа](https://kinodata.space/ru/docs/languages.md).
  Пример: `lang=en`.
- `limit` (integer) — Сколько элементов вернуть, целое от 1. В разделах — на каждый раздел, до 50. В плоском списке — до 1000. Больше потолка — не ошибка: API срежет до него и покажет в `limit`.
  По умолчанию: 10 в разделе, 1000 в плоском списке. Пример: `limit=20`.
- `offset` (integer) — Сколько элементов пропустить, целое от 0. Только в плоском списке: с разделами — `400`.
  По умолчанию: 0.

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

- `roles` (array) — Сколько тайтлов за всю карьеру по ролям: `role`, подписи `label_ru` и `label_en`, `count`. Порядок — как в титрах: режиссёры, актёры, в роли себя, архивные кадры, сценаристы, продюсеры и дальше.
- `items` (array) — Тайтлы. С `group=role` — разделы по ролям, у каждого `role`, подписи, `total`, `has_more` и `items`.
  - `imdb_id`, `kp_id`, `tmdb_id`, `tmdb_tv_id`, `kinorium_id` (string | null) — ID тайтла в каталогах. Приходят всегда, даже с `fields`.
  - `title_ru`, `title_en`, `title_original` (string | null) — Названия: на русском, на английском и на языке оригинала.
  - `year` (integer | null) — Год выхода.
  - `release_date` (string | null) — Первая дата выхода, `YYYY-MM-DD`.
  - `kind` (enum) — Вид тайтла: `movie`, `series`, `mini_series`, `tv_show`, `anime`, `cartoon`, `short`.
  - `poster_url_ru`, `poster_url_en` (string | null) — Постер для русской и английской витрины.
  - `posters_by_source` (object) — Постер каждого источника: `kp`, `tmdb`, `imdb`, `kinorium`.
  - `rating_kp`, `rating_tmdb`, `rating_imdb`, `rating_kr`, `rating_letterboxd` (number | null) — Оценки Кинопоиска, TMDB, IMDb, Кинориума и Letterboxd, шкала 0–10.
  - `votes_kp`, `votes_tmdb`, `votes_imdb` (integer | null) — Голоса Кинопоиска, TMDB и IMDb.
  - `countries` (array) — Страны: `code`, `name_ru`, `name_en`.
  - `genres` (array) — Жанры: `slug`, `name_ru`, `name_en`.
  - `credits` (array) — Роли человека в этом тайтле, в том же порядке, что `roles`.
    - `role` (enum) — Роль. Подписи — в `/enums`, набор `credit_roles`.
    - `character_ru`, `character_en` (string | null) — Персонаж — у актёров и в дубляже, без пометок источника, как в [составе](https://kinodata.space/ru/docs/titles/cast.md). У `self` — кем человек появляется: «гость», «Guest».
    - `job_ru`, `job_en` (string | null) — Должность в съёмочной группе: «Исполнительный продюсер», «Executive Producer».
    - `ord` (integer | null) — Место в титрах: у актёров — порядок в титрах, у съёмочной группы — внутри своего цеха. `null` — место неизвестно: роль взята из фильмографии человека, а не из титров тайтла.
    - `sources` (array) — Какие каталоги подтвердили кредит: `kp`, `tmdb`, `kinorium`, всегда в этом порядке.
    - `uncredited` (boolean) — `true` — человека нет в титрах тайтла: источник пометил роль «в титрах не указан» или “uncredited”.
    - `disputed` (boolean) — `true` — кредит есть только у TMDB, а в составе тайтла на Кинопоиске или Кинориуме этого человека нет. В [составе тайтла](https://kinodata.space/ru/docs/titles/cast.md) такие кредиты не показываются; в списке работ скройте их условием `disputed`.
- `total` (integer) — Сколько тайтлов подходит под запрос. Фильмография считает точно, и с фильтрами тоже.
- `limit`, `offset`, `has_more` — Пагинация — как в [любом списке](https://kinodata.space/ru/docs/lists.md#форма-списка).

## Ошибки

| статус | код | когда |
|---|---|---|
| 400 | `invalid_request` | Неизвестная роль в `role` или `role.not`, фильтр, ключ `sort`, поле в `fields` или `group`; `order` не `asc` и не `desc`; параметр другого эндпоинта (например, `relation` или `season`); `limit` меньше 1 или `offset` меньше 0; повторённый параметр; `offset` вместе с разделами; `cursor` — фильмография листается `offset`. |
| 400 | `invalid_request` | Каталог не `imdb`, `kp`, `tmdb` или `kinorium` (у людей нет `tmdb_tv`); ID не в формате каталога — у IMDb это `nm` и цифры. |
| 404 | `not_found` | Человек с таким ID не найден. |
| 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 "role=director" \
  --data-urlencode "sort=-votes_imdb" \
  --data-urlencode "limit=3" \
  --data-urlencode "fields=title,year,credits" \
  "https://api.kinodata.space/v1.3/persons/kp/41477/filmography"
```

Ответ `200`:

```json
{
  "has_more": true,
  "items": [
    {
      "imdb_id": "tt0468569",
      "kp_id": "111543",
      "tmdb_id": "155",
      "tmdb_tv_id": null,
      "kinorium_id": "352641",
      "title_ru": "Тёмный рыцарь",
      "title_en": "The Dark Knight",
      "year": 2008,
      "credits": [
        {
          "role": "director",
          "character_ru": null,
          "character_en": null,
          "job_ru": null,
          "job_en": null,
          "ord": 0,
          "sources": [
            "kp",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        },
        {
          "role": "writer",
          "character_ru": null,
          "character_en": null,
          "job_ru": "Сценарий",
          "job_en": "Screenplay",
          "ord": 7,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        },
        {
          "role": "producer",
          "character_ru": null,
          "character_en": null,
          "job_ru": null,
          "job_en": null,
          "ord": 1,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        }
      ]
    },
    {
      "imdb_id": "tt1375666",
      "kp_id": "447301",
      "tmdb_id": "27205",
      "tmdb_tv_id": null,
      "kinorium_id": "472809",
      "title_ru": "Начало",
      "title_en": "Inception",
      "year": 2010,
      "credits": [
        {
          "role": "director",
          "character_ru": null,
          "character_en": null,
          "job_ru": null,
          "job_en": null,
          "ord": 0,
          "sources": [
            "kp",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        },
        {
          "role": "writer",
          "character_ru": null,
          "character_en": null,
          "job_ru": "Сценарист",
          "job_en": "Writer",
          "ord": 13,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        },
        {
          "role": "producer",
          "character_ru": null,
          "character_en": null,
          "job_ru": "Продюсер",
          "job_en": "Producer",
          "ord": 0,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        }
      ]
    },
    {
      "imdb_id": "tt0816692",
      "kp_id": "258687",
      "tmdb_id": "157336",
      "tmdb_tv_id": null,
      "kinorium_id": "384511",
      "title_ru": "Интерстеллар",
      "title_en": "Interstellar",
      "year": 2014,
      "credits": [
        {
          "role": "director",
          "character_ru": null,
          "character_en": null,
          "job_ru": null,
          "job_en": null,
          "ord": 0,
          "sources": [
            "kp",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        },
        {
          "role": "writer",
          "character_ru": null,
          "character_en": null,
          "job_ru": null,
          "job_en": null,
          "ord": 16,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        },
        {
          "role": "producer",
          "character_ru": null,
          "character_en": null,
          "job_ru": "Продюсер",
          "job_en": "Producer",
          "ord": 0,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        }
      ]
    }
  ],
  "limit": 3,
  "offset": 0,
  "roles": [
    {
      "role": "director",
      "label_ru": "Режиссёры",
      "label_en": "Directors",
      "count": 19
    },
    {
      "role": "actor",
      "label_ru": "Актёры",
      "label_en": "Actors",
      "count": 2
    },
    {
      "role": "self",
      "label_ru": "В роли себя",
      "label_en": "Self",
      "count": 90
    },
    {
      "role": "archive",
      "label_ru": "Архивные кадры",
      "label_en": "Archive Footage",
      "count": 12
    },
    {
      "role": "writer",
      "label_ru": "Сценаристы",
      "label_en": "Writers",
      "count": 20
    },
    {
      "role": "producer",
      "label_ru": "Продюсеры",
      "label_en": "Producers",
      "count": 22
    },
    {
      "role": "cinematographer",
      "label_ru": "Операторы",
      "label_en": "Cinematographers",
      "count": 5
    },
    {
      "role": "composer",
      "label_ru": "Композиторы",
      "label_en": "Composers",
      "count": 1
    },
    {
      "role": "editor",
      "label_ru": "Монтажёры",
      "label_en": "Editors",
      "count": 5
    },
    {
      "role": "crew",
      "label_ru": "Съёмочная группа",
      "label_en": "Crew",
      "count": 3
    }
  ],
  "total": 19
}
```

### Разделы по ролям

```bash
curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "group=role" \
  --data-urlencode "sort=-votes_imdb" \
  --data-urlencode "limit=1" \
  --data-urlencode "fields=title,year" \
  "https://api.kinodata.space/v1.3/persons/kp/41477/filmography"
```

Ответ `200`:

```json
{
  "has_more": false,
  "items": [
    {
      "has_more": true,
      "items": [
        {
          "imdb_id": "tt0468569",
          "kp_id": "111543",
          "tmdb_id": "155",
          "tmdb_tv_id": null,
          "kinorium_id": "352641",
          "title_ru": "Тёмный рыцарь",
          "title_en": "The Dark Knight",
          "year": 2008
        }
      ],
      "label_en": "Directors",
      "label_ru": "Режиссёры",
      "role": "director",
      "total": 19
    },
    {
      "has_more": true,
      "items": [
        {
          "imdb_id": "tt6386408",
          "kp_id": "824979",
          "tmdb_id": "804706",
          "tmdb_tv_id": null,
          "kinorium_id": "760352",
          "title_ru": "Тарантелла",
          "title_en": "Tarantella",
          "year": 1989
        }
      ],
      "label_en": "Actors",
      "label_ru": "Актёры",
      "role": "actor",
      "total": 2
    },
    {
      "has_more": true,
      "items": [
        {
          "imdb_id": "tt0458254",
          "kp_id": "686423",
          "tmdb_id": null,
          "tmdb_tv_id": "4385",
          "kinorium_id": "346114",
          "title_ru": "Отчёт Колбера",
          "title_en": "The Colbert Report",
          "year": 2005
        }
      ],
      "label_en": "Self",
      "label_ru": "В роли себя",
      "role": "self",
      "total": 90
    },
    {
      "has_more": true,
      "items": [
        {
          "imdb_id": "tt2610260",
          "kp_id": "1040418",
          "tmdb_id": null,
          "tmdb_tv_id": null,
          "kinorium_id": "1607861",
          "title_ru": "Честные трейлеры",
          "title_en": "Honest Trailers",
          "year": 2012
        }
      ],
      "label_en": "Archive Footage",
      "label_ru": "Архивные кадры",
      "role": "archive",
      "total": 12
    },
    {
      "has_more": true,
      "items": [
        {
          "imdb_id": "tt0468569",
          "kp_id": "111543",
          "tmdb_id": "155",
          "tmdb_tv_id": null,
          "kinorium_id": "352641",
          "title_ru": "Тёмный рыцарь",
          "title_en": "The Dark Knight",
          "year": 2008
        }
      ],
      "label_en": "Writers",
      "label_ru": "Сценаристы",
      "role": "writer",
      "total": 20
    },
    {
      "has_more": true,
      "items": [
        {
          "imdb_id": "tt0468569",
          "kp_id": "111543",
          "tmdb_id": "155",
          "tmdb_tv_id": null,
          "kinorium_id": "352641",
          "title_ru": "Тёмный рыцарь",
          "title_en": "The Dark Knight",
          "year": 2008
        }
      ],
      "label_en": "Producers",
      "label_ru": "Продюсеры",
      "role": "producer",
      "total": 22
    },
    {
      "has_more": true,
      "items": [
        {
          "imdb_id": "tt0154506",
          "kp_id": "8350",
          "tmdb_id": "11660",
          "tmdb_tv_id": null,
          "kinorium_id": "130746",
          "title_ru": "Преследование",
          "title_en": "Following",
          "year": 1998
        }
      ],
      "label_en": "Cinematographers",
      "label_ru": "Операторы",
      "role": "cinematographer",
      "total": 5
    },
    {
      "has_more": false,
      "items": [
        {
          "imdb_id": "tt4907572",
          "kp_id": "926864",
          "tmdb_id": "352114",
          "tmdb_tv_id": null,
          "kinorium_id": "1539254",
          "title_ru": "Куэй",
          "title_en": "Quay",
          "year": 2015
        }
      ],
      "label_en": "Composers",
      "label_ru": "Композиторы",
      "role": "composer",
      "total": 1
    },
    {
      "has_more": true,
      "items": [
        {
          "imdb_id": "tt0154506",
          "kp_id": "8350",
          "tmdb_id": "11660",
          "tmdb_tv_id": null,
          "kinorium_id": "130746",
          "title_ru": "Преследование",
          "title_en": "Following",
          "year": 1998
        }
      ],
      "label_en": "Editors",
      "label_ru": "Монтажёры",
      "role": "editor",
      "total": 5
    },
    {
      "has_more": true,
      "items": [
        {
          "imdb_id": "tt0411302",
          "kp_id": "81803",
          "tmdb_id": "43629",
          "tmdb_tv_id": null,
          "kinorium_id": "315411",
          "title_ru": "Жук-скакун",
          "title_en": "Doodlebug",
          "year": 1997
        }
      ],
      "label_en": "Crew",
      "label_ru": "Съёмочная группа",
      "role": "crew",
      "total": 3
    }
  ],
  "limit": 1,
  "offset": 0,
  "roles": [
    {
      "role": "director",
      "label_ru": "Режиссёры",
      "label_en": "Directors",
      "count": 19
    },
    {
      "role": "actor",
      "label_ru": "Актёры",
      "label_en": "Actors",
      "count": 2
    },
    {
      "role": "self",
      "label_ru": "В роли себя",
      "label_en": "Self",
      "count": 90
    },
    {
      "role": "archive",
      "label_ru": "Архивные кадры",
      "label_en": "Archive Footage",
      "count": 12
    },
    {
      "role": "writer",
      "label_ru": "Сценаристы",
      "label_en": "Writers",
      "count": 20
    },
    {
      "role": "producer",
      "label_ru": "Продюсеры",
      "label_en": "Producers",
      "count": 22
    },
    {
      "role": "cinematographer",
      "label_ru": "Операторы",
      "label_en": "Cinematographers",
      "count": 5
    },
    {
      "role": "composer",
      "label_ru": "Композиторы",
      "label_en": "Composers",
      "count": 1
    },
    {
      "role": "editor",
      "label_ru": "Монтажёры",
      "label_en": "Editors",
      "count": 5
    },
    {
      "role": "crew",
      "label_ru": "Съёмочная группа",
      "label_en": "Crew",
      "count": 3
    }
  ],
  "total": 10
}
```

### В роли себя

```bash
curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "role=self" \
  --data-urlencode "sort=-votes_imdb" \
  --data-urlencode "limit=2" \
  --data-urlencode "fields=title,year,credits" \
  "https://api.kinodata.space/v1.3/persons/kp/41477/filmography"
```

Ответ `200`:

```json
{
  "has_more": true,
  "items": [
    {
      "imdb_id": "tt0458254",
      "kp_id": "686423",
      "tmdb_id": null,
      "tmdb_tv_id": "4385",
      "kinorium_id": "346114",
      "title_ru": "Отчёт Колбера",
      "title_en": "The Colbert Report",
      "year": 2005,
      "credits": [
        {
          "role": "self",
          "character_ru": "гость",
          "character_en": "Guest",
          "job_ru": null,
          "job_en": null,
          "ord": 1194,
          "sources": [
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        }
      ]
    },
    {
      "imdb_id": "tt2014338",
      "kp_id": "602678",
      "tmdb_id": "110354",
      "tmdb_tv_id": null,
      "kinorium_id": "599109",
      "title_ru": "Бок о бок",
      "title_en": "Side by Side",
      "year": 2012,
      "credits": [
        {
          "role": "self",
          "character_ru": null,
          "character_en": null,
          "job_ru": null,
          "job_en": null,
          "ord": 12,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        }
      ]
    }
  ],
  "limit": 2,
  "offset": 0,
  "roles": [
    {
      "role": "director",
      "label_ru": "Режиссёры",
      "label_en": "Directors",
      "count": 19
    },
    {
      "role": "actor",
      "label_ru": "Актёры",
      "label_en": "Actors",
      "count": 2
    },
    {
      "role": "self",
      "label_ru": "В роли себя",
      "label_en": "Self",
      "count": 90
    },
    {
      "role": "archive",
      "label_ru": "Архивные кадры",
      "label_en": "Archive Footage",
      "count": 12
    },
    {
      "role": "writer",
      "label_ru": "Сценаристы",
      "label_en": "Writers",
      "count": 20
    },
    {
      "role": "producer",
      "label_ru": "Продюсеры",
      "label_en": "Producers",
      "count": 22
    },
    {
      "role": "cinematographer",
      "label_ru": "Операторы",
      "label_en": "Cinematographers",
      "count": 5
    },
    {
      "role": "composer",
      "label_ru": "Композиторы",
      "label_en": "Composers",
      "count": 1
    },
    {
      "role": "editor",
      "label_ru": "Монтажёры",
      "label_en": "Editors",
      "count": 5
    },
    {
      "role": "crew",
      "label_ru": "Съёмочная группа",
      "label_en": "Crew",
      "count": 3
    }
  ],
  "total": 90
}
```

### Фильмы по оценке

```bash
curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "kind=movie" \
  --data-urlencode "votes_imdb.gte=100000" \
  --data-urlencode "sort=-rating_imdb" \
  --data-urlencode "limit=3" \
  --data-urlencode "fields=title,rating_imdb" \
  "https://api.kinodata.space/v1.3/persons/kp/41477/filmography"
```

Ответ `200`:

```json
{
  "has_more": true,
  "items": [
    {
      "imdb_id": "tt0468569",
      "kp_id": "111543",
      "tmdb_id": "155",
      "tmdb_tv_id": null,
      "kinorium_id": "352641",
      "title_ru": "Тёмный рыцарь",
      "title_en": "The Dark Knight",
      "rating_imdb": 9.1
    },
    {
      "imdb_id": "tt1375666",
      "kp_id": "447301",
      "tmdb_id": "27205",
      "tmdb_tv_id": null,
      "kinorium_id": "472809",
      "title_ru": "Начало",
      "title_en": "Inception",
      "rating_imdb": 8.8
    },
    {
      "imdb_id": "tt0816692",
      "kp_id": "258687",
      "tmdb_id": "157336",
      "tmdb_tv_id": null,
      "kinorium_id": "384511",
      "title_ru": "Интерстеллар",
      "title_en": "Interstellar",
      "rating_imdb": 8.7
    }
  ],
  "limit": 3,
  "offset": 0,
  "roles": [
    {
      "role": "director",
      "label_ru": "Режиссёры",
      "label_en": "Directors",
      "count": 19
    },
    {
      "role": "actor",
      "label_ru": "Актёры",
      "label_en": "Actors",
      "count": 2
    },
    {
      "role": "self",
      "label_ru": "В роли себя",
      "label_en": "Self",
      "count": 90
    },
    {
      "role": "archive",
      "label_ru": "Архивные кадры",
      "label_en": "Archive Footage",
      "count": 12
    },
    {
      "role": "writer",
      "label_ru": "Сценаристы",
      "label_en": "Writers",
      "count": 20
    },
    {
      "role": "producer",
      "label_ru": "Продюсеры",
      "label_en": "Producers",
      "count": 22
    },
    {
      "role": "cinematographer",
      "label_ru": "Операторы",
      "label_en": "Cinematographers",
      "count": 5
    },
    {
      "role": "composer",
      "label_ru": "Композиторы",
      "label_en": "Composers",
      "count": 1
    },
    {
      "role": "editor",
      "label_ru": "Монтажёры",
      "label_en": "Editors",
      "count": 5
    },
    {
      "role": "crew",
      "label_ru": "Съёмочная группа",
      "label_en": "Crew",
      "count": 3
    }
  ],
  "total": 18
}
```

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

```bash
curl -G -H "X-API-Key: $KINODATA_KEY" \
  --data-urlencode "role=director" \
  --data-urlencode "sort=-votes_imdb" \
  --data-urlencode "limit=2" \
  --data-urlencode "fields=title,year,credits" \
  --data-urlencode "lang=en" \
  "https://api.kinodata.space/v1.3/persons/kp/41477/filmography"
```

Ответ `200`:

```json
{
  "has_more": true,
  "items": [
    {
      "imdb_id": "tt0468569",
      "kp_id": "111543",
      "tmdb_id": "155",
      "tmdb_tv_id": null,
      "kinorium_id": "352641",
      "title_en": "The Dark Knight",
      "year": 2008,
      "credits": [
        {
          "role": "director",
          "character_en": null,
          "job_en": null,
          "ord": 0,
          "sources": [
            "kp",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        },
        {
          "role": "writer",
          "character_en": null,
          "job_en": "Screenplay",
          "ord": 7,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        },
        {
          "role": "producer",
          "character_en": null,
          "job_en": null,
          "ord": 1,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        }
      ]
    },
    {
      "imdb_id": "tt1375666",
      "kp_id": "447301",
      "tmdb_id": "27205",
      "tmdb_tv_id": null,
      "kinorium_id": "472809",
      "title_en": "Inception",
      "year": 2010,
      "credits": [
        {
          "role": "director",
          "character_en": null,
          "job_en": null,
          "ord": 0,
          "sources": [
            "kp",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        },
        {
          "role": "writer",
          "character_en": null,
          "job_en": "Writer",
          "ord": 13,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        },
        {
          "role": "producer",
          "character_en": null,
          "job_en": "Producer",
          "ord": 0,
          "sources": [
            "kp",
            "tmdb",
            "kinorium"
          ],
          "disputed": false,
          "uncredited": false
        }
      ]
    }
  ],
  "limit": 2,
  "offset": 0,
  "roles": [
    {
      "role": "director",
      "label_en": "Directors",
      "count": 19
    },
    {
      "role": "actor",
      "label_en": "Actors",
      "count": 2
    },
    {
      "role": "self",
      "label_en": "Self",
      "count": 90
    },
    {
      "role": "archive",
      "label_en": "Archive Footage",
      "count": 12
    },
    {
      "role": "writer",
      "label_en": "Writers",
      "count": 20
    },
    {
      "role": "producer",
      "label_en": "Producers",
      "count": 22
    },
    {
      "role": "cinematographer",
      "label_en": "Cinematographers",
      "count": 5
    },
    {
      "role": "composer",
      "label_en": "Composers",
      "count": 1
    },
    {
      "role": "editor",
      "label_en": "Editors",
      "count": 5
    },
    {
      "role": "crew",
      "label_en": "Crew",
      "count": 3
    }
  ],
  "total": 19
}
```