Skip to main content

Frequency Documentation

MRSS Ingestion

MRSS feeds offer flexibility in metadata and automation of ingestion. Frequency supports standard MRSS delivery as specified by the RSS Advisory Board, accommodating custom integrations from other vendors. Refer below for the required specifications for media, metadata, and an example MRSS feed.

Required MRSS Metadata

Type

Specifications

Example

Media URL

The video asset being ingested.

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

  • Minimum 1280x720 resolution

  • 16:9 Aspect Ratio

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

Image URL

The image representing the video asset.

  • 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.

<title>My Favorite Show</title>

Description

A detailed description for the asset that will display in the EPG information.

<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

Frequency supports various custom metadata. Refer to "Creating Series Metadata " for additional asset info and "Metadata Definitions" Metadata Definitions" for accepted values. Custom values can map to Frequency metadata.

Type

Specifications

Example

Series Title

Title for a series. Unrecognized titles are added to database

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

Series GUID

Global Unique Identifier for the series. Consistent across systems for record keeping.

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

Series Description

Series description. Ingested 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. Shows title clearly.

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

Season Number

Part of season video is in. Ingested first time a unique season is seen.

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

Season Title

The title for the season.

 <frequency:seasonTitle>Special Season</frequency:seasonTitle>

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>

Episode TItle

The title for the episode.

<frequency:episodeTitle>Special Episode</frequency:episodeTitle>

Closed Captions

URL to closed caption file. Supported formats: SRT, VTT

<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

Identify cue points in milliseconds. Ad insertion points in video.

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

Keywords

Searchable terms for content description. Useful for creating 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

Separates major content types.

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

Content Type

Describes video theme across categories. This is the pattern, motif, or theme of the video.

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

Cut

Official release production or cut of the video.

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

Periodicity

Describes if video is part of a superset.

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

Date Available/Date Expired

Identifies rights availability for distribution.

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

Custom Metadata

Open text field for custom integrations.

<frequency:custom>Any data is acceptable.</frequency:custom>

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:seasonTitle>Special Season</frequency:seasonTitle>
         <frequency:episode>3</frequency:episode>
         <frequency:episodeTitle>Special Episode</frequency:episodeTitle>
         <frequency:custom>Any data is acceptable.</frequency:custom>
      </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>