SberJson структура описания видеоконтента на метавитрине Салют ТВ
Данная документация описывает структуру данных для передачи информации о видеоконтенте, которая используется для формирования метавитрины контента на всех поверхностях Салют ТВ. Наполнение полей по каждой единице каталога влияют на его доступность на устройствах пользователей. Важным фактором является соблюдение требований по формату и обязательности заполнения полей, так как это влияет на визуальное отображение в метавитринах и каталоге контента.
Изменения с прошлой версии
- Добавлены требования к размеру и формату изображений
- Обновлен справочник доступных жанров контента
- Поля audioTracks и qualities стали необязательными
Принцип формирования и доставки данных
- Поставщик контента формирует статичную ссылку, на которой размещается выгрузка (фид). Файл выгрузки должен быть доступен по протоколу HTTPS на домене поставщика контента.
Пример ссылки на файл:
https://yoursite.ru/feed.json. Content-Type=application/json; charset=utf-8.
Ссылка может быть защищена паролем.
- Для верификации источника фида SberDevices поддерживаются в том числе и white-листы, в таком случае понадобится статичный IP-адрес.
SberDevices могут быть рассмотрены и иные технические особенности интеграции, для этого обсудите их с вашим контактным лицом в SberDevices.
- Производить обновление данных в файле выгрузки желательно не реже, чем один раз в сутки и не чаще, чем один раз в шесть часов.
При необходимости использования иных периодов обновления – обсудите это с вашим контактным лицом в SberDevices.
- Каждая единица контента задается отдельным объектом.
- Опции оплат задаются как массив в каждой единице контента.
- Сериальная матрица может отсутствовать.
- Если вами используются уникальные идентификаторы контента, сообщите об этом отдельно.
- При необходимости передавать новый тип контента необходимо согласовать добавление нового ТИПА, размещение в некорректных уже существующих типах контента запрещено.
- У единицы контента может быть указано несколько «жанров». Справочник доступных жанров приведен в комментарии к соответствующему полю.
- Маркировка возраста, эротики и порноконтента обязательна.
В случае отсутствия данных по полям помеченных в текущей документации как обязательные свяжитесь с вашим контактным лицом в SberDevices.
Полнота контента
- Ожидается, что поставщик предоставляет весь доступный контент, кроме UGC. Если имеющиеся типы не охватывают полноту каталога (например, спортивный контент), то свяжитесь с вашим контактным лицом в SberDevices для согласования добавления новых типов.
- Добавление UGC контента в фид имеет смысл при условии, что его использование запланировано совместно. Любые детали всегда можно уточнить у контактного лица в SberDevices.
- В фиде могут быть переданы подборки контента, как отдельный объект данных, их промо размещение (формат, срок, состав, стоимость и т.д.) согласуется отдельно через менеджера SberDevices.
- Если планируется отправка промоподборок и их обновление силами собственных контент-менеджеров, то возможно создание отдельных галерей контента с уникальными идентификаторами, которые далее необходимо сообщить менеджеру SberDevices.
Требования к размеру и формату изображений
Название | Формат | Размер, px |
Горизонтальные изображения covers | .webp | 640 х 360 |
Квадратные виджеты (square_small_type) | .webp | 640 х 640 |
Вертикальные изображения covers | .webp | 640 х 960 |
Фоновое изображение для карточки контента без логотипа/названия фильма/сериала thumbnails | .webp | 1920 х 1080 |
Изображение с названием/логотипом фильма/сериала titleImage | .png/.webp (с прозрачным фоном) | Максимальные размеры контейнера для изображения: |
Примеры использования изображений


Описание SberJson
Общая схема
- Пример
- Описание
{
"provider": "videoprovider",
"version": "string",
"contents": [
{
"contentId": "string",
"type": "string",
"title": "string",
"customLabels": [
"string"
],
"originalTitle": [],
"tagline": "string",
"description": "string",
"year": 2010,
"created": "2024-01-30T21:00:00Z\n",
"duration": 1673598990054,
"covers": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": [
{
"link": "/imageid=215",
"resolution": "640x360"
}
],
"thumbnails": [
{
"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"keyNumber": "string",
"cards": [
{
"sequence": 0,
"id": "string"
}
],
"links": [
{
"type": "string",
"value": "string"
}
],
"trailers": [
"https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4"
],
"streamPreview": "string",
"actors": [
"string"
],
"directors": [
"string"
],
"creators": [
{
"creatorTitle": "string",
"creatorType": "string",
"deepLink": "string",
"icon": "string"
}
],
"cameramen": [
"string"
],
"producers": [
"string"
],
"artists": [
"string"
],
"composers": [
"string"
],
"screenwriters": [
"string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [
{
"provider": "string",
"value": "8.7"
}
],
"specialContentTag": [
"string"
],
"countries": [
"RUS"
],
"genres": [
"string"
],
"similar": [
"string"
],
"ageRestrictions": "string",
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [
{
"name": "string",
"value": "string"
}
],
"qualities": [
{
"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [
{
"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": [
"string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 - сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [
{
"seasonSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [
{
"episodeSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"links": "string"
}
],
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}
- 2.03
- 2.02
- 2.01
Array [
- MOVIE
- SERIES,
- TVSHOW
- GALLERY
- UGC
- TVCHANNEL
Array [
]
Array [
]
Array [
- H - Horizontal
- V - Vertical
]
Array [
]
Array [
- WEB
- ANDROID
]
Array [
- Тип автора
- Пользователь
- Группа
]
Array [
- "imdb"
- "kinopoisk"
- "Ivi"
- "mgg"
- "okko"
- "afisha
- "imdb" - 10 максимальное значение
- "kinopoisk" - 10 максимальное значение
- "okko" - 5 максимальное значение
]
- Аниме
- Артхаус
- Биографии
- Боевики
- Вестерны
- Военные
- Детективы
- Для взрослых
- Документальные
- Драмы
- Игровые-шоу
- Исторические
- Комедии
- Концерты
- Короткометражки
- Криминал
- Мелодрамы
- Мистические
- Музыкальные
- Мультфильмы
- Мюзиклы
- Нуар
- Приключения
- Развивающие
- Реалити
- Семейные
- Спорт
- Ток-шоу
- Триллеры
- Ужасы
- Фантастика
- Фэнтези
- Церемонии
Если жанра нет в списке, то можно передавать как есть, но это может влиять на доступность контента в каталоге поиска. Array [
- H - Horizontal Горизонтальный)
- V - Vertical (вертикальный)
]
Array [
- "imdb_id"
- "kinopoisk_id"
]
Array [
]
Array [
]
- Язык субтитров в формате ISO 639-2 альфа-3
- Обязательно для поддержки в API, но проперти у части контента могут быть пустыми.
- Если у контента нет субтитров - указываем
no_subtitle
. Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est" - Покупает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est" - Покупает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- H - Horizontal Горизонтальный)
- V - Vertical (вертикальный)
]
]
]
]
Название поставщика
Версия фида:
contents
object[]
required
Идентификатор контента
Возможные значения:
Название
Любой список тегов или лейблов, относящихся к данному уровню контента
Оригинальное название
Слоган
Описание контента
Если значение не пустое, то применяются валидационные правила
Год премьеры в мире
Дата загрузки контента
Длительность контента в миллисекундах
Для сериала это средняя продолжительность эпизода
covers
object[]
required
Массив изображений (каверов), содержащих название фильма
обязателен в H - горизонтальной ориентации, но желательно иметь обе ориентации
Ссылка на кавер
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация кавера:
H - Horizontal
V - Vertical
titleImage
object[]
required
Изображение с логотипом/названием контента
Разрешение изображения
thumbnails
object[]
required
Изображение без названия контента используется для фона (обязательно в H - горизонтальной ориентации)
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация изображенияH:
краткое описание до 119 символов
Номер канала
cards
object[]
required
Массив для передачи контента галлереи
Последовательность элементов галлереи
ИД контента
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
Ссылка на трейлер
Ссылка на превью видео
(Обычно используется для показа ключевых моментов при фокусе на тайтл, формат на усмотрение поставщика)
Массив актеров
Массив режисcеров
creators
object[]
required
Создатель контента
Имя автора контента
Ссылка на автора
Ссылка на аватарку автора
Массив операторов
Массив продюсеров
Массив художников
Массив композиторов
Массив сценаристов
Количество лайков
Количество просмотров
Количество комментариев
ratings
object[]
required
Информация о рейтингах контента
Обязательно для эксклюзивного контента:
Значение рейтинга
Валидация значений:
Специальный теги для разметки контента. Список возможных тегов согласовывается отдельно для каждого провайдера.
Поле необходимо использовать для пометки треш контента, порно или иного контента, требующего отдельную бизнес логику.
Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3
Массив с жанрами контента по справочнику:
Массив для перечисления идентификаторов похожего контента
Возрастные ограничения по стандарту RARS:[ 16+, 12+, 0+, 18+, 6+ ]
screenshots
object[]
required
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
externalIds
object[]
required
Идентификаторы контента во внешних каталогах.
Желательно иметь kinopoisk_id это облегчает мэтчинг каталога контента.
Название внешних каталогов:
Идентификатор контента в каталоге
qualities
object[]
required
Доступные разрешения видео (стримов)
Название разрешения
Значения поля нужно описывать от наименьшего к наивысшему качеству (от 1 до n).
У каждого контента это независимо.
audioTracks
object[]
required
Параметры аудиодорожек
Студия озвучки
Язык аудиодорожки в формате ISO 639-2 альфа-3
Качество аудиодорожки
Массив языков субтитров
Доступность контента. По умолчанию присваиваем true
Дата начала доступности контента.
Когда поле заполнено и дата наступила, делает контент доступным (игнорирует значение поля availability
)
Дата окончания доступности контента.
Когда поле заполнено и дата наступила, делает контент недоступным (игнорирует значение поля availability
и значение поля availabilityStartDate
).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не буде
purchaseOptions
object[]
required
Массив с опциями покупки
Идентификатор опциии оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
seriesStruct
object[]
required
Массив для объектов сериальной матрицы
Порядковый номер сезона
Название сезона
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на сезон сериала
Длительность контента в формате unix timestamp в миллисекундах
Доступность сезона сериала.
Используется, чтобы указать недоступность отдельного сезона в сериале.
Если для сериала в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
purchaseOptions
object[]
required
Массив для объектов с опциями оплаты сезона.
По умолчанию на сезон распространяются опции оплаты сериала.
При указании опции оплаты для сезона, на сезон перестают распространяться опции оплаты сериала.
В случае, когда надо дополнить опции оплаты сезона опциями сериала, необходимо продублировать опции оплаты сериала в данном объекте.
Идентификатор опции оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
episodes
object[]
required
Массив объектов эпизодов
Порядковый номер эпизода
Название эпизода
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
screenshots
object[]
required
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
Длительность контента в формате unix timestamp в миллисекундах
Доступность контента
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Пример формирования элемента MOVIE
- Пример
- Описание
{
"provider": "videoprovider",
"version": "string",
"contents": [
{
"contentId": "string",
"type": "string",
"title": "string",
"customLabels": [
"string"
],
"originalTitle": [],
"tagline": "string",
"description": "string",
"year": 2010,
"duration": "1673598990054",
"covers": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {
"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [
{
"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [
{
"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"actors": [
"string"
],
"directors": [
"string"
],
"cameramen": [
"string"
],
"producers": [
"string"
],
"artists": [
"string"
],
"composers": [
"string"
],
"screenwriters": [
"string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [
{
"provider": "string",
"value": "8.7"
}
],
"specialContentTag": [
"string"
],
"countries": [
"RUS"
],
"genres": [
"string"
],
"similar": [
"string"
],
"ageRestrictions": "string",
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [
{
"name": "string",
"value": "string"
}
],
"qualities": [
{
"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [
{
"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": [
"string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 - сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [
{
"seasonSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [
{
"episodeSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"links": "string"
}
],
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}
- 2.03
- 2.02
- 2.01
Array [
- MOVIE
- SERIES,
- TVSHOW
- GALLERY
- UGC
- TVCHANNEL
Array [
]
Array [
- H - Horizontal
- V - Vertical
]
Array [
- WEB
- ANDROID
]
Array [
- "imdb"
- "kinopoisk"
- "Ivi"
- "mgg"
- "okko"
- "afisha
- "imdb" - 10 максимальное значение
- "kinopoisk" - 10 максимальное значение
- "okko" - 5 максимальное значение
]
- Аниме
- Артхаус
- Биографии
- Боевики
- Вестерны
- Военные
- Детективы
- Для взрослых
- Документальные
- Драмы
- Игровые-шоу
- Исторические
- Комедии
- Концерты
- Короткометражки
- Криминал
- Мелодрамы
- Мистические
- Музыкальные
- Мультфильмы
- Мюзиклы
- Нуар
- Приключения
- Развивающие
- Реалити
- Семейные
- Спорт
- Ток-шоу
- Триллеры
- Ужасы
- Фантастика
- Фэнтези
- Церемонии
Если жанра нет в списке, то можно передавать как есть, но это может влиять на доступность контента в каталоге поиска. Array [
- H - Horizontal Горизонтальный)
- V - Vertical (вертикальный)
]
Array [
- "imdb_id"
- "kinopoisk_id"
]
Array [
]
Array [
]
- Язык субтитров в формате ISO 639-2 альфа-3
- Обязательно для поддержки в API, но проперти у части контента могут быть пустыми.
- Если у контента нет субтитров - указываем "no_subtitle".
Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est" - покупает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est" - Покидает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- H - Horizontal Горизонтальный)
- V - Vertical (вертикальный)
]
]
]
]
Название поставщика
Версия фида:
contents
object[]
required
Идентификатор контента
Возможные значения:
Название
Любой список тегов или лейблов, относящихся к данному уровню контента
Оригинальное название
Слоган
Описание контента
Если значение не пустое, то применяются валидационные правила
Год премьеры в мире
Длительность контента в миллисекундах
Для сериала это средняя продолжительность эпизода
covers
object[]
required
Массив изображений (каверов), содержащих название фильма
обязателен в H - горизонтальной ориентации, но желательно иметь обе ориентации
Ссылка на кавер
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация кавера:
H - Horizontal
V - Vertical
titleImage
object
required
Изображение с логотипом/названием контента
Разрешение изображения
thumbnails
object[]
required
Изображение без названия контента используется для фона (обязательно в H - горизонтальной ориентации)
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация изображенияH:
краткое описание до 119 символов
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
Ссылка на трейлер
Ссылка на превью видео
(Обычно используется для показа ключевых моментов при фокусе на тайтл, формат на усмотрение поставщика)
Массив актеров
Массив режисcеров
Массив операторов
Массив продюсеров
Массив художников
Массив композиторов
Массив сценаристов
Количество лайков
Количество просмотров
Количество комментариев
ratings
object[]
Информация о рейтингах контента
Обязательно для эксклюзивного контента:
Значение рейтинга
Валидация значений:
Специальный теги для разметки контента. Список возможных тегов согласовывается отдельно для каждого провайдера.
Поле необходимо использовать для пометки треш контента, порно или иного контента, требующего отдельную бизнес логику.
Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3
Массив с жанрами контента по справочнику:
Массив для перечисле ния идентификаторов похожего контента
Возрастные ограничения по стандарту RARS:[ 16+, 12+, 0+, 18+, 6+ ]
screenshots
object[]
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
externalIds
object[]
Идентификаторы контента во внешних каталогах.
Желательно иметь kinopoisk_id это облегчает мэтчинг каталога контента.
Название внешних каталогов:
Идентификатор контента в каталоге
qualities
object[]
Доступные разрешения видео (стримов)
Название разрешения
Значения поля нужно описывать от наименьшего к наивысшему качеству(от 1 до n). У каждого контента это независимо.
audioTracks
object[]
Параметры аудиодорожек
Студия озвучки
Язык аудиодорожки в формате ISO 639-2 альфа-3
Качество аудиодорожки
Массив языков субтитров
Доступность контента. По умолчанию присваиваем true
Дата начала доступности контента.
Когда поле заполнено и дата наступила, делает контент доступным (игнорирует значение поля availability
)
Дата окончания доступности контента.
Когда поле заполнено и дата наступила, делает контент недоступным (игнорирует значение поля availability
и значение поля availabilityStartDate
).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не буде
purchaseOptions
object[]
required
Массив с опциями покупки
Идентификатор опциии оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
seriesStruct
object[]
Массив для объектов сериальной матрицы
Порядковый номер сезона
Название сезона
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
Ссылки на контент
Тип ссылки:
Ссылка на сезон сериала
Длительность контента в формате unix timestamp в миллисекундах
Доступность сезона сериала.
Используется, чтобы указать недоступность отдельного сезона в сериале.
Если для сериала в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
purchaseOptions
object[]
Массив для объектов с опциями оплаты сезона.
По умолчанию на сезон распространяются опции оплаты сериала.
При указании опции оплаты для сезона, на сезон перестают распространяться опции оплаты сериала.
В случае, когда надо дополнить опции оплаты сезона опциями сериала, необходимо продублировать опции оплаты сер иала в данном объекте.
Идентификатор опции оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
episodes
object[]
Массив объектов эпизодов
Порядковый номер эпизода
Название эпизода
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
Ссылки на контент
Тип ссылки:
Ссылка на контент
screenshots
object[]
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
Длительность контента в формате unix timestamp в миллисекундах
Доступность контента
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Пример формирования элемента SERIES
- Пример
- Описание
{
"provider": "videoprovider",
"version": "string",
"contents": [
{
"contentId": "string",
"type": "string",
"title": "string",
"customLabels": [
"string"
],
"originalTitle": [],
"tagline": "string",
"description": "string",
"year": 2010,
"duration": "1673598990054",
"covers": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {
"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [
{
"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [
{
"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"actors": [
"string"
],
"directors": [
"string"
],
"cameramen": [
"string"
],
"producers": [
"string"
],
"artists": [
"string"
],
"composers": [
"string"
],
"screenwriters": [
"string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [
{
"provider": "string",
"value": "8.7"
}
],
"specialContentTag": [
"string"
],
"countries": [
"RUS"
],
"genres": [
"string"
],
"similar": [
"string"
],
"ageRestrictions": "string",
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [
{
"name": "string",
"value": "string"
}
],
"qualities": [
{
"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [
{
"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": [
"string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 - сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [
{
"seasonSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [
{
"episodeSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"links": "string"
}
],
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}
- 2.03
- 2.02
- 2.01
Array [
- MOVIE
- SERIES,
- TVSHOW
- GALLERY
- UGC
- TVCHANNEL
Array [
]
Array [
- H - Horizontal
- V - Vertical
]
Array [
- WEB
- ANDROID
]
Array [
- "imdb"
- "kinopoisk"
- "Ivi"
- "mgg"
- "okko"
- "afisha
- "imdb" - 10 максимальное значение
- "kinopoisk" - 10 максимальное значение
- "okko" - 5 максимальное значение
]
- Аниме
- Артхаус
- Биографии
- Боевики
- Вестерны
- Военные
- Детективы
- Для взрослых
- Документальные
- Драмы
- Игровые-шоу
- Исторические
- Комедии
- Концерты
- Короткометражки
- Криминал
- Мелодрамы
- Мистические
- Музыкальные
- Мультфильмы
- Мюзиклы
- Нуар
- Приключения
- Развивающие
- Реалити
- Семейные
- Спорт
- Ток-шоу
- Триллеры
- Ужасы
- Фантастика
- Фэнтези
- Церемонии
Если жанра нет в списке, то можно передавать как есть, но это может влиять на доступность контента в каталоге поиска. Array [
- H - Horizontal Горизонтальный)
- V - Vertical (вертикальный)
]
Array [
- "imdb_id"
- "kinopoisk_id"
]
Array [
]
Array [
]
- Язык субтитров в формате ISO 639-2 альфа-3
- Обязательно для поддержки в API, но проперти у части контента могут быть пустыми.
- Если у контента нет субтитров - указываем
no_subtitle
. Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est" - покупает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est" - Покупает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- H - Horizontal Горизонтальный)
- V - Vertical (вертикальный)
]
]
]
]
Название поставщика
Версия фида:
contents
object[]
required
Идентификатор контента
Возможные значения:
Название
Любой список тегов или лейблов, относящихся к данному уровню контента
Оригинальное название
Слоган
Описание контента
Если значение не пустое, то применяются валидационные правила
Год премьеры в мире
Длительность контента в миллисекундах
Для сериала это средняя продолжительность эпизода
covers
object[]
required
Массив изображений (каверов), содержащих название фильма
обязателен в H - горизонтальной ориентации, но желательно иметь обе ориентации
Ссылка на кавер
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация кавера:
H - Horizontal
V - Vertical
titleImage
object
required
Изображение с логотипом/названием контента
Разрешение изображения
thumbnails
object[]
required
Изображение без названия контента используется для фона (обязательно в H - горизонтальной ориентации)
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация изображенияH:
краткое описание до 119 символов
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
Ссылка на трейлер
Ссылка на превью видео
(Обычно используется для показа ключевых момент ов при фокусе на тайтл, формат на усмотрение поставщика)
Массив актеров
Массив режисcеров
Массив операторов
Массив продюсеров
Массив художников
Массив композиторов
Массив сценаристов
Количество лайков
Количество просмотров
Количество комментариев
ratings
object[]
Информация о рейтингах контента
Обязательно для эксклюзивного контента:
Значение рейтинга
Валидация значений:
Специальный теги для разметки контента. Список возможных тегов согласовывается отдельно для каждого провайдера.
Поле необходимо использовать для пометки треш контента, порно или иного контента, требующего отдельную бизнес логику.
Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3
Массив с жанрами контента по справочнику:
Массив для перечисления идентификаторов похожего контента
Возрастные ограничения по стандарту RARS:[ 16+, 12+, 0+, 18+, 6+ ]
screenshots
object[]
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
externalIds
object[]
Идентификаторы контента во внешних каталогах.
Желательно иметь kinopoisk_id это облегчает мэтчинг каталога контента.
Название внешних каталогов:
Идентификатор контента в каталоге
qualities
object[]
Доступные разрешения видео (стримов)
Название разрешения
Значения поля нужно описывать от наименьшего к наивысшему качеству(от 1 до n). У каждого контента это независимо.
audioTracks
object[]
Параметры аудиодорожек
Студия озвучки
Язык аудиодорожки в формате ISO 639-2 альфа-3
Качество аудиодорожки
Массив языков субтитров
Доступность контента. По умолчанию присваиваем true
Дата начала доступности контента.
Когда поле заполнено и дата наступила, делает контент доступным (игнорирует значение поля availability
)
Дата окончания доступности контента.
Когда поле заполнено и дата наступила, делает контент недоступным (игнорирует значение поля availability
и значение поля availabilityStartDate
).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не буде
purchaseOptions
object[]
required
Массив с опциями покупки
Идентификатор опциии оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
seriesStruct
object[]
required
Массив для объектов сериальной матрицы
Порядковый номер сезона
Название сезона
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
Ссылки на контент
Тип ссылки:
Ссылка на сезон сериала
Длительность контента в формате unix timestamp в миллисекундах
Доступность сезона сериала.
Используется, чтобы указать недоступность отдельного сезона в сериале.
Если для сериала в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
purchaseOptions
object[]
Массив для объектов с опциями оплаты сезона.
По умолчанию на сезон распространяются опции оплаты сериала.
При указании опции оплаты для сезона, на сезон перестают распространяться опции оплаты сериала.
В случае, когда надо дополнить опции оплаты сезона опциями сериала, необходимо продублировать опции оплаты сериала в данном объекте.
Идентификатор опции оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
episodes
object[]
Массив объектов эпизодов
Порядковый номер эпизода
Название эпизода
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
screenshots
object[]
required
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
Длительность контента в формате unix timestamp в миллисекундах
Доступность контента
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Пример формирования элемента TVCHANNEL
- Пример
- Описание
{
"provider": "videoprovider",
"version": "string",
"contents": [
{
"contentId": "string",
"type": "string",
"title": "string",
"customLabels": [
"string"
],
"originalTitle": [],
"description": "string",
"covers": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {
"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [
{
"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"keyNumber": "string",
"cards": [
{
"sequence": 0,
"id": "string"
}
],
"links": [
{
"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"ratings": [
{
"provider": "string",
"value": "8.7"
}
],
"specialContentTag": [
"string"
],
"countries": [
"RUS"
],
"genres": [
"string"
],
"similar": [
"string"
],
"ageRestrictions": "string",
"externalIds": [
{
"name": "string",
"value": "string"
}
],
"qualities": [
{
"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 - сохранится как 399",
"currency": "rub"
}
]
}
]
}
- 2.03
- 2.02
- 2.01
Array [
- MOVIE
- SERIES,
- TVSHOW
- GALLERY
- UGC
- TVCHANNEL
Array [
]
Array [
- H - Horizontal
- V - Vertical
]
Array [
]
Array [
- WEB
- ANDROID
]
Array [
- "imdb"
- "kinopoisk"
- "Ivi"
- "mgg"
- "okko"
- "afisha
- "imdb" - 10 максимальное значение
- "kinopoisk" - 10 максимальное значение
- "okko" - 5 максимальное значение
]
- Аниме
- Артхаус
- Биографии
- Боевики
- Вестерны
- Военные
- Детективы
- Для взрослых
- Документальные
- Драмы
- Игровые-шоу
- Исторические
- Комедии
- Концерты
- Короткометражки
- Криминал
- Мелодрамы
- Мистические
- Музыкальные
- Мультфильмы
- Мюзиклы
- Нуар
- Приключения
- Развивающие
- Реалити
- Семейные
- Спорт
- Ток-шоу
- Триллеры
- Ужасы
- Фантастика
- Фэнтези
- Церемонии
Если жанра нет в списке, то можно передавать как есть, но это может влиять на доступность контента в каталоге поиска. Array [
- "imdb_id"
- "kinopoisk_id"
]
Array [
]
Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est" - покупает единицу контента
]
]
Название поставщика
Версия фида:
contents
object[]
required
Идентификатор контента
Возможные значения:
Название
Любой список тегов или лейблов, относящихся к данному уровню контента
Оригинальное название
Описание контента
Если значение не пустое, то применяются валидационные правила.
covers
object[]
required
Массив изображений (каверов), содержащих название фильма
обязателен в H - горизонтальной ориентации, но желательно иметь обе ориентации
Ссылка на кавер
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация кавера:
H - Horizontal
V - Vertical
titleImage
object
Изображение с логотипом/названием контента
Разрешение изображения
thumbnails
object[]
Изображение без названия контента используется для фона (обязательно в H - горизонтальной ориентации)
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация изображенияH:
краткое описание до 119 символов
Номер канала
cards
object[]
Массив для передачи контента галлереи
Последовательность элементов галлереи
ИД контента
links
object[]
Ссылки на контент
Тип ссылки:
Ссылка на контент
Ссылка на трейлер
Ссылка на превью видео
(Обычно используется для показа ключевых моментов при ф окусе на тайтл, формат на усмотрение поставщика)
deepLink:
type: string
description: Ссылка на автора
icon:
type: string
description: Ссылка на аватарку автора
ratings
object[]
Информация о рейтингах контента
Обязательно для эксклюзивного контента:
Значение рейтинга
Валидация значений:
Специальный теги для разметки контента. Список возможных тегов согласовывается отдельно для каждого провайдера.
Поле необходимо использовать для пометки треш контента, порно или иного контента, требующе го отдельную бизнес логику.
Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3
Массив с жанрами контента по справочнику:
Массив для перечисления идентификаторов похожего контента
Возрастные ограничения по стандарту RARS:[ 16+, 12+, 0+, 18+, 6+ ]
externalIds
object[]
Идентификаторы контента во внешних каталогах.
Желательно иметь kinopoisk_id это облегчает мэтчинг каталога контента.
Название внешних каталогов:
Идентификатор контента в каталоге
qualities
object[]
required
Доступные разрешения видео (стримов)
Название разрешения
Значения поля нужно описывать от наименьшего к наивысшему качеству(от 1 до n). У каждого контента это независимо.
Доступность контента. По умолчанию присваиваем true
Дата начала доступности контента.
Когда поле заполнено и дата наступила, делает контент доступным (игнорирует значение поля availability
)
Дата окончания доступности контента.
Когда поле заполнено и дата наступила, делает контент недоступным (игнорирует значение поля availability
и значение поля availabilityStartDate
).
Если для се риала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не буде
purchaseOptions
object[]
required
Массив с опциями покупки
Идентификатор опциии оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
Пример формирования элемента TVSHOW
- Пример
- Описание
{
"provider": "videoprovider",
"version": "string",
"contents": [
{
"contentId": "string",
"type": "string",
"title": "string",
"customLabels": [
"string"
],
"originalTitle": [],
"tagline": "string",
"description": "string",
"year": 2010,
"duration": "1673598990054",
"covers": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {
"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [
{
"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [
{
"type": "string",
"value": "string"
}
],
"trailers": "https://cdn.videoprovider.ru/data/storage/trailers/7f9d0b57-b490-4067-bd18-4ba252ae4910.mp4",
"streamPreview": "string",
"actors": [
"string"
],
"directors": [
"string"
],
"cameramen": [
"string"
],
"producers": [
"string"
],
"artists": [
"string"
],
"composers": [
"string"
],
"screenwriters": [
"string"
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"ratings": [
{
"provider": "string",
"value": "8.7"
}
],
"specialContentTag": [
"string"
],
"countries": [
"RUS"
],
"genres": [
"string"
],
"similar": [
"string"
],
"ageRestrictions": "string",
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"externalIds": [
{
"name": "string",
"value": "string"
}
],
"qualities": [
{
"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [
{
"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": [
"string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 - сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [
{
"seasonSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [
{
"episodeSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"links": "string"
}
],
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}
- 2.03
- 2.02
- 2.01
Array [
- MOVIE
- SERIES,
- TVSHOW
- GALLERY
- UGC
- TVCHANNEL
Array [
]
Array [
- H - Horizontal
- V - Vertical
]
Array [
- WEB
- ANDROID
]
Array [
- "imdb"
- "kinopoisk"
- "Ivi"
- "mgg"
- "okko"
- "afisha
- "imdb" - 10 максимальное значение
- "kinopoisk" - 10 максимальное значение
- "okko" - 5 максимальное значение
]
- Аниме
- Артхаус
- Биографии
- Боевики
- Вестерны
- Военные
- Детективы
- Для взрослых
- Документальные
- Драмы
- Игровые-шоу
- Исторические
- Комедии
- Концерты
- Короткометражки
- Криминал
- Мелодрамы
- Мистические
- Музыкальные
- Мультфильмы
- Мюзиклы
- Нуар
- Приключения
- Развивающие
- Реалити
- Семейные
- Спорт
- Ток-шоу
- Триллеры
- Ужасы
- Фантастика
- Фэнтези
- Церемонии
Если жанра нет в списке, то можно передавать как есть, но это может влиять на доступность контента в каталоге поиска. Array [
- H - Horizontal Горизонтальный)
- V - Vertical (вертикальный)
]
Array [
- "imdb_id"
- "kinopoisk_id"
]
Array [
]
Array [
]
- Язык субтитров в формате ISO 639-2 альфа-3
- Обязательно для поддержки в API, но проперти у части контента могут быть пустыми.
- Если у контента нет субтитров - указываем
no_subtitle
. Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est" - Покупает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est" - Покупает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- H - Horizontal Горизонтальный)
- V - Vertical (вертикальный)
]
]
]
]
Название поставщика
Версия фида:
contents
object[]
required
Идентификатор контента
Возможные значения:
Название
Любой список тегов или лейблов, относящихся к данному уровню контента
Оригинальное название
Слоган
Описание контента
Если значение не пустое, то применяются валидационные правила
Год премьеры в мире
Длительность контента в миллисекундах
Для сериала это средняя продолжительность эпизода
covers
object[]
required
Массив изображений (каверов), содержащих название фильма
обязателен в H - горизонтальной ориентации, но желательно иметь обе ориентации
Ссылка на кавер
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация кавера:
H - Horizontal
V - Vertical
titleImage
object
required
Изображение с логотипом/названием контента
Разрешение изображения
thumbnails
object[]
required
Изображение без названия контента используется для фона (обязательно в H - горизонтальной ориентации)
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация изображенияH:
краткое описание до 119 символов
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
Ссылка на трейлер
Ссылка на превью видео
(Обычно используется для показа ключевых момент ов при фокусе на тайтл, формат на усмотрение поставщика)
Массив актеров
Массив режисcеров
Массив операторов
Массив продюсеров
Массив художников
Массив композиторов
Массив сценаристов
Количество лайков
Количеств о просмотров
Количество комментариев
ratings
object[]
Информация о рейтингах контента
Обязательно для эксклюзивного контента:
Значение рейтинга
Валидация значений:
Специальный теги для разметки контента. Список возможных тегов согласовывается отдельно для каждого провайдера.
Поле необходимо использовать для пометки треш контента, порно или иного контента, требующего отдельную бизнес логику.
Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3
Массив с жанрами контента по справочнику:
Массив для перечисления идентификаторов похожего контента
Возрастные ограничения по ста ндарту RARS:[ 16+, 12+, 0+, 18+, 6+ ]
screenshots
object[]
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
externalIds
object[]
Идентификаторы контента во внешних к аталогах.
Желательно иметь kinopoisk_id это облегчает мэтчинг каталога контента.
Название внешних каталогов:
Идентификатор контента в каталоге
qualities
object[]
Доступные разрешения видео (стримов)
Название разрешения
Значения поля нужно описывать от наименьшего к наивысшему качеству(от 1 до n).
У каждого контента это независимо.
audioTracks
object[]
Параметры аудиодорожек
Студия озвучки
Язык аудиодорожки в формате ISO 639-2 альфа-3
Качество аудиодорожки
Массив языков субтитров
Доступность контента. По умолчанию присваиваем true
Дата начала доступности контента.
Когда поле заполнено и дата наступила, делает контент доступным (игнорирует значение поля availability
)
Дата окончания доступности контента.
Когда поле заполнено и дата наступила, делает контент недоступным (игнорирует значение поля availability
и значение поля availabilityStartDate
).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не буде
purchaseOptions
object[]
required
Массив с опциями покупки
Идентификатор опциии оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
seriesStruct
object[]
Массив для объектов сериальной матрицы
Порядковый номер сезона
Название сезона
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
Ссылки на контент
Тип ссылки:
Ссылка на сезон сериала
Длительность контента в формате unix timestamp в миллисекундах
Доступность сезона сериала.
Используется, чтобы указать недоступность отдельного сезона в сериале.
Если для сериала в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
purchaseOptions
object[]
Массив для объектов с опциями оплаты сезона.
По умолчанию на сезон распространяются опции оплаты сериала.
При указании опции оплаты для сезона, на сезон перестают распространяться опции оплаты сериала.
В случае, когда надо дополнить опции оплаты сезона опциями сериала, необходимо продублировать опции оплаты сериала в данном объекте.
Идентификатор опции оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
episodes
object[]
required
Массив объектов эпизодов
Порядковый номер эпизода
Название эпизода
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
screenshots
object[]
required
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
Длительность контента в формате unix timestamp в миллисекундах
Доступность контента
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Пример формирования элемента UGC
- Пример
- Описание
{
"provider": "videoprovider",
"version": "string",
"contents": [
{
"contentId": "string",
"type": "string",
"title": "string",
"customLabels": [
"string"
],
"tagline": "string",
"description": "string",
"created": "2024-01-30T21:00:00Z",
"duration": 1673598990054,
"covers": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"titleImage": {
"link": "/imageid=215",
"resolution": "640x360"
},
"thumbnails": [
{
"link": "/imageid=217",
"resolution": "1920x1080",
"sequence": null,
"orientation": "string"
}
],
"shortDescription": "string",
"links": [
{
"type": "string",
"value": "string"
}
],
"streamPreview": "string",
"creators": [
{
"creatorTitle": "string",
"creatorType": "string",
"deepLink": "string",
"icon": "string"
}
],
"likedCount": 0,
"watchedCount": 0,
"commentCount": 0,
"specialContentTag": [
"string"
],
"countries": [
"RUS"
],
"genres": [
"string"
],
"similar": [
"string"
],
"ageRestrictions": "string",
"externalIds": [
{
"name": "string",
"value": "string"
}
],
"qualities": [
{
"value": "Full HD",
"sequence": "SD=1 HD=2"
}
],
"audioTracks": [
{
"studio": "string",
"language": "string",
"quality": "160kbps"
}
],
"subtitleLanguages": [
"string"
],
"availability": true,
"availabilityStartDate": "2026-03-14T21:00:00Z",
"availabilityEndDate": "2026-03-14T23:59:00Z",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При цене 39999 - сохранится как 399",
"currency": "rub"
}
],
"seriesStruct": [
{
"seasonSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"value": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "yyyy-MM-dd'T'HH:mm:ssX",
"availabilityEndDate": "yyyy-MM-dd'T'HH:mm:ssX",
"purchaseOptions": [
{
"id": "string",
"title": "string",
"consumptionMode": "string",
"qualities": "FHD",
"price": "При указании цены 39999 будет сохранена как 399",
"currency": "rub"
}
],
"episodes": [
{
"episodeSeq": 0,
"title": "string",
"customLabels": [
"string"
],
"links": [
{
"type": "string",
"links": "string"
}
],
"screenshots": [
{
"link": "/imageid=213",
"resolution": "640x360",
"sequence": 0,
"orientation": "string"
}
],
"duration": "1673598990054",
"availability": true,
"availabilityStartDate": "string",
"availabilityEndDate": "string"
}
]
}
]
}
]
}
- 2.03
- 2.02
- 2.01
Array [
- MOVIE
- SERIES,
- TVSHOW
- GALLERY
- UGC
- TVCHANNEL
Array [
]
Array [
- H - Horizontal
- V - Vertical
]
Array [
- WEB
- ANDROID
]
Array [
- Тип автора
- Пользователь
- Группа
]
- Аниме
- Артхаус
- Биографии
- Боевики
- Вестерны
- Военные
- Детективы
- Для взрослых
- Документальные
- Драмы
- Игровые-шоу
- Исторические
- Комедии
- Концерты
- Короткометражки
- Криминал
- Мелодрамы
- Мистические
- Музыкальные
- Мультфильмы
- Мюзиклы
- Нуар
- Приключения
- Развивающие
- Реалити
- Семейные
- Спорт
- Ток-шоу
- Триллеры
- Ужасы
- Фантастика
- Фэнтези
- Церемонии
Если жанра нет в списке, то можно передавать как есть, но это может влиять на доступность контента в каталоге поиска. Array [
- "imdb_id"
- "kinopoisk_id"
]
Array [
]
Array [
]
- Язык субтитров в формате ISO 639-2 альфа-3
- Обязательно для поддержки в API, но проперти у части контента могут быть пустыми.
- Если у контента нет субтитров - указываем "no_subtitle".
Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est" - покупает единицу контента
]
Array [
Array [
- web
- android
]
Array [
- "svod" - Контент доступен по подписке
- "tvod" - Покупка или аренда контента
- "fvod" - Бесплатный контент
- "avod" - Контент за рекламу
- "est"
]
Array [
Array [
- web
- android
]
Array [
- H - Horizontal Горизонтальный)
- V - Vertical (вертикальный)
]
]
]
]
Название поставщика
Версия фида:
contents
object[]
required
Идентификатор контента
Возможные значения:
Название
Любой список тегов или лейблов, относящихся к данному уровню контента
Слоган
Описание контента
Если значение не пустое, то применяются валидацион ные правила
Дата загрузки контента
Длительность контента в миллисекундах
Для сериала это средняя продолжительность эпизода
covers
object[]
required
Массив изображений (каверов), содержащих название фильма
обязателен в H - горизонтальной ориентации, но желательно иметь обе ориентации
Ссылка на кавер
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация кавера:
H - Horizontal
V - Vertical
titleImage
object
Изображение с логотипом/названием контента
Разрешение изображения
thumbnails
object[]
Изображение без названия контента используется для фона (обязательно в H - горизонтальной ориентации)
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация изображенияH:
краткое описание до 119 символов
links
object[]
required
Ссылки на контент
Тип ссылки:
Ссылка на контент
Ссылка на превью видео
(Обычно используется для показа ключевых моментов при фокусе на тайтл, формат на усмотрение поставщика)
creators
object[]
required
Создатель контента
Имя автора контента
Ссылка на автора
Ссылка на аватарку автора
Количество лайков
Количество просмотров
Количество комментариев
Специальный теги для разметки контента. Список возможных тегов согласовывается отдельно для каждого провайдера.
Поле необходимо использовать для пометки треш контента, порно или иного контента, требующего отдельную бизнес логику.
Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3
Массив с жанрами контента по справочнику:
Массив для перечисления идентификаторов похожего контента
Возрастные ограничения по стандарту RARS:[ 16+, 12+, 0+, 18+, 6+ ]
externalIds
object[]
Идентификаторы контента во внешних каталогах.
Желательно иметь kinopoisk_id это облегчает мэтчинг каталога контента.
Название внешних каталогов:
Идентификатор контента в каталоге
qualities
object[]
Доступные разрешения видео (стримов)
Название разрешения
Значения поля нужно описывать от наименьшего к наивысшему качеству(от 1 до n). У каждого контента это независимо.
audioTracks
object[]
Параметры аудиодорожек
Студия озвучки
Язык аудиодорожки в формате ISO 639-2 альфа-3
Качество аудиодорожки
Массив языков субтитров
Доступность контента. По умолчанию присваиваем true
Дата начала доступности контент а.
Когда поле заполнено и дата наступила, делает контент доступным (игнорирует значение поля availability
)
Дата окончания доступности контента.
Когда поле заполнено и дата наступила, делает контент недоступным (игнорирует значение поля availability
и значение поля availabilityStartDate
).
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не буде
purchaseOptions
object[]
Массив с опциями покупки
Идентификатор опциии оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
seriesStruct
object[]
Массив для объектов сериальной матрицы
Порядковый номер сезона
Название сезона
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
Ссылки на контент
Тип ссылки:
Ссылка на сезон сериала
Длительность контента в формате unix timestamp в миллисекундах
Доступность сезона сериала.
Используется, чтобы указать недоступность отдельного сезона в сериале.
Если для сериала в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
purchaseOptions
object[]
Массив для объектов с опциями оплаты сезона.
По умолчанию на сезон распространяются опции оплаты сериала.
При указании опции оплаты для сезона, на сезон перестают распространяться опции оплаты сериала.
В случае, когда надо дополнить опции оплаты сезона опциями сериала, необходимо продублировать опции оплаты сериала в данном объекте.
Идентификатор опции оплаты
Название опции оплаты
Способ потребления:
Массив качеств контента на которые распространяется предложение
Стоимость до копеек
Код валюты по стандарту ISO 4217 альфа-3
episodes
object[]
Массив объектов эпизодов
Порядковый номер эпизода
Название эпизода
Любой список тегов или лейблов, относящихся к данному уровню контента
links
object[]
Ссылки на контент
Тип ссылки:
Ссылка на контент
screenshots
object[]
Массив скриншотов
Ссылка на скриншот
Разрешение изображения
Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.
Ориентация скриншотов:
Длительность контента в формате unix timestamp в миллисекундах
Доступность контента
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля учитываться не будет.
Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability
игнорируется)
Если для сериала или сезона в параметре availability
стоит знач ение false
, значение данного поля не учитывается.
Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability
и availabilityStartDate
игнорируется)
Если для сериала или сезона в параметре availability
стоит значение false
, значение данного поля не учитывается.
Пример формирования элемента GALLERY
- Пример
- Описание
{
"provider": "videoprovider",
"version": "string",
"contents": [
{
"contentId": "string",
"type": "string",
"title": "string",
"cards": [
{
"sequence": 0,
"id": "string"
}
]
}
]
}
- 2.03
- 2.02
- 2.01
Array [
- MOVIE
- SERIES,
- TVSHOW
- GALLERY
- UGC
- TVCHANNEL
Array [
]
]
Название поставщика
Версия фида:
contents
object[]
required
Идентификатор контента
Возможные значения:
Название
cards
object[]
required
Массив для передачи контента галлереи
Последовательность элементов галлереи
ИД контента
Как работать с датой релиза контента
-
Для управления доступностью контента рекомендуем использовать флаг
availability
, либо при недоступности возможно удаление контента из фида. Не желательно сохранять большое количество недоступных тайтлов в фиде, т.к. это приводит к увеличению размера файла и замедлению обновления каталога. -
Для контента, дата начала доступности которого известна, можно использовать поле
availabilityStartDate"
. При наступлении этой даты контент становится доступным (значение поляavailability
в таком случае игнорируется). -
Для контента, дата начала недоступности которого известна, можно использовать поле
availabilityEndDate
. При наступлении этой даты контент становится недоступным (значения полейavailability
иavailabilityStartDate
в этом случае игнорируются).
//
"availability" : false,
"availabilityStartDate": "2024-01-01T00:00:01Z",
"availabilityEndDate": "2026-01-01T23:59:59Z",
//
Контент будет доступен в период указанных дат:
availabilityStartDate
availabilityEndDate