Фильмы и сериалы

Для каких сайтов

Онлайн-кинотеатры.

Что добавляет в результаты поиска

Ответ с информацией о стоимости и условиях просмотра фильма или сериала. В таком ответе пользователь может сразу запустить видео, если у него есть необходимая подписка. Если подписки нет, можно оформить ее или купить/арендовать фильм, перейдя из ответа на сайт партнера.

Предложения от партнеров внутри ответа отображаются в случайном порядке, но если у пользователя есть подписка, то связанные с ней предложения могут показываться выше.

Пример отображения (дизайн может меняться):

Как настроить

Чтобы контент от онлайн-кинотеатра попадал в такие ответы, Яндекс предоставляет механизм индексации для Поиска. Кинотеатрам необходимо подготовить файл, который будет содержать информацию о контенте в JSON-формате.

• Один онлайн-кинотеатр может предоставить только один файл.
• Логотип онлайн-кинотеатра должен соответствовать требованиям.
• После публикации файла вы можете вносить в него изменения. Следите за актуальностью данных и регулярно обновляйте файл. Яндекс будет регулярно обходить файл и обновлять информацию в ответе.

Также предложения могут попадать в ответ автоматически на основе обработки данных поискового робота Яндекса.

Передача данных в Яндекс

Подготовьте файл и передайте ссылку на него в Яндекс через форму внизу страницы.

Чтобы ваш файл был обработан корректно, он должен соответствовать требованиям:

• Файл должен соответствовать формату JSON.
• Файл должен быть доступен по протоколу HTTPS на домене онлайн-кинотеатра. Пример ссылки на файл: https://yoursite.ru/feed.json.
• Если для доступа к файлу используется авторизация, укажите логин и пароль при передаче ссылки на файл.

Формат данных

По ссылке ниже вы можете скачать полный пример JSON-файла с описанием контента. Мы добавили в него два фильма и один сериал.

Скачать пример

Файл должен содержать название сервиса, ссылку на главную страницу и описание контента. Количество единиц контента в одном файле не ограничено.

{
  "serviceName": "Кинотеатр N",
  "url": "https://yoursite.ru",
  "items": [{
    ...
    объекты, описывающие фильмы или сериалы
    ...
  }]
}

Описание параметров

Ключ	Значение	Тип данных	Обязательный при создании
serviceName	Название сервиса на русском или английском языке. Это имя будет отображаться в объектном ответе в Поиске.	Строка	Да
url	Ссылка на главную страницу сайта.	Строка	Да
items	Массив единиц контента. Ниже см. подробнее о параметрах фильмов и сериалов.	Массив JSON-объектов	Да

Объект-фильм в массиве items

Объект контента содержит основную информацию о фильме или сериале при одной модели монетизации (подписка, покупка) для конкретного региона распространения.

Располагайте объекты-фильмы в массиве items.

Примечание

Сочетание атрибутов kpId, monetizationModel, region в пределах файла должно быть уникальным.

Объект для фильма

{
        "title": "Прах времен",
        "kpId": "414157",
        "url": "https://www.ivi.ru/watch/2476",
        "addurl": "https://www.ivi.ru/watch/2476?utm_source=yandex",
        "[tvDeeplink](*tvDeeplink)": "ivi://movie?uid=f54ab672-ebc8-4753-8461-c83422683d7d&type=movie&action=play",
        "thumbnail": "https://thumbs.dfs.ivi.ru/storage30/contents/a/f/eaf144f2c975420a648ec0a55a0b31.jpg",
        "poster": "",
        "horizontalPoster": "",
        "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
        "watchPeriodEndDate": "2022-10-31T20:59:59.00Z",
        "region": "RU",
        "duration": 9000,
        "quality": "FullHD",
        "embedUrl": "https://www.ivi.ru/player/video/?id=145062",
        "tracks": ["Русский", "Русский 5.1", "Английский", "Английский 5.1"],
        "subtitles": ["Русские", "Английские"],
        "voiceActing": "",
        "restrictionAge": 18,
        "rightHolderLogo": "",
        "contentType": "Film",
        "[monetizationModel](*monetizationModel)": "SVOD",
        "requiresPayment": [
    {
        "price": 399,
        "currency": "RUB",
        "legalUrl": ""
    }
  ]
}

Описание параметров

Ключ	Значение	Тип данных	Обязательный при создании
title	Название фильма или сериала на русском языке.	Строка	Да
kpId	Идентификатор объекта в библиотеке Кинопоиска (необходимо для показа в ответе рейтинга фильма или сериала). Пример: для фильма «Начало», который доступен по ссылке https://www.kinopoisk.ru/film/447301 нужно указать "kpId":"447301".	Строка	Да
url	Ссылка на страницу для просмотра объекта на сервисе.	Строка	Да
addurl	Дополнительная ссылка на страницу просмотра для отслеживания переходов с поиска.	Строка	Нет
tvDeeplink	Ссылка на страницу для просмотра в приложении на телевизоре.	Строка	Нет
poster	Ссылка на вертикальную картинку. Картинка должна содержать название фильма. Размер: 1000 × 1500 пикселей. Форматы: PNG, IMG.	Строка	Нет
horizontalPoster	Ссылка на горизонтальную картинку. Картинка должна содержать название фильма. Размер: не менее 672 × 378 пикселей. Форматы: PNG, IMG.	Строка	Нет
thumbnail	Ссылка на горизонтальную картинку. Картинка не должна содержать название фильма. Может быть key-art или кадр из фильма. Размер: не менее 672 × 378 пикселей. Форматы: PNG, IMG.	Строка	Да
watchPeriodStartDate	Дата и время открытия прав на просмотр. Формат: ISO 8601 UTC. При отсутствии данных контент считается доступным без ограничений по времени.	Строка	Нет
showStartDate	Показывать дату и время открытия прав на просмотр. Возможные значения: true; false. Значение по умолчанию — true.	Boolean	Нет
watchPeriodEndDate	Дата и время закрытия прав на просмотр. Формат: ISO 8601 UTC. При отсутствии данных контент считается доступным без ограничений по времени.	Строка	Нет
region	Регион, в котором объект доступен к просмотру на этом сервисе. Формат: двухбуквенный код в формате ISO 3166. Возможные значения: "RU".	Строка	Да
disallowedRegions	Массив субьектов (регионов), в которых запрещен показ данной единицы контента по условиям правообладателя. Формат: перечислите англоязычные названия субъектов (регионов) через запятую в свободной форме.	Массив	Нет
duration	Длительность фильма в секундах.	Число	Нет
quality	Разрешение видео. Возможные значения: SD, HD, FullHD, UltraHD, 4K.	Строка	Да
embedUrl	Embed-ссылка на плеер, который будет встраиваться на страницу поискового запроса. Если невозможно встроить плеер в результаты поисковой выдачи, необходимо указать в этом поле значение null.	Строка	Нет (для SVOD, TVOD, EST) Да (для AVOD)
tracks	Массив с доступными звуковыми дорожками. Элементы — строки, указываются на языке региона.	Массив	Нет
subtitles	Массив доступных вариантов субтитров. Элементы — строки, указываются на языке региона.	Массив	Нет
voiceActing	Название студии озвучки. Указывается на языке региона.	Строка	Нет
restrictionAge	Возрастные ограничения из прокатных удостоверений. Необходимо указать число — минимальный возраст для просмотра. Значение по умолчанию: 18.	Число	Нет
rightHolderLogo	Логотип правообладателя. Размер 24 × 24 пикселей. Формат: ссылка на файл SVG.	Строка	Нет
contentType	Тип контента. Возможные значения: Film, Series.	Строка	Да
monetizationModel	Модель монетизации. Возможные значения: SVOD — Subscription Video on Demand. Пользователь покупает подписку на сервис. TVOD — Transactional Video on Demand. Пользователь арендует единицу контента на время. EST — Electronic Sell-Through. Пользователь покупает единицу контента. AVOD — Advertising Video on Demand. Пользователь смотрит видео с рекламой, которая демонстрируется с определенной периодичностью.	Строка	Да
requiresPayment	Массив данных с условиями покупки, аренды или подписки на объект. Для объектов с моделью монетизации AVOD указывается null.	Массив	Да
requiresPayment.name	Название подписки, в которую входит данный объект. Только для объектов с моделью монетизации SVOD.	Строка	Нет
requiresPayment.legalUrl	Ссылка на пользовательское соглашение об условиях подписки, покупки или аренды.	Строка	Да
requiresPayment.price	Цена покупки, аренды или стоимость подписки за один месяц. Для сериалов — общая сумма покупки доступных сезонов (из поля availableSeasons) по данной модели монетизации. Примечание Цена должна строго соответствовать модели монетизации. Указывайте цену без учета акций и специальных предложений для отдельных групп пользователей. Не рассчитывайте цену как часть от стоимости покупки подписки за более длительный период.	Число	Да (цена покупки и аренды) Нет (цена подписки)
requiresPayment.currency	Валюта, в которой указана стоимость объекта для выбранного региона.	Строка	Да

Объект-сериал в массиве items

Объект контента содержит основную информацию о фильме или сериале при одной модели монетизации (подписка, покупка) для конкретного региона распространения.

Важно

Если в сериале используется несколько моделей монетизации, например, часть серий доступна по AVOD, а остальные по SVOD, то нужно передать два объекта сериала. Они должны отличаться моделью монетизации и массивом доступных сезонов и серий.

Располагайте объекты-сериалы в массиве items.

Примечание

Сочетание атрибутов kpId, monetizationModel, region в пределах файла должно быть уникальным.

Объект для сериала

Сериальная структура представляет собой массив сезонов.

{
  {
  "title": "Пищеблок",
  "kpId": "1405843",
  "url": "https://hd.kinopoisk.ru/film/4385d995088540caad8e530cc25f8a2d",
  "addurl": "https://hd.kinopoisk.ru/?rt=4385d995088540caad8e530cc25f8a2d&utm_source=yandex",
  "[tvDeeplink](*tvDeeplink)": "kpatv://film/?filmId=400064e37cf78207a3d89e4ed4d1941f",
  "thumbnail": "https://avatars.mds.yandex.net/get-ott/2439731/2a0000017924346c15443939df21fb1eb3d0/orig",
  "poster": "https://avatars.mds.yandex.net/get-ott/374297/2a0000017981502594a46c1c4e3d63f1792a/orig",
  "horizontalPoster": "https://avatars.mds.yandex.net/get-ott/224348/2a0000017981506683f4bbe2718aa6b01aa7/orig",
  "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
  "watchPeriodEndDate": "2022-12-29T20:59:59.00Z",
  "region": "RU",
  "quality": "FullHD",
  "tracks": ["Русский", "Русский 5.1", "Английский", "Английский 5.1"],
  "subtitles": ["Русские", "Английские"],
  "voiceActing": "Кубик в кубе",
  "embedUrl": null,
  "restrictionAge": 18,
  "rightHolderLogo": "",
  "contentType": "Series",
  "[monetizationModel](*monetizationModel)": "SVOD",
  "requiresPayment": [
    {
      "name": "Плюс",
      "price": 399,
      "currency": "RUB",
      "legalUrl": ""
    }
  ],
  "availableSeasons": [
    1
  ],
  "seriesStruct": [
    {
      "season": 1,
      "url": "https://hd.kinopoisk.ru/film/4385d995088540caad8e530cc25f8a2d?season=1",
      "[tvDeeplink](*tvDeeplink)": "kpatv://film/?filmId=400064e37cf78207a3d89e4ed4d1941f&season=1",
      "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
      "watchPeriodEndDate": "2022-12-29T20:59:59.00Z",
      "episodes": [
        {
          "episode": 1,
          "url": "https://hd.kinopoisk.ru/film/4385d995088540caad8e530cc25f8a2d?episode=1&season=1",
          "[tvDeeplink](*tvDeeplink)": "kpatv://film/?filmId=400064e37cf78207a3d89e4ed4d1941f&episode=1&season=1",
          "thumbnail": "",
          "title": "Зима близко",
          "episodes.duration": 2520,
          "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
          "watchPeriodEndDate": "2022-12-29T20:59:59.00Z",
          "embedUrl": "..."
        },
        {
          "episode": 2,
          "url": "https://hd.kinopoisk.ru/film/4385d995088540caad8e530cc25f8a2d?episode=2&season=1",
          "[tvDeeplink](*tvDeeplink)": "kpatv://film/?filmId=400064e37cf78207a3d89e4ed4d1941f&episode=2&season=1",
          "thumbnail": "",
          "title": "Ответный удар",
          "episodes.duration": 2720,
          "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
          "watchPeriodEndDate": "2022-12-29T20:59:59.00Z",
          "embedUrl": "..."
        }
      ]
    }
  ]
}

Описание параметров

Ключ	Значение	Тип данных	Обязательный при создании
title	Название фильма или сериала на русском языке.	Строка	Да
kpId	Идентификатор объекта в библиотеке Кинопоиска (необходимо для показа в ответе рейтинга фильма или сериала). Пример: для фильма «Начало», который доступен по ссылке https://www.kinopoisk.ru/film/447301 нужно указать "kpId":"447301".	Строка	Да
url	Ссылка на страницу для просмотра объекта на сервисе.	Строка	Да
addurl	Дополнительная ссылка на страницу просмотра для отслеживания переходов с поиска.	Строка	Нет
thumbnail	Ссылка на горизонтальную картинку. Картинка не должна содержать название фильма. Может быть key-art или кадр из фильма. Размер: не менее 672 × 378 пикселей. Форматы: PNG, IMG.	Строка	Да
tvDeeplink	Ссылка на страницу для просмотра в приложении на телевизоре.	Строка	Нет
poster	Ссылка на вертикальную картинку. Картинка должна содержать название фильма. Размер: 1000 × 1500 пикселей. Форматы: PNG, IMG.	Строка	Нет
horizontalPoster	Ссылка на горизонтальную картинку. Картинка должна содержать название фильма. Размер: не менее 672 × 378 пикселей. Форматы: PNG, IMG.	Строка	Нет
watchPeriodStartDate	Дата и время открытия прав на просмотр. Формат: ISO 8601 UTC. При отсутствии данных контент считается доступным без ограничений по времени.	Строка	Нет
watchPeriodEndDate	Дата и время закрытия прав на просмотр. Формат: ISO 8601 UTC. При отсутствии данных контент считается доступным без ограничений по времени.	Строка	Нет
region	Регион, в котором объект доступен к просмотру на этом сервисе. Формат: двухбуквенный код в формате ISO 3166. Возможные значения: "RU".	Строка	Да
disallowedRegions	Массив субьектов (регионов), в которых запрещен показ данной единицы контента по условиям правообладателя. Формат: перечислите англоязычные названия субъектов (регионов) через запятую в свободной форме.	Массив	Нет
quality	Разрешение видео. Возможные значения: SD, HD, FullHD, UltraHD, 4K.	Строка	Да
tracks	Массив с доступными звуковыми дорожками. Элементы — строки, указываются на языке региона.	Массив	Нет
subtitles	Массив доступных вариантов субтитров. Элементы — строки, указываются на языке региона.	Массив	Нет
voiceActing	Название студии озвучки. Указывается на языке региона.	Строка	Нет
embedUrl	Embed-ссылка на плеер, который будет встраиваться на страницу поискового запроса. Для объекта сериала: null. Указывайте ссылку для объекта episodes.	null	Нет (для SVOD, TVOD, EST) Да (для AVOD)
restrictionAge	Возрастные ограничения из прокатных удостоверений. Необходимо указать число — минимальный возраст для просмотра. Значение по умолчанию: 18.	Число	Нет
rightHolderLogo	Логотип правообладателя. Размер 24 × 24 пикселей. Формат: ссылка на файл SVG.	Строка	Нет
contentType	Тип контента. Возможные значения: Film, Series.	Строка	Да
monetizationModel	Модель монетизации. Возможные значения: SVOD — Subscription Video on Demand. Пользователь покупает подписку на сервис. TVOD — Transactional Video on Demand. Пользователь арендует единицу контента на время. EST — Electronic Sell-Through. Пользователь покупает единицу контента. AVOD — Advertising Video on Demand. Пользователь смотрит видео с рекламой, которая демонстрируется с определенной периодичностью.	Строка	Да
requiresPayment	Массив данных с условиями покупки, аренды или подписки на объект. Для объектов с моделью монетизации AVOD указывается null.	Массив	Да
requiresPayment.name	Название подписки, в которую входит данный объект. Только для объектов с моделью монетизации SVOD.	Строка	Нет
requiresPayment.legalUrl	Ссылка на пользовательское соглашение об условиях подписки, покупки или аренды.	Строка	Да
requiresPayment.price	Цена покупки, аренды или стоимость подписки за один месяц. Для сериалов — общая сумма покупки доступных сезонов (из поля availableSeasons) по данной модели монетизации. Примечание Цена должна строго соответствовать модели монетизации. Указывайте цену без учета акций и специальных предложений для отдельных групп пользователей. Не рассчитывайте цену как часть от стоимости покупки подписки за более длительный период.	Число	Да (цена покупки и аренды) Нет (цена подписки)
requiresPayment.currency	Валюта, в которой указана стоимость объекта для выбранного региона.	Строка	Да
availableSeasons	Массив доступных номеров сезонов в данной модели монетизации.	Массив	Да
seriesStruct	Сериальная структура в заданном формате.	Массив JSON-объектов	Да
season	Номер сезона. Параметр в seriesStruct.	Число	Да
url	Ссылка на страницу с текущим сезоном. Параметр в seriesStruct. Если нет отдельного лендинга для сезонов, добавьте ссылку на главную страницу сериала.	Строка	Да
watchPeriodEndDate	Дата и время открытия прав на просмотр. Параметр в seriesStruct. Формат: ISO 8601 UTC. При отсутствии данных контент считается доступным без ограничений по времени.	Массив JSON-объектов	Нет
watchPeriodEndDate	Дата и время закрытия прав на просмотр. Параметр в seriesStruct. Формат: ISO 8601 UTC. При отсутствии данных контент считается доступным без ограничений по времени.	Массив JSON-объектов	Нет
requiresPayment	Массив данных с условиями покупки, аренды или подписки указанного сезона, если его можно приобрести отдельно для данной модели монетизации.	Массив JSON-объектов	Нет
requiresPayment.name	Название подписки, в которую входят все перечисленные сезоны сериала. Только для объектов с моделью монетизации SVOD.	Строка	Нет
requiresPayment.legalUrl	Ссылка на пользовательское соглашение об условиях подписки, покупки или аренды. Обязательна для массива requiresPayment.	Строка	Нет
requiresPayment.price	Цена покупки, аренды или подписки за указанный сезон. Обязательна для массива requiresPayment. Примечание Цена должна строго соответствовать модели монетизации. Указывайте цену без учета акций и специальных предложений для отдельных групп пользователей. Не рассчитывайте цену как часть от стоимости покупки подписки за более длительный период.	Число	Нет
requiresPayment.currency	Валюта, в которой указана стоимость сезона для выбранного региона. Обязательна для массива requiresPayment.	Строка	Нет
seriesStruct.episodes	Информация об эпизодах текущего сезона в виде массива эпизодов.	Массив JSON-объектов	Да
episodes.episode	Номер эпизода.	Число	Да
episodes.url	Ссылка на страницу с текущим эпизодом.	Строка	Да
episodes.thumbnail	Горизонтальная картинка, без названия серии или сериала. Может быть key-art или кадр из эпизода. Размер: не менее 672 × 378 пикселей. Формат: PNG, IMG.	Строка	Да
episodes.title	Название эпизода, если указано (на русском языке).	Строка	Нет
episodes.duration	Длительность эпизода в секундах.	Число	Да
episodes.embedUrl	Embed-ссылка на плеер, который будет встраиваться на страницу поискового запроса. Если невозможно встроить плеер в результаты поисковой выдачи, необходимо указать в этом поле значение null.	Строка	Нет (для SVOD, TVOD, EST) Да (для AVOD)

Требования к логотипу

Содержание

Логотип должен содержать только знак или шрифтовое описание (для коротких названий).

Расположение элементов

Логотип должен вписываться в квадрат и круг с учетом собственных охранных зон и внешними отступами не менее 12%. Допустим выход за сетку, если это часть фирменного стиля и не мешает считыванию знака.

Уровень детализации

Логотип должен иметь лаконичный вид и хорошо считываться в маленьких размерах. Мелкие детали, тени, фактуры, эффекты объема не допускаются.

Форма

Не допускается вписывание других форм в логотип.

Цвет

Допускается применение белого и черного цветов и еще не более двух других цветов и их градиентов. Узоры не допускаются.

Формат

Формат: SVG, с полной заливкой, без альфа-канала, без закруглений по краям.

Размер: до 10 МБ.

Условия отображения

Сайт несет ответственность за корректность данных, соответствие предложений тематике, а также за распространение незаконной информации. В случае нарушения условий Яндекс имеет право не использовать данные сайта для изменения представления ответа в поисковой выдаче. См. подробные условия.

Чтобы стать партнером, отправьте заявку и подготовленный файл через форму ниже.

Дата обновления страницы: 08.04.2025.

Предыдущие версии документа