Пример формирования элемента UGC

Обновлено 7 августа 2025

{
  "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": null
        }
      ],
      "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",
                        "HD",
                        "SD"
                      ],
          "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",
                            "HD",
                            "SD"
                          ],
              "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"
            }
          ]
        }
      ]
    }
  ]
}

provider

string

required

Название поставщика

version

string

Версия фида:

• 2.03
• 2.02
• 2.01

contents object[]required

Array [

contentId

string

required

Идентификатор контента

type

string

required

Возможные значения:

• MOVIE
• SERIES,
• TVSHOW
• GALLERY
• UGC
• TVCHANNEL

title

string

required

Название

customLabels

string[]

Любой список тегов или лейблов, относящихся к данному уровню контента

tagline

string

Слоган

description

string

Описание контента
Если значение не пустое, то применяются валидационные правила

created

string

required

Дата загрузки контента

duration

number

required

Длительность контента в миллисекундах
Для сериала это средняя продолжительность эпизода

covers object[]required

Массив изображений (каверов), содержащих название фильма
обязателен в H - горизонтальной ориентации, но желательно иметь обе ориентации

Array [

link

string

required

Ссылка на кавер

resolution

string

Разрешение изображения

sequence

number

Последовательность каверов (от 1 до n)

orientation

string

required

Ориентация кавера:
H - Horizontal V - Vertical

]

titleImage object

Изображение с логотипом/названием контента

link

string

resolution

string

Разрешение изображения

thumbnails object[]

Изображение без названия контента используется для фона (обязательно в H - горизонтальной ориентации)

Array [

link

string

resolution

string

Разрешение изображения

sequence

number

Последовательность каверов (от 1 до n)

orientation

string

required

Ориентация изображенияH:

• H - Horizontal
• V - Vertical

]

shortDescription

string

краткое описание до 119 символов

links object[]required

Ссылки на контент

Array [

type

string

Тип ссылки:

• WEB
• ANDROID

value

string

Ссылка на контент

]

streamPreview

string

Ссылка на превью видео
(Обычно используется для показа ключевых моментов при фокусе на тайтл, формат на усмотрение поставщика)

creators object[]required

Создатель контента

Array [

creatorTitle

string

required

Имя автора контента

creatorType

string

required

• Тип автора
• Пользователь
• Группа

deepLink

string

required

Ссылка на автора

icon

string

required

Ссылка на аватарку автора

]

likedCount

number

Количество лайков

watchedCount

number

Количество просмотров

commentCount

number

Количество комментариев

specialContentTag

string[]

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

countries

string[]

Код страны производителя контента: по стандартам ISO 3166-1, ISO 3166-3 в формате Альфа-3

genres

string[]

Массив с жанрами контента по справочнику:

• Аниме
• Артхаус
• Биографии
• Боевики
• Вестерны
• Военные
• Детективы
• Для взрослых
• Документальные
• Драмы
• Игровые-шоу
• Исторические
• Комедии
• Концерты
• Короткометражки
• Криминал
• Мелодрамы
• Мистические
• Музыкальные
• Мультфильмы
• Мюзиклы
• Нуар
• Приключения
• Развивающие
• Реалити
• Семейные
• Спорт
• Ток-шоу
• Триллеры
• Ужасы
• Фантастика
• Фэнтези
• Церемонии
  Если жанра нет в списке, то можно передавать как есть, но это может влиять на доступность контента в каталоге поиска.

similar

string[]

Массив для перечисления идентификаторов похожего контента

ageRestrictions

string

Возрастные ограничения по стандарту RARS:[ 16+, 12+, 0+, 18+, 6+ ]

externalIds object[]

Идентификаторы контента во внешних каталогах.
Желательно иметь kinopoisk_id это облегчает мэтчинг каталога контента.

Array [

name

string

Название внешних каталогов:

• "imdb_id"
• "kinopoisk_id"

value

string

Идентификатор контента в каталоге

]

qualities object[]

Доступные разрешения видео (стримов)

Array [

value

string

Название разрешения

sequence

number

Значения поля нужно описывать от наименьшего к наивысшему качеству(от 1 до n). У каждого контента это независимо.

]

audioTracks object[]

Параметры аудиодорожек

Array [

studio

string

Студия озвучки

language

string

Язык аудиодорожки в формате ISO 639-2 альфа-3

quality

string

Качество аудиодорожки

]

subtitleLanguages

string[]

Массив языков субтитров

• Язык субтитров в формате ISO 639-2 альфа-3
• Обязательно для поддержки в API, но проперти у части контента могут быть пустыми.
• Если у контента нет субтитров - указываем "no_subtitle".

availability

boolean

Доступность контента. По умолчанию присваиваем true

availabilityStartDate

string

Дата начала доступности контента.
Когда поле заполнено и дата наступила, делает контент доступным (игнорирует значение поля availability)

availabilityEndDate

string

Дата окончания доступности контента.
Когда поле заполнено и дата наступила, делает контент недоступным (игнорирует значение поля availability и значение поля availabilityStartDate).
Если для сериала или сезона в параметре availability стоит значение false, значение данного поля учитываться не буде

purchaseOptions object[]

Массив с опциями покупки

Array [

id

string

Идентификатор опциии оплаты

title

string

Название опции оплаты

consumptionMode

string

Способ потребления:

• "svod" — контент доступен по подписке;
• "tvod" — аренда контента;
• "fvod" — бесплатный контент;
• "avod" — контент за рекламу;
• "est" — покупка контента.

qualities

string[]

Массив качеств контента, на которые распространяется предложение

price

integer

Стоимость до копеек

currency

string

Код валюты по стандарту ISO 4217 альфа-3

]

seriesStruct object[]

Массив для объектов сериальной матрицы

Array [

seasonSeq

number

Порядковый номер сезона

title

string

Название сезона

customLabels

string[]

Любой список тегов или лейблов, относящихся к данному уровню контента

links object[]

Ссылки на контент

Array [

type

string

Тип ссылки:

• web
• android

value

string

Ссылка на сезон сериала

]

duration

number

Длительность контента в формате unix timestamp в миллисекундах

availability

boolean

Доступность сезона сериала.
Используется, чтобы указать недоступность отдельного сезона в сериале.
Если для сериала в параметре availability стоит значение false, значение данного поля учитываться не будет.

availabilityStartDate

string

Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability игнорируется)
Если для сериала или сезона в параметре availability стоит значение false, значение данного поля не учитывается.

availabilityEndDate

string

Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability и availabilityStartDate игнорируется)
Если для сериала или сезона в параметре availability стоит значение false, значение данного поля не учитывается.

purchaseOptions object[]

Массив для объектов с опциями оплаты сезона.
По умолчанию на сезон распространяются опции оплаты сериала.
При указании опции оплаты для сезона, на сезон перестают распространяться опции оплаты сериала.
В случае, когда надо дополнить опции оплаты сезона опциями сериала, необходимо продублировать опции оплаты сериала в данном объекте.

Array [

id

string

Идентификатор опции оплаты

title

string

Название опции оплаты

consumptionMode

string

Способ потребления:

• "svod" — контент доступен по подписке;
• "tvod" — аренда контента;
• "fvod" — бесплатный контент;
• "avod" — контент за рекламу;
• "est" — покупка контента.

qualities

string[]

Массив качеств, контента на которые распространяется предложение

price

integer

Стоимость до копеек

currency

string

Код валюты по стандарту ISO 4217 альфа-3

]

episodes object[]

Массив объектов эпизодов

Array [

episodeSeq

number

Порядковый номер эпизода

title

string

Название эпизода

customLabels

string[]

Любой список тегов или лейблов, относящихся к данному уровню контента

links object[]

Ссылки на контент

Array [

type

string

required

Тип ссылки:

• web
• android

links

string

required

Ссылка на контент

]

screenshots object[]

Массив скриншотов

Array [

link

string

Ссылка на скриншот

resolution

string

Разрешение изображения

sequence

number

Признак для последовательности скриншотов (от 1 до n).
Обязательно при 2+ изображениях.

orientation

string

Ориентация скриншотов:

• H - Horizontal Горизонтальный)
• V - Vertical (вертикальный)

]

duration

number

Длительность контента в формате unix timestamp в миллисекундах

availability

boolean

Доступность контента
Если для сериала или сезона в параметре availability стоит значение false, значение данного поля учитываться не будет.

availabilityStartDate

string

Дата начала доступности контента.
При заполненении поля и наступлении даты контент становится доступным (значение поля availability игнорируется)
Если для сериала или сезона в параметре availability стоит значение false, значение данного поля не учитывается.

availabilityEndDate

string

Дата окончания доступности контента.
При заполненении поля и наступлении даты контент становится недоступным (значения полей availability и availabilityStartDate игнорируется)
Если для сериала или сезона в параметре availability стоит значение false, значение данного поля не учитывается.

]

]

]