Общая схема
- Пример
- Описание
{
"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 (uоризонтальный)
- V - Vertical (вертикальный)
]
]
]
]
Название поставщика
Версия фида:
contents
object[]
required
Идентификатор контента
Возможные значения:
Название
Любой список тегов или лейблов, относящихся к данному уровню контента
Оригинальное название
Слоган
Описание контента.
Если значение не пустое, то применяются валидационные правила
Год премьеры в мире
Дата загрузки контента
Длительность контента в миллисекундах.
Для сериала это средняя продолжительность эпизода
covers
object[]
required
Массив изображений (каверов), содержащих название фильма
обязателен в H — горизонтальной ориентации, но желательно иметь обе ориентации
Ссылка на кавер
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация кавера:
H — Horizontal
V — Vertical
titleImage
object[]
required
Изображение с логотипом/названием контента
Разрешение изображения
thumbnails
object[]
required
Изображение без названия контента используется для фона (обязательно в H — горизонтальной ориентации)
Разрешение изображения
Последовательность каверов (от 1 до n)
Ориентация изображения:
краткое описание до 119 символов
Номер канала
cards
object[]
required
Массив для передачи контента галереи
Последовательность элементов галереи
ID контента
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
, значение данного поля не учитывается