MRSS feed format for Wurl Platform

This page describes the MRSS format video producers are recommended to use in order to on-board their content to the Wurl Platform. We make use of standard RSS/MRSS tags, but in some cases Wurl defined tags will need to be used.

Wurl will transcode your videos to ensure playback on a variety of target platforms. Note that the format of your videos you provide in the feed need to conform to the Mezzanine Specification.

When on-boarding episodic series data, it is recommended that you provide one feed per Series. If you publish multiple video series, provide multiple syndication feeds, one for each video series to be added to the Wurl Platform. If your series has multiple seasons we recommend one feed per season.

Channel
- title
- description
- image
- link
- pub-date
- series
- wurl-key
Item
- title
- description
- pub-date
- thumbnail
- content
- keywords
- guid
- external-id
- episode-external-id
- tms
- genres
- iab
- closed captions
- ratings
- episode
- movie
- content-type
- internal-title
- description-110
- target-duration
- wurl-tag
- wurl-key
- wurl-search-tag
- watermark
- valid
- wurl-restrictions
Item Undelivered
- credit
- copyright
- price
ShortForm Video MRSS Example
TV Series MRSS Example
Movie MRSS Example

Channel

Elements in <channel> section of your syndication feed:

Title

<title>Series Title</title>

Required. Title of your video series. Recommended length 50 characters or less.

Description

<description>Series Description</description>

Required. Brief description of your video series. Recommended length 200 characters or less.

Image

<image>
   <url>http://www.myvideosite.com/240X240_logo.png</url>
   <title>New Releases</title>
   <link>http://www.myvideosite.com/vod</link>
</image>

Link

<link>http://www.myvideosite.com/vod</link>

Required. URL of your website or app. (Required for feed validation, but not used by Wurl).

PubDate

<pubDate>Thu, 10 Sep 2018 12:34:12 -0500</pubDate>

Required. Date and time of last feed update in RFC-822 date-time format.

Wurl Series

<wurl:series>
  <wurl:officialTitle>Game of Thrones</wurl:officialTitle>
  <wurl:startYear>2011</wurl:startYear>
  <wurl:season>
     <wurl:seasonNumber>1</wurl:seasonNumber>
     <wurl:seasonTitle>Some title</wurl:seasonTitle>
  </wurl:season>
  <wurl:studio>n/a</wurl:studio>
  <wurl:thumbnail>http://www.myvideosite.com/thumbnails/123.jpg</wurl:thumbnail>
</wurl:series>

Required if series feed. Series tag containing series info. More...

Wurl Key

<media:category scheme="urn:wurl:channel:key">channel searchable key</media:category>
<media:category scheme="urn:wurl:channel:key">one more reference</media:category>

Optional. Optional. A reference to group and search episodes. Recommended length: 50 characters or less. The values provided at this level will be propagated to all the item nodes. If you wish to override these "key" values for a particular item node, just add the tags to that node.

Item

Your syndication feed should contain multiple <item> groups, one for each video. Elements in <item> section of feed:

Title

<title>A Title</title>
<!-- or -->
<media:title>A Title</media:title>

Required. Title of the video. Recommended length 50 characters or less.

Description

<description>A Description</description>
<!-- or -->
<media:description>A Description</media:description>

Required. Brief description of your video. Recommended length 200 characters or less.

PubDate

<pubDate>Thu, 10 Sep 2018 12:34:12 -0500</pubDate>

Required. Your video’s release date and time in RFC-822 date-time format.

Thumbnail

<media:thumbnail height="720"url="http://www.myvideosite.com/thumbnails/123.jpg" width="1280"/>

Required. URL of a thumbnail image to be associated with your video. The aspect ratio should be 16:9 and format .jpg, .png, or .svg.

Content

<media:content url="http://myvideosite.com/videos/123.mp4" duration="5400"/>

Required. The URL of a high-quality encoding of your MPEG4 video asset.

Keywords

<media:keywords>keyword1, keyword2</media:keywords>

Required. Highly relevant keywords describing the video. Recommended limit of 10 keywords or phrases. The keywords and phrases should be comma-delimited.

Guid

<guid isPermaLink="true">http://www.videos.com/item/987654</guid>

Required. A string that uniquely identifies the item, typically a URL.

External ID

<media:category scheme="urn:wurl:external:id">123456-1</media:category>

Optional. An external video id used identify the video in a CMS.

Episode External ID

<media:category scheme="urn:wurl:episode_external:id">789-2</media:category>

Optional. An external id used to identify the target Wurl episode.

TMS

<media:category scheme="urn:wurl:tms:series:id">SH1234</media:category>
<media:category scheme="urn:wurl:tms:episode:id">EP1234</media:category>
<media:category scheme="urn:wurl:tms:movie:id">MV1234</media:category>

Optional. Assigns a TMS Series or Episode ID.

Genres

<media:category scheme="urn:wurl:genre">Cooking</media:category>

Optional. Assigns a genre. Video Service specific genres can be added like this:

<media:category scheme="urn:roku:genre">Action</media:category>
<media:category scheme="urn:roku:genre">Comedy</media:category>
<media:category scheme="urn:samsung:genre">Drama</media:category>
<media:category scheme="urn:samsung:genre">Movies</media:category>
<media:category scheme="urn:sinclair:genre">Suspense</media:category>
<media:category scheme="urn:sinclair:genre">Kids</media:category>
<media:category scheme="urn:nielsen:genre">Devotional</media:category>
<media:category scheme="urn:nielsen:genre">Documentary, General</media:category>

IAB Category

<media:category scheme="urn:iab:categories" label="Video and Computer Games">IAB9-30</media:category>

Optional. Specify a category for your video using the IAB Content Category taxonomy. The categories are documented in the IAB’s OPENRTB API Specification Version 2.1. See the "Web Series MRSS Example" below for a sample or learn more about this by reading the specification

ClosedCaptions

<wurl:closedCaptions type="SCC" lang="en-us" href="http://wurl.com/en-us.scc"/>

Optional. Closed captions. More...

Rating

<media:rating scheme="urn:mpaa">pg-13</media:rating>
<media:rating scheme="urn:v-chip">tv-y7-fv</media:rating>

Optional. This allows content ratings to be declared. More...

Wurl Episode

<wurl:episode>
  <wurl:officialTitle>Winter Is Coming</wurl:officialTitle>
  <wurl:seasonNumber>1</wurl:seasonNumber>
  <wurl:episodeNumber>1</wurl:episodeNumber>
  <wurl:firstAired>Sun, 17 Apr 2011 00:00:00 -0000</wurl:firstAired>
</wurl:episode>

Required if series feed. Episode tag containing additional episode meta data. More...

Wurl Movie

<wurl:movie>
  <wurl:officialTitle>Jingle All The Way 2</wurl:officialTitle>
  <wurl:year>2011</wurl:year>
  <wurl:firstAired>Tue, 01 Jan 2011 00:00:00 -0000</wurl:firstAired>
</wurl:movie>

Required if movie feed. Movie tag containing series info. More...

Wurl Content Type

<media:category scheme="urn:wurl:content_type">tvSpecial</media:category>
<!-- or -->
<media:category scheme="urn:wurl:content_type">shortFormVideo</media:category>

Optional. If you are not sending neither a movie nor an episode you can specify if the content should be consider either a TV Special or a Short Form Video.

Wurl Internal Title

<media:category scheme="urn:wurl:internal_title">String Value</media:category>

Optional. Title for internal reference.

Wurl Description 110

<media:category scheme="urn:wurl:description_110">Description up to 110 character</media:category>

Optional. A description field up to 110 characters.

Wurl Target Duration

<media:category scheme="urn:wurl:target_duration">3600</media:category>

Optional. Target duration in milliseconds.

Wurl Tag

<media:category scheme="urn:wurl:tags">promo</media:category>
<!-- or -->
<media:category scheme="urn:wurl:tags">ad</media:category>

Optional. This allows you to tag a video as being a promotional video or ad slate.

Wurl Key

<media:category scheme="urn:wurl:channel:key">channel searchable key</media:category>
<media:category scheme="urn:wurl:channel:key">one more reference</media:category>

Optional. A reference to group and search episodes. Recommended length: 50 characters or less.

Wurl Search Tags

<media:category scheme="urn:searchTag">Movie</media:category>
<media:category scheme="urn:searchTag">Action</media:category>
<media:category scheme="urn:searchTag">DayTime</media:category>

Optional. A tag specifically used to create auto-scheduling blocks. Please include each tag within its own line, as shown above.

Watermark

<wurl:watermark>
  <wurl:imageUrl>http://wurl-videos-dev.com/WM/asset/Foo_Logo.png</wurl:imageUrl>
  <wurl:xPosition>-5%</wurl:xPosition>
  <wurl:yPosition>-4%</wurl:yPosition>
  <wurl:opacity>0.3</wurl:opacity>
  <wurl:width>12%</wurl:width>
  <wurl:height>10%</wurl:height>
</wurl:watermark>

Optional. Tag to add a watermark into the transcode video. More...

Item Undelivered

Undeliverd fields are fields on supported and stored via MRSS ingestion but currently are not delivered to video services. They are optional fields that can be included in the case that Wurl and video services support them in the future. Each of these elements are are part of the <item> section of feed:

Credit

<media:credit role="actor">Peter Dinklage</media:credit>
<media:credit role="director">Tim Van Patten</media:credit>
<media:credit role="author">David Benioff</media:credit>

Optional. Notable entity that contributed to the creation of the media object. May include actors, producers, studios, etc. More...

Copyright

<media:copyright>Wurl 2018</media:copyright>

Optional. Copyright information for the video. More...

Price

<wurl:price type="rent" amount="19.99" currency="USD"/>

Optional. Pricing information about a media object. More...

Valid - License Availability Windows

<dcterms:valid>start=02 Dec 2021;end=30 Jun 2022; scheme=W3C-DTF</</dcterms:valid>

Optional. Start and end dates indicate the time period the video is available for distribution. Multiple entries of this tag can be used to specify multiple valid windows. See example below.

Wurl Restrictions - Rules for Allowed Runs

<wurl:restrictions>
      <wurl:showLimit period="day">1</wurl:showLimit>
      <wurl:showLimit period="window">23</wurl:showLimit>
</wurl:restrictions>

Optional. A tag to indicate the maximum allowed runs of an item per time period. This specific example allows for distributing once per day and 23 times during the dcterms:valid window. Multiple entries of this tag can be used to specify multiple allowed run restrictions. Allowed Values for period are day,week,month,year, and window

ShortForm Video MRSS Example:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/"
                  xmlns:atom="http://www.w3.org/2005/Atom"
                  xmlns:wurl="http://api.wurl.com/wurlrss/1.0">
  <channel>
    <atom:link href="http://mysite.com/rss/my-series.rss" rel="self"
                                                  type="application/rss+xml"/>
    <title>MySite: Gaming Channel</title>
    <description>Latest gaming videos from mysite.com</description>
    <link>http://www.mysite.com</link>
    <image>
      <url>http://mysite.com/thumbnails/series-1.png</url>
      <title>MySite: Gaming Channel</title>
      <link>http://www.mysite.com</link>
    </image>
    <pubDate>Mon, 18 May 2015 18:56:21 +0000</pubDate>
    <media:keywords>kitty, cat, big dog, yarn, fluffy</media:keywords>
    <item>
      <guid>http://mysite.com/videos/456.mp4</guid>
      <title>Gaming video Y</title>
      <description>A walk-through of the new Y game</description>
      <pubDate>Mon, 18 May 2015 18:56:21 +0000</pubDate>
      <!-- duration in seconds -->
      <media:content url="http://mysite.com/videos/456.mp4" type="video/mp4"
          medium="video" duration="120" lang="en" fileSize="12216320"
          bitrate="128" framerate="25" samplingrate="44.1" channels="2"
          height="200" width="300"/>
      <media:keywords>gaming y</media:keywords>
      <media:thumbnail url="http://mysite.com/thumbnail/video-456.png"
                                                width="320" height="180"/>
      <media:category>gaming</media:category>
      <media:category scheme="urn:wurl:external:id">123456-1</media:category>
      <media:category scheme="urn:iab:categories"
                  label="Video and Computer Games">IAB9-30</media:category>
      <media:category scheme="urn:roku:genre">Comedy</media:category>
      <media:category scheme="urn:samsung:genre">Drama</media:category>
      <media:rating scheme="urn:mpaa">pg-13</media:rating>
      <media:rating scheme="urn:v-chip">tv-y7-fv</media:rating>
      <wurl:closedCaptions type="SCC" lang="en-us" href="http://videos.com/en-us.scc"/>
      <wurl:closedCaptions type="SRT" lang="en-us" href="http://videos.com/en-us.srt"/>
      <media:category scheme="urn:wurl:content_type">shortFormVideo</media:category>
    </item>
    <item>
      <guid>http://mysite.com/videos/123.mp4</guid>
      <title>Gaming video X</title>
      <description>A walk-through of the new X game</description>
      <pubDate>Wed, 1 Apr 2015 18:56:21 +0000</pubDate>
      <!-- duration in seconds -->
      <media:content url="http://mysite.com/videos/123.mp4" type="video/mp4"
          medium="video" duration="120" lang="en" fileSize="12216320"
          bitrate="128" framerate="25" samplingrate="44.1" channels="2"
          height="200" width="300"/>
      <media:keywords>gaming x</media:keywords>
      <media:thumbnail url="http://mysite.com/thumbnail/video-123.png"
                                                width="320" height="180"/>
      <media:thumbnail url="http://mysite.com/thumbnail/video-123.png"
                                                width="1920" height="1080"/>
      <wurl:watermark>
        <wurl:imageUrl>http://wurl-videos-dev.com/WM/asset/Foo_Logo.png</wurl:imageUrl>
        <wurl:xPosition>-5%</wurl:xPosition>
        <wurl:yPosition>-4%</wurl:yPosition>
        <wurl:opacity>0.3</wurl:opacity>
        <wurl:width>12%</wurl:width>
        <wurl:height>10%</wurl:height>
      </wurl:watermark>
      <media:category scheme="urn:wurl:content_type">shortFormVideo</media:category>
    </item>
  </channel>
</rss>

TV Series MRSS Example

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/"
                   xmlns:dcterms="http://purl.org/dc/terms/"
                   xmlns:wurl="http://api.wurl.com/wurlrss/1.0"
                   xmlns:atom="http://www.w3.org/2005/Atom">
<channel>
  <atom:link rel="self" type="application/rss+xml"
                            href="http://www.myvideosite.com/newreleases.rss"/>
  <title>HBO - Game of Thrones</title>
    <link>http://www.hbo.com/game-of-thrones/index.html</link>
    <description>It’s not TV. It’s HBO</description>
    <pubDate>Thu, 10 Sep 2015 12:34:12 -0500</pubDate>
    <image>
       <url>http://www.hbo.com/240X240_logo.png</url>
       <title>HBO - Game of Thrones</title>
       <link>http://www.hbo.com/game-of-thrones/index.html</link>
    </image>
    <wurl:series>
      <wurl:officialTitle>Game of Thrones</wurl:officialTitle>
      <wurl:startYear>2011</wurl:startYear>
      <wurl:season>
         <wurl:seasonNumber>1</wurl:seasonNumber>
         <wurl:seasonTitle>Some title</wurl:seasonTitle>
      </wurl:season>
      <wurl:studio>n/a</wurl:studio>
    </wurl:series>
   <item>
      <title>Game of Thrones - Winter Is Coming</title>
      <link>http://www.hbo.com?series_id=123</link>
      <description>Robert Baratheon (King of the Seven Kingdoms of Westeros)
        and his Queen, Cersei Lannister...</description>
      <wurl:episode>
        <wurl:officialTitle>Winter Is Coming</wurl:officialTitle>
        <wurl:seasonNumber>1</wurl:seasonNumber>
        <wurl:episodeNumber>1</wurl:episodeNumber>
        <wurl:firstAired>Sun, 17 Apr 2011 00:00:00 -0000</wurl:firstAired>
      </wurl:episode>
      <wurl:price type="rent" amount="5.99" currency="USD"/>
      <media:content url="http://www.hbo.com?series_id=123" duration="5400"/>
      <media:thumbnail height="180"
             url="http://www.hbo.com/123.jpg" width="320"/>
      <dcterms:valid>start=Tue, 02 Dec 2014 00:00:00 -0600;
              end=Tue, 30 Jun 2015 00:00:00 -0500;scheme=W3C-DTF</dcterms:valid>
      <media:category>Fantasy</media:category>
      <media:category scheme="urn:wurl:genre">Action</media:category>
      <media:credit role="actor">Sean Bean</media:credit>
      <media:credit role="actor">Michelle Fairley</media:credit>
      <media:credit role="actor">Peter Dinklage</media:credit>
      <media:credit role="director">Tim Van Patten</media:credit>
      <media:credit role="author">David Benioff</media:credit>
      <media:rating scheme="urn:v-chip">tv-y7-fv</media:rating>
      <media:category scheme="urn:wurl:tms:series:id">SH1234</media:category>
      <media:category scheme="urn:wurl:tms:episode:id">EP1234</media:category>
      <media:category scheme="urn:wurl:ads:content:id">ABC123</media:category>
      <wurl:closedCaptions type="SCC" lang="en-us"
            href="http://wurl.com/en-us.scc"/>
      <guid isPermaLink="true">http://www.hbo.com?series_id=123</guid>
  </item>
  </channel>
</rss>

Movie MRSS Example:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/"
                   xmlns:dcterms="http://purl.org/dc/terms/"
                   xmlns:wurl="http://api.wurl.com/wurlrss/1.0"
                   xmlns:atom="http://www.w3.org/2005/Atom">
<channel>
  <atom:link rel="self" type="application/rss+xml"
                            href="http://www.myvideosite.com/newreleases.rss"/>
  <title>New Releases</title>
    <link>http://www.myvideosite.com/vod</link>
    <description>MyVideoSite provides an unmatched VoD
          services with over 3000 titles of pay and free content</description>
    <pubDate>Thu, 10 Sep 2015 12:34:12 -0500</pubDate>
    <image>
       <url>http://www.myvideosite.com/240X240_logo.png</url>
       <title>New Releases</title>
       <link>http://www.myvideosite.com/vod</link>
    </image>
   <item>
      <title>Jingle All The Way 2</title>
      <link>http://www.myvideosite.com?movieid=123</link>
      <description>JINGLE ALL THE WAY 2 - A heartwarming family
                              comedy starring Larry the Cable Guy</description>
      <wurl:movie>
        <wurl:officialTitle>Jingle All The Way 2
                                                        </wurl:officialTitle>
        <wurl:year>2011</wurl:year>
      </wurl:movie>
      <wurl:price type="rent" amount="19.99" currency="USD"/>
      <media:content url="http://myvideosite.com/videos/123.mp4"
                                                       duration="5400"/>
      <media:thumbnail height="180"
             url="http://www.myvideosite.com/thumbnails/123.jpg" width="320"/>
      <dcterms:valid>start=Tue, 02 Dec 2014 00:00:00 -0600;
            end=Tue, 30 Jun 2015 00:00:00 -0500;scheme=W3C-DTF</dcterms:valid>
      <media:category>New Releases, Family, Holiday Season</media:category>
      <media:credit role="actor">Brian Stepanek</media:credit>
      <media:credit role="actor">Larry the Cable Guy</media:credit>
      <media:credit role="actor">David Milchard</media:credit>
      <media:credit role="director">Alex Zamm</media:credit>
      <media:credit role="author">Joe Doe</media:credit>
      <media:rating scheme="urn:mpaa">pg-13</media:rating>
      <guid isPermaLink="true">http://myvideosite.com/videos/123.mp4</guid>
  </item>
  </channel>
</rss>

Files

mrss-feed-spec.md

Latest commit

History

mrss-feed-spec.md

File metadata and controls

MRSS feed format for Wurl Platform

Channel

Title

Description

Image

Link

PubDate

Wurl Series

Wurl Key

Item

Title

Description

PubDate

Thumbnail

Content

Keywords

Guid

External ID

Episode External ID

TMS

Genres

IAB Category

ClosedCaptions

Rating

Wurl Episode

Wurl Movie

Wurl Content Type

Wurl Internal Title

Wurl Description 110

Wurl Target Duration

Wurl Tag

Wurl Key

Wurl Search Tags

Watermark

Item Undelivered

Credit

Copyright

Price

Valid - License Availability Windows

Wurl Restrictions - Rules for Allowed Runs

ShortForm Video MRSS Example:

TV Series MRSS Example

Movie MRSS Example: