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

GET/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. Работают все фильтры и сортировки каталога и fields; роли в fields называются credits.

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

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

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

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

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

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

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

• rolecsv

  Оставить тайтлы, где у человека есть одна из этих ролей. role.not — убрать тайтлы, где у него только такие роли: role.not=self,archive — всё, кроме эфиров и хроники. В credits остаются все его роли: режиссёрский фильм, где он ещё и продюсер, придёт с обеими.

  directoractorselfarchivewriterproducercinematographercomposersoundarteditorvoice_directorvoiceauthortranslatorproducer_ussrcrew
  Пример: role=director,writer
• фильтры и sort

  Фильтры и сортировка каталога: kind=movie, votes_imdb.gte=100000, sort=-rating_imdb. Подробно — в Фильтры и сортировка.

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

  sort=-year

• orderenum

  Направление сортировки по умолчанию: order=asc — от старых работ к новым. Если задан sort, направление берётся из его знака.

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

  desc

  Пример: order=asc
• fieldscsv

  Какие поля элемента вернуть, как в каталоге, плюс credits — роли человека. ID приходят всегда.

  Пример: fields=title,year,credits
• groupenum

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

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

  без разделов

• 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

  Тайтлы. С group=role — разделы по ролям, у каждого role, подписи, total, has_more и items.

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

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

  • creditsarray

    Роли человека в этом тайтле, в том же порядке, что roles.

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

    • roleenum

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

    • character_ru · character_enstring | null

      Персонаж — у актёров и в дубляже, без пометок источника, как в составе. У self — кем человек появляется: «гость», «Guest».

    • job_ru · job_enstring | null

      Должность в съёмочной группе: «Исполнительный продюсер», «Executive Producer».

    • ordinteger | null

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

    • sourcesarray

      Какие каталоги подтвердили кредит: kp, tmdb, kinorium, всегда в этом порядке.

    • uncreditedboolean

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

    • disputedboolean

      true — кредит есть только у TMDB, а в составе тайтла на Кинопоиске или Кинориуме этого человека нет. В составе тайтла такие кредиты не показываются; в списке работ скройте их условием disputed.

• totalinteger

  Сколько тайтлов подходит под запрос. Фильмография считает точно, и с фильтрами тоже.

• limit · offset · has_more

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

Ошибки