Skip to main content
Skip table of contents

VOD Technical data model

NameTypeDescriptionLocalisedAlways available
_idStringInternal identifier for the object.NoYes
ActorsArray of strings

A list of actors. For example:

"Tom Cruise",
"Nicole Kidman"
NoNo
AspectString

The aspect ratio, for example, 16:9 or Widescreen.

NoNo
AudioArray of strings

A listof "locale-type" patterns representing the audio streams available for this series.

  • locale: three-letter ISO language code
  • type: VisualImpaired or Standard

For example:

"Eng-Standard",
"Eng-VisualImpaired",
"Fra-Standard"
NoNo
AudioModeString

The audio mode. For example,  MonoSRSTHX5.1Nicam Stereo, or Dual Mono.

NoNo
BestSalesIndexInteger

Sales index (position) for use in "Top" lists (for example, Top 10 Best Selling).

These are positive numbers, starting at 1.

If -1 or not present, this series is not in any "Top n" index.

NoNo
CategoriesStringA list of operator-defined category or genre names for this content.NoNo
companyIdStringProvider related identifier.NoNo
ContentTypeStringFree text. Used for implementation-specific data.NoNo
CopyProtectionsString

A list of usage rules for controlling certain hardware outputs to prevent unauthorised content copying.

For example:

"CGMS-A",
"HDCP"

If the value is 0 or not present, there is no restriction.

NoNo
CopyrightStringA copyright message.YesNo
CountriesStringA string of two-letter ISO codes representing countries relevant to this content.NoNo
DefinitionStringThe video definition. One of HDSD, or 3D.NoNo
DescriptionStringThe description of the content.YesNo
DirectorsStringA list of directors.NoNo
durationNumberThe approximate duration of the item, in seconds.NoYes
EpisodeString

Localised text representation of the index of the episode in the series. This field is used to display the episode number.
For example:

Season 3, Episode 2
YesNo
episodeNumberIntegerThe index of the episode in the series. This field is used for sorting episodes. NoNo
idStringThe CMS's identifier for the object.NoYes
IsRecordableBooleanWhether the end user is allowed to record this series.NoNo
LanguageStringThe original language of the content (three-letter ISO language code).NoNo
localeStringThe locale used for the object's localisable fields.NoYes
mainContentRefStringThe CMS ID of the associated editorial content.NoYes
mediaJSON objectDetails of the media stream providing the asset.NoYes
media.{format}.commentStringOperational comments of the media.NoNo
media.{format}.drmIdStringThe content ID assigned by the DRM components. This ID is used to reference the content in the DRM system.
This DRM ID is valid in the context of the DRM instance name.
NoNo
media.{format}.drmInstanceNameStringName of the DRM instance assigned to the content.NoNo
media.{format}.fileNameStringName of the file on the video server.NoYes
media.{format}.fileSizeIntegerThe file size in bytes.NoNo
media.{format}.formatString

The format of the media. Used to identify its type/format. The CMS supports these values:

  • AV_ClearTS
  • AV_EncryptedTS
  • AV_PlaylistName
  • Data_PMT
  • AV_HarmonicOSPlaylistName
NoNo
media.{format}.frameDurationIntegerThe duration of the media in frames.NoNo
media.{format}.idStringThe CMS's identifier for the media stream.NoNo
PrivateMetadataStringGeneric field used to pass directly data from the operator to the end-user device without any processing.
One possible use it to pass a listof keyword/value pairs, separated by semi-colons.
NoNo
ProducersStringA list of producers.NoNo
profileRefStringThe CMS ID of the encoding profile that applies to this asset.NoNo
ProgramIdStringThe ID of the broadcast event that this item relates to.NoNo
ProgrammeStartDateString: a date and time in ISO 8601 formatIf the asset represents a catch-up item, the start date and time of the corresponding event. NoNo
ProgrammeEndDateString: a date and time in ISO 8601 formatIf the asset represents a catch-up item, the end date and time of the corresponding event. NoNo
PromoImagesStringA list of promo image URLs. This must include URL-safe characters only. NoNo
promoRefsStringThe CMS IDs of any assets that are trailers for this asset.NoNo
providerIdStringThe identifier of the metadata provider, from the ID of the export's CMSVodData element.NoYes
Rating.codeStringParental rating code (from CMS).NoYes
Rating.precedenceIntegerQuantitative rating value.NoYes
Rating.nameStringLocalised name for the rating, for example, Adult orAdulto.
Yes
ScoringIntegerScore of the asset.NoNo
seriesRefStringThe CMS ID of the series that this episode belongs to.NoNo
ServiceLongNameStringIf the asset represents a catch-up item, the long name of the service (channel) the event was broadcast on.NoNo
ShortTitleStringThe short name of the content.YesNo
StudioStringThe content owner.NoNo
SubtitlesArray of strings

A listof “locale-type” patterns representing the subtitle streams available for this series.

  • locale: 3-letters ISO language code
  • type: HearingImpaired or Standard

For example:

"Eng-Standard",
"Eng-HearingImpaired",
"Fra-Standard"
NoNo
SynopsisStringA longer description of the asset.YesNo
titleString

The name of the asset.

This field is not localised. Multi-language clients should use the Title field instead.

NoYes
TitleString

The name of the asset.

The CMS mandates that this field will be populated for at least one locale-form of the asset.

YesNo
TotalDownloadsIntegerTotal number of downloads of the content/episode.NoNo
ViewingNumberInteger

How many times a user can watch the content once purchased.

If 0 or not present, there is no limitation. 

NoNo
xmlStringThe type of the object. Always technical.NoYes
YearIntegerThe year of production of the content.NoNo
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.