TV Metadata Preparation

This page details the metadata requirements for sending a TV data feed to IVA. We currently support an xml schema.
TV feeds should contain all assets provided by network as asset relationships between series, season and episode need to be maintained.

A sample feed can be found here to provide more clarification on the schema outlined below.

Property Description  
SeriesIdThe unique ID for the series record this media asset relates to. Each media asset must have a unique ID and must be associated with an overarching series ID.
SeasonId (Optional)The unique ID for the season record this media asset relates to. Each media asset must have a unique ID and must be associated with an overarching season ID. For a series media asset, this field should be left blank.
EpisodeId (Optional)The unique ID for the episode record this media asset relates to. Each media asset must have a unique ID and must be associated with an overarching episode ID. For a series or season media asset, this field should be left blank.
ShowId (Optional)The unique ID for the tv show record this media asset relates to. Each media asset must have a unique ID and must be associated with an overarching show ID. For a series, season, or episode asset, this field should be left blank.  A “show” is not part of a series or season.  These are typically a single on air program not related to other programs.
Series TitleTitle or short description of the series being promoted. This field is limited to 100 characters. For Tv shows, this field should be left blank.
Season Title (Optional)Title or short description of the season being promoted. This field is limited to 100 characters. For series records and tv shows, this field should be left blank.
Episode Title (Optional)Title or short description of the episode being promoted. This field is limited to 100 characters. For series,season, and tv show records, this field should be left blank.
Show Title (Optional)Title or short description of the tv show being promoted. This field is limited to 100 characters.
DescriptionDescription of the video asset, this field is limited to 5000 characters.
Series OriginalAirDate (Optional)The original date and time of the Series the asset is promoting was aired, for example 1/03/2014 8:00 PM.
Season OriginalAirDate (Optional)The original date and time of the Season the asset is promoting was aired, for example 1/03/2014 8:00 PM.
Episode OriginalAirDate (Optional)The original date and time of the Episode the asset is promoting was aired, for example 1/03/2014 8:00 PM.
MediaTypeThis determines the type of media asset. For example: Series, Season, Episode, Episode Interview, etc. A complete listing of all available media types can be found here.
StreamLengthInSecondsThe length in seconds of the media content. This is useful to distinguish whether IVA serves the VideoAsset.
StartDate(Optional) This field controls the date on which this media asset can be exposed to IVA’s network. Leave this field blank if this media content should appear immediately.
ExpirationDate (Optional)  This field controls the date on which this media asset must be pulled down from IVA’s network. Leave this field blank if this media content should appear indefinitely.
LanguageSpokenThis property describes the primary language spoken for this series, season, episode or tv show asset. This property is especially useful for localizing video content in other countries in combination with TargetCountry property.  This field corresponds to the ISO 639-1 Code.
LanguageSubtitledThis property describes the primary language subtitled in this media asset. This property is especially useful for localizing video content in other countries in combination with TargetCountry property.  When the video asset does not have subtitles, this property is left empty. This field corresponds to the ISO 639-1 Code.
TargetCountryThis denotes whether this media content was made for a specific country. This field requires aISO 3166-1 alpha 2 code . Leave blank if there is no target country.
WarningFlagThis denotes a red band trailer or explicit content.  For most content this is set to false.
OfficialSiteUrlsThe URL to the official web site as provided by the CopyrightHolder. This field requires a root element of OfficialSiteUrl. Each subelement is named SiteUrl, and should contain an attribute type, which lists the specific device this siteUrl targets.Here is a list of currently supported site url types, contactSupport@internetvideoarchive.com to request additional types.
IOSAndroid
Web – URLWindows Phone
SeasonSequenceThis property is used primarily for Television Seasons and Television Episodes to order child elements. For example, episode 12 of Breaking Bad season 5 would list the season sequence as 5.
EpisodeSequenceThis property is used primarily for Television Seasons and Television Episodes to order child elements. For example, episode 12 of Breaking Bad season 5 would list the episode sequence as 12.
TVCategoryThis property provides Television Genres for the program.
ActionHorror
AdultMusic
AdventureMusical
AnimationMystery
BiographyNews
ComedyReality-TV
CrimeRomance
DocumentarySci-Fi
DramaSport
FamilyTalk Show
FantasyThriller
Film-NoirTV Special
Game ShowWar
HistoryWestern
TVRatingThis is used for TV Programs and provides the US TV Rating for the program. The full list of accepted Ratings are listed below.
Tv RatingDescription
NRNot applicable/not available/Not Rated.
TV-Y>All children ages 0-6.
TV-Y7Directed to children 7 and older./td>
TV-Y7-FVDirected to children 7 and older with fantasy violence in shows.
TV-GGeneral audience.
TV-PGParental guidance suggested.
TV-14Parents strongly cautioned/May be unsuitable for children under 14 years of age.
TV-MAMature audience — unsuitable for audiences under 17.
MetadataUpdateThis field indicates whether we need to update metadata around this media asset. This does NOT relate to a video asset change. This field should correspond to a timestamp for the last metadata update.
VideoUpdateThis field indicates whether we need to reencode the video asset linked by the videoUrl field for this media asset. This does NOT relate to a metadata change. This field should correspond to a timestamp for the last video update.
VideoUrlThis field indicates a link to download the video content related to this media asset. Please use the highest source video you have available, as IVA will encode this file into multiple video formats including HLS,HDS,HSS, and a variety of mp4′s.
PerformersThis field indicates the six primary performers credited for this media asset. This field should have a root Performers element, with each performer (first name, last name) listed in its own performer sub element.
DirectorThis field indicates the primary director for this media asset. The naming convention for director should follow the performer convention (First name, last name)
ThirdPartyIds (Optional)Use this field to indicate to IVA you would like additional third party id’s added to this title. The list of supported third party vendors are located here . This property requires a root element of ThirdPartIds. Each id to include should confirm to the following schema, Id subelement with an attribute of type. The type corresponds to a supported third party vendor.
AssetTitle (Optional)Title or short description of the series, season, or episode asset being promoted. This field is limited to 100 characters. This field is used only for records which promote a series, season or episode. For example, Series SceneOrSample, Episodic Behind-The-Scenes, or Season Interview would fall under this category.
AssetId (Optional)The unique ID for the series, season, or episode record this media asset relates to. This field is used only for records which promote a series, season or episode. For example, Series SceneOrSample, Episodic Behind-The-Scenes, or Season Interview would fall under this category.