Skip to main content

Frequency Documentation

MRSS Ingestion

MRSS feeds allow for flexibility in metadata and ingestion automation. Frequency supports standard MRSS delivery as specified by the RSS Advisory Board, and can accommodate most custom integrations from other vendors as well. Please refer below for required specs for media, metadata, and an example MRSS feed.

Required MRSS Metadata

Type

Specifications

Example

Media URL

This is the video asset being ingested.

  • Supported file extensions: mp4, mov, mpg, avi

  • Minimum 1280x720 resolution

  • 16:9 Aspect Ratio

<media:content url="http://www.foo.com/movie.mp4" />

Image URL

An image to represent your video asset. It is preferable if it is unique.

  • Supported file extensions: jpg, png, webp

  • Minimum 1280x720 resolution

  • 16:9 Aspect Ratio

<media:thumbnail url="http://www.foo.com/keyframe.jpg" />

Title

A brief, descriptive title of the asset that will help you and others.

<title>My Favorite Show</title>

Description

Give a detailed description for your asset and will display in your EPG information on linear playout.

<description>A new user enjoys Frequency Studio!</description>

GUID

A globally unique identifier for your asset. This can also be a static URL.

  • Must be a unique value for every video in your feed

<guid>13o4hkhsf823</guid>

Optional MRSS Metadata

We support a variety of custom metadata. Please refer to Managing Series Metadata for how to input additional asset information. Refer to Metadata Definitions for accepted values. Custom values can also be mapped to Frequency metadata values.

Type

Specifications

Example

Series Title

Title used for a series. Series titles referenced that don't exist will be added to the database.

 <frequency:seriesTitle>My New Series</frequency:seriesTitle>

Series GUID

Global Unique Identifier for the series. Should be consistent across systems for your own records.

<frequency:seriesGuid>61455990483901</frequency:seriesGuid>

Series Description

A description for the series. Will be ingested the first time a unique series is seen.

 <frequency:seriesDescription>A succinct one or two sentence description.</frequency:seriesDescription>

Series Image

A 16x9 image representing the series. Should clearly show the title of the series.

<frequency:seriesThumbnail url="https://your.host.net/635ae9845046ac65230a0367/1280/720" />

Season Number

The season that the video is a part of. Will be ingested the first time a unique season is seen for this series.

 <frequency:season>1</frequency:season>

Episode Number

The episode that this video is a part of the season of. Will be ingested the first time a unique episode is seen.

<frequency:episode>3</frequency:episode>

Closed Captions

A URL pointing to a closed caption file. SRT and VTT are the supported formats.

<media:subTitle href="https://subtitles.srt />

Genre/Subgenre

A two level hierarchy to categorize content. Including only a Genre is also supported. Multiple genre tags can be sent through.

<media:category>Comedy/Sitcom</media:category>

Cuepoints

Identifies the cue points in milliseconds, separated by commas. Cue points are places in time where an ad can be inserted in the video.

<frequency:cuepoints>0,345000,1080000</frequency:cuepoints>

Keywords

Useful searchable terms that help describe the content of the video. Can be used for creating powerful playlists.

<media:keywords>Jason Alexander,NBC</media:keywords

Region

The intended country of origin or distribution. This determines accepted parental ratings values based on country advisory board standards. Please use the ISO 3166standard 2 letter country codes.

<frequency:country>us</frequency:country>

Parental Rating

This should represent the minimum age required to watch this content according to the region the content is distributed.

<media:rating>TVPG</media:rating>

Content Format

This is a generic field separating out major types of content.

<frequency:contentFormat>Show</frequency:contentFormat>

Content Type

Theme is used to describe the video that could pertain across multiple categories such as “competition.” This is the pattern, motif, or theme of the video.

<frequency:contentType>Episode</frequency:contentType>

Cut

This is the production or set cut of the official release of the video.

<frequency:cut>Clip</frequency:cut>

Periodicity

Periodicity is used to describe if a video is part of a superset of videos.

<frequency:periodicity>Daily</frequency:periodicity>

Cuepoints

Comma separated points where ad breaks will be inserted when creating linear programs out of assets. Units are in milliseconds.

<frequency:cuepoints>0,345000,1080000</frequency:cuepoints>

Date Available/Date Expired

Identifies when rights are available to use the video for distribution.

<dcterms:valid>
    start=2002-10-13T09:00+01:00;
    end=2002-10-17T17:00+0100;
    scheme=W3C-DTF
</dcterms:valid>

Example MRSS

Download this sample XML file here: frequency-mrss-sample.xml

<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:dcterms="http://purl.org/dc/terms/" xmlns:frequency="http://www.frequency.com/icd/namespace" xmlns:media="http://search.yahoo.com/mrss/" version="2.0">
   <channel>
      <title>RSS Title</title>
      <description>This is an example of an RSS feed</description>
      <item>
         <title>The Contest</title>
         <description>George's mother throws her back out when she falls down after catching George performing a personal act; the gang partakes in a contest of self-denial. </description>
         <pubDate>Wed, 18 Nov 1992 18:00:00 +0000</pubDate>
         <guid isPermaLink="false">13o4hkhsf823</guid>
         <media:group>
            <media:content url="http://www.foo.com/movie.mp4" fileSize="12216320" type="video/mp4" medium="video" bitrate="2500" channels="2" duration="1380" height="720" width="1280" lang="en" />
            <media:thumbnail url="http://www.foo.com/keyframe.jpg" width="1280" height="720" time="12:05:01.123" />
                        <media:subTitle type="application/srt" lang="en" href="https://captions.srt"/>
         </media:group>
         <media:category scheme="http://www.frequency.com/icd/category_scheme">Comedy/Sitcom,TV/Comedy</media:category>
         <media:keywords>Seinfeld,Jason Alexander,NBC</media:keywords> 
         <frequency:contentFormat>Show</frequency:contentFormat>
         <frequency:contentType>Episode</frequency:contentType>
         <frequency:country>us</frequency:country>
         <media:rating scheme="urn:v-chip">TVPG</media:rating>
         <dcterms:valid>
            start=2002-10-13T09:00+01:00;
            end=2002-10-17T17:00+0100;
            scheme=W3C-DTF
         </dcterms:valid>
         <frequency:cuepoints>0,345000,1080000</frequency:cuepoints>
         <frequency:cut>Full Length</frequency:cut>
         <frequency:periodicity>Episodic</frequency:periodicity>
         <frequency:seriesGuid>61455990483901</frequency:seriesGuid>
         <frequency:seriesTitle>My New Series</frequency:seriesTitle>
         <frequency:seriesDescription>A succinct one or two sentence description.</frequency:seriesDescription>
         <frequency:seriesThumbnail url="https://your.host.net/635ae9845046ac65230a0367/1280/720" />
         <frequency:season>1</frequency:season>
         <frequency:episode>3</frequency:episode>
      </item>
      <item>
         <title>Title of media2</title>
         <description>Description of media</description>
         <pubDate>Sun, 06 Sep 2009 16:20:00 +0000</pubDate>
         <guid isPermaLink="false">13o4hkhsf923</guid>
         <frequency:lastModified>Sun, 06 Sep 2009 16:20:00 +0000</frequency:lastModified>
         <media:group>
            <media:content url="http://www.foo.com/movie.mp4" fileSize="12216320" type="video/mp4" medium="video" isDefault="true" expression="full" bitrate="128" framerate="25" samplingrate="44.1" channels="2" duration="185" height="720" width="1280" lang="en" />
            <media:thumbnail url="http://www.foo.com/keyframe.jpg" width="1280" height="720" />
            <media:subTitle type="application/srt" lang="en" href="https://captions.srt"/>
 </media:group>
                 <frequency:periodicity>Daily</frequency:periodicity>
         <frequency:cuepoints>0,345000,1080000</frequency:cuepoints>
         <frequency:contentType>Stand Up</frequency:contentType>
         <frequency:cut>Full Length</frequency:cut>
         <frequency:country>us</frequency:country>
         <media:rating scheme="urn:v-chip">TV-PG</media:rating>
         <frequency:periodicity>Episodic</frequency:periodicity>
         <frequency:contentFormat>Show</frequency:contentFormat>
         <media:category scheme="http://www.frequency.com/icd/category_scheme">TV/Comedy</media:category>
         <media:keywords>Jerry Seinfeld,George Costanza,</media:keywords>
      </item>
   </channel>
</rss>