Wurl MRSS Ingest Specifications

These are the specifications for structuring MRSS feeds for delivery to Wurl.

A feed may contain one or more of the following types of content:

Movies
Series
TV Specials
Short-form videos (i.e. not TV shows or movies)

All videos you provide in the feed must conform to the Mezzanine Specification. Please note, Wurl cannot accept any kind of authorization token on the MRSS feed.

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://origin_domain_here/240X240_logo.png</url>
   <title>New Releases</title>
   <link>http://origin_domain_here/vod</link>
</image>

Link

<link>http://origin_domain_here/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><![CDATA[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://origin_domain_here/thumbnails/123.jpg</wurl:thumbnail>
</wurl:series>

Required if series feed. Series tag containing series info. See more info on Wurl MRSS Tags

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. 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. These are the 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.

Short Descriptions

<media:category scheme="urn:wurl:description_110">Brenda and Michael tear down the walls and open up their boxy bungalow.</media:category>

Optional. The character limit is 110 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://origin_domain_here/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://origin_domain_here/videos/123.mp4" duration="5400"/>

Required. The URL of a high-quality encoding of your MPEG4 video asset. Please see the Wurl Mezzanine Asset Spec for more info.

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="false">ABCDE12345</guid>

Required. A string that uniquely identifies the item. Non-URL guids are preferred but URLs are accepted but can not be signed URLs.

External ID

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

Optional. An external video ID used to identify the video in a CMS, used as a CAID for ad configuration and also another search method for assets and episodes in the scheduler.

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, episode, or movie ID.

Genres

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

Optional. Assigns a genre. Video-service-specific genres can be added in this format:

<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 this article: IAB Genre List version 2.1. See "Web Series MRSS Example" below for a sample

ClosedCaptions

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

Optional. Closed captions. See more info on Wurl MRSS Tags

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. See more info on Wurl MRSS Tags

Wurl Episode

<wurl:episode>
  <wurl:officialTitle><![CDATA[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 metadata. See more info on Wurl MRSS Tags

Wurl Movie

<wurl:movie>
  <wurl:officialTitle><![CDATA[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. See more info on Wurl MRSS Tags

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 sending neither a movie nor an episode you can specify if the content should be 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">Short Description up to 110 character</media:category>

Optional. A short 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.

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.

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.

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.

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

Directors, Actors, Producers

<media:credit role="actor">Actor Full Name(s)</media:credit>
<media:credit role="producer">Producer Full Name(s)</media:credit>
<media:credit role="director">Director Full Name(s)</media:credit>

Optional. A tag to indicate Actors, Producers, Directors. Multiple names should be separated by commas. This metadata may be required for certain streamers.

Web Series 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://origin_domain_here/rss/my-series.rss" rel="self"
                                                  type="application/rss+xml"/>
    <title>MySite: Gaming Channel</title>
    <description>Latest gaming videos from origin_domain_here</description>
    <link>http://origin_domain_here</link>
    <image>
      <url>http://origin_domain_here/thumbnails/series-1.png</url>
      <title>MySite: Gaming Channel</title>
      <link>http://origin_domain_here</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://origin_domain_here/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://origin_domain_here/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://origin_domain_here/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"/>
    </item>
    <item>
      <guid>http://origin_domain_herevideos/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://origin_domain_here/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://origin_domain_here/thumbnail/video-123.png"
                                                width="320" height="180"/>
      <media:thumbnail url="http://origin_domain_here/thumbnail/video-123.png"
                                                width="1920" height="1080"/>
    </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://origin_domain_here/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><![CDATA[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><![CDATA[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: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://origin_domain_here/newreleases.rss"/>
  <title>New Releases</title>
    <link>http://origin_domain_here/vod</link>
    <description>origin_domain_here 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://origin_domain_here/240X240_logo.png</url>
       <title>New Releases</title>
       <link>http://origin_domain_here/vod</link>
    </image>
   <item>
      <title>Jingle All The Way 2</title>
      <link>http://origin_domain_here/movieid=123</link>
      <description>JINGLE ALL THE WAY 2 - A heartwarming family comedy starring Larry the Cable Guy</description>
      <wurl:movie>
        <wurl:officialTitle><![CDATA[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>
      <media:content url="http://origin_domain_here/videos/123.mp4"
                                                       duration="5400"/>
      <media:thumbnail height="180"
             url="http://origin_domain_here/thumbnails/123.jpg" width="320"/>
      <media:category>New Releases, Family, Holiday Season</media:category>
      <media:rating scheme="urn:mpaa">pg-13</media:rating>
      <guid isPermaLink="true">http://origin_domain_here/videos/123.mp4</guid>
  </item>
  </channel>
</rss>

browse

Channel

Title

Description

Image

Link

PubDate

Wurl Series

Key

Item

Title

Description

Short Descriptions

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

Key

Search Tags

License Availability Windows

Rules for Allowed Runs

Directors, Actors, Producers

Web Series MRSS Example:

TV Series MRSS Example

Movie MRSS Example:

Was this article helpful?