Медиа

GET/v1.3/titles/{type}/{id}/media

Постеры, кадры, логотипы и видео тайтла одним списком.

Изображения и видео приходят в одной форме. У изображения пусты youtube_id, preview_url и runtime_sec, у видео — width и height. Адреса полные: собирать ссылку из частей не нужно.

Медиатека бывает большой — у «Начала» 485 файлов. Сужайте её: type=poster&language=ru — постеры на русском, class=video — только видео, group=type — разделы с размерами.

Анимированный постер poster_gif числится изображением, но это ролик mp4 до 7 МБ. Показывайте его в <video autoplay muted loop playsinline> и грузите по требованию. Если он есть, он один и идёт первым.

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

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

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

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

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

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

• classenum

  Только изображения или только видео.

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

  оба

• typeenum

  Вид файла. Изображения: poster_gif, poster, backdrop, still, cover, logo, promo, backstage, other. Видео: trailer, teaser, tvspot, clip, interview, music_video, behind_scenes, blooper, overview, other. other есть у обоих: чтобы выбрать одно, добавьте class. Подписи — в /enums, наборы image_types и video_kinds.

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

  все

  Пример: type=poster
• languagestring

  Язык надписей на изображении или звука в видео, код ISO 639-1.

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

  все

  Пример: language=ru
• groupenum

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

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

  без разделов

• langru | en

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

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

  Сколько элементов вернуть, целое от 1. В разделах — на каждый раздел, до 50. В плоском списке — до 1000. Больше потолка — не ошибка: API срежет до него и покажет в limit.

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

  10 в разделе, 1000 в плоском списке

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

  Сколько элементов пропустить, целое от 0. Только в плоском списке: с разделами — 400.

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

  0

Поля ответа

• itemsarray

  Файлы. С group — разделы со своими total и подписями.

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

  • classenum

    image или video.

  • typeenum

    Вид файла.

    poster_gifposterbackdropstillcoverlogopromobackstageothertrailerteasertvspotclipinterviewmusic_videobehind_scenesblooperoverview
  • urlstring

    Адрес файла. У видео — страница плеера: YouTube, а иногда ВКонтакте.

  • languagestring | null

    Язык надписей или звука, ISO 639-1. null — без языка или неизвестен.

  • width · heightinteger | null

    Размер изображения в пикселях. У видео — null.

  • youtube_idstring | null

    ID ролика на YouTube. null у видео с других площадок — тогда открывайте url.

  • preview_urlstring | null

    Обложка видео.

  • runtime_secinteger | null

    Длительность видео в секундах.

• total · limit · offset · has_more

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

Ошибки