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

  1. Для каких сайтов
  2. Что добавляет в результаты поиска
  3. Как настроить
  4. Условия отображения

Это старая версия документа, которая прекратила свое действие 08.02.2022 г. Действующая версия размещена по адресу: https://yandex.ru/support/webmaster/search-appearance/films.html

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

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

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

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

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

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

Чтобы контент от онлайн-кинотеатра попадал в такие ответы, Яндекс предоставляет механизм индексации для Поиска. Кинотеатрам необходимо подготовить файл, который будет содержать информацию о контенте в 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?utm_source=yandex&utm_medium=wizard",
        "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": "SVOD",
        "requiresPayment": [
    {
        "price": 399,
        "currency": "RUB",
        "legalUrl": ""
    }
  ]
}
Скопировано
Описание параметров
Ключ Значение Тип данных Обязательный при создании
title Название фильма или сериала на русском языке. Строка Да
kpId

id объекта в библиотеке Кинопоиска (необходимо для показа в ответе рейтинга фильма или сериала).

Пример: для фильма «Начало», который доступен по ссылке https://www.kinopoisk.ru/film/447301 нужно указать "kpId":"447301".

Строка Да
url Ссылка на страницу для просмотра объекта на сервисе. Строка Да
poster

Ссылка на вертикальную картинку. Картинка должна содержать название фильма.

Размер: 1000 х 1500 px

Форматы: png, img

Строка Нет
horizontalPoster

Ссылка на горизонтальную картинку. Картинка должна содержать название фильма.

Размер: не менее 672 х 378 px

Форматы: png, img

Строка Нет
thumbnail

Ссылка на горизонтальную картинку. Картинка не должна содержать название фильма.

Может быть key-art или кадр из фильма.

Размер: не менее 672 х 378 px

Форматы: png, img

Строка Да
watchPeriodStartDate

Дата и время открытия прав на просмотр.

Формат: ISO 8601 UTC.

При отсутствии данных контент считается доступным без ограничений по времени.

Строка Нет
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.

Число Нет
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

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

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

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

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

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

{
  {
  "title": "Пищеблок",
  "kpId": "1405843",
  "url": "https://hd.kinopoisk.ru/?rt=4385d995088540caad8e530cc25f8a2d",
  "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": "SVOD",
  "requiresPayment": [
    {
      "name": "Плюс",
      "price": 399,
      "currency": "RUB",
      "legalUrl": ""
    }
  ],
  "availableSeasons": [
    1
  ],
  "seriesStruct": [
    {
      "season": 1,
      "url": "https://hd.kinopoisk.ru/film/4385d995088540caad8e530cc25f8a2d?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",
          "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",
          "thumbnail": "",
          "title": "Ответный удар",
          "episodes.duration": 2720,
          "watchPeriodStartDate": "2020-11-06T05:08:15.00Z",
          "watchPeriodEndDate": "2022-12-29T20:59:59.00Z",
          "embedUrl": "..."
        }
      ]
    }
  ]
}
Скопировано
Описание параметров
Ключ Значение Тип данных Обязательный при создании
title Название фильма или сериала на русском языке. Строка Да
kpId

id объекта в библиотеке Кинопоиска (необходимо для показа в ответе рейтинга фильма или сериала).

Пример: для фильма «Начало», который доступен по ссылке https://www.kinopoisk.ru/film/447301 нужно указать "kpId":"447301".

Строка Да
url Ссылка на страницу для просмотра объекта на сервисе. Строка Да
thumbnail

Ссылка на горизонтальную картинку. Картинка не должна содержать название фильма.

Может быть key-art или кадр из фильма.

Размер: не менее 672 х 378 px

Форматы: png, img

Строка Да
poster

Ссылка на вертикальную картинку. Картинка должна содержать название фильма.

Размер: 1000 х 1500 px

Форматы: png, img

Строка Нет
horizontalPoster

Ссылка на горизонтальную картинку. Картинка должна содержать название фильма.

Размер: не менее 672 х 378 px

Форматы: 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 x 24 px

Формат: ссылка на файл .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 px. Формат: png, img. Строка Да
episodes.title Название эпизода, если указано (на русском языке). Строка Нет
episodes.duration Длительность эпизода в секундах. Число Да
episodes.embedUrl

Embed-ссылка на плеер, который будет встраиваться на страницу поискового запроса.

Если невозможно встроить плеер в результаты поисковой выдачи, необходимо указать в этом поле значение null.

Строка

Нет (для SVOD, TVOD, EST)

Да (для AVOD)

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

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

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

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