The Metadata Service is responsible for managing data specific to media content, such as assets, channels, credits and providers.

The following sections provide background on how to make use of the service and model your data.

Full reference API docs are available:

Data Model

The metadata model is flexible in order to handle a number of different solutions and some aspects of the model may therefore be simplified if scenarios are not applicable.

Simplified Data Model

Content is at the heart of the model, allowing other resources to associated with and through them. Content also supports a tree-based hierarchy to allow parent/child relationships (e.g. shows, seasons and episodes) and collections of explicit members or dynamic based on filters.

The following provides some guidance:

  • Contents may represent a particular title such as a movie or episode, a grouping of titles such as a show or season, or a version of a title such as pre and post watershed.
  • Offers may contain metadata that overrides the content metadata to allow for offer specifics.
  • Trailers may be represented as a version of a given title or standalone and related to a program.
  • 3D/2D (dimensions) and 4K/HD/SD (definition) are different renditions of the same content, i.e. assets
  • A Directors Cut is a version of a title, however, it may be represented as a distinct title due to it being marketed at that level
  • Any resource may have assets associated with it through a content folder.

For more details, see:

For examples of how to model data, see: