MRSS (Media RSS) is a standard XML formatted feed developed by Yahoo! in 2004 and is used on many popular video platforms.
All videos in Studio, including those from My Videos, Top Stories, and Templates, can be pulled from the platform with an MRSS feed.
These feeds allow your team to automate processes and integrate the videos with any DAM or MAM system, or your own custom one.
The MRSS Endpoint
Access Wibbitz MRSS from the following endpoint:
https://int-api.wibbitz.com/feed?format=rss
Authentication
The feed can only be accessed using your Wibbitz username and password.
Use your credentials in a "Basic Auth" method, encoded in Base64.
Feed Structure
Pulling the videos feed will give you an XML file with the list of videos in an account and each video’s respective data.
Here is an example of a single item XML:
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:media="http://search.yahoo.com/mrss/" version="2.0">
<channel>
<title>Wibbitz Video MRSS Feed</title>
<link>https://www.wibbitz.com</link>
<description>Media RSS example with new fields added in v1.5.0</description>
<item>
<title>Chicago Bulls Fire Head Coach Jim Boylen</title>
<link>https://cdn1.wibbitz.com/page/videos/879aa4abb9f842f38ab4f408509190db.mp4?utm_source=wbtz_rss</link>
<pubDate>Fri, 14 Aug 2020 17:54:51 GMT</pubDate>
<guid>https://cdn1.wibbitz.com/page/videos/879aa4abb9f842f38ab4f408509190db.mp4?utm_source=wbtz_rss</guid>
<media:content medium="video" duration="53" fileSize="37056754" framerate="30.0" height="1080" lang="en" type="video/mp4" width="1920" url="https://cdn1.wibbitz.com/page/videos/879aa4abb9f842f38ab4f408509190db.mp4?utm_source=wbtz_rss">
<media:category>Sports</media:category>
<media:description>Chicago Bulls Fire Head Coach Jim Boylen.</media:description>
<media:keywords>chicago bulls, nba</media:keywords>
<media:thumbnail url="https://wbtz-media-ingest-prod.s3.amazonaws.com/media/0e74f942b1ea492cb082e2cf66fc1d5b.jpg" />
</media:content>
</item>
</channel>
</rss>
Parameters
Calling the MRSS endpoint can include the following parameters, which can be used to pull specific video lists:
format - Required. Should be "rss"
clipType - Can be "Highlight" (for My Videos), "TopStory" or "PublicTemplate"
publisherIds - Required for "My Videos". Send one or more IDs. (i.e. 9999)
category - Optional. Filter the list for a specific category. (i.e. "lifestyle")
tags - Optional. Filter the list for specific tags.
ratioFormats - Optional. Filter the list for a specific ratio - "1" = landscape format , "2" = square format or "3" = vertical format .
language - Optional. Filter the list for a specific language. (i.e. "french")
query - Optional. Free text search.
sort - Optional. Can be sorted by "LastUpdate" or "MostRelevant"
fromDays - Optional. How many days back to look for videos (1=yesterday, 2=2days ago, etc...). Default is 7.
size - Optional. Limit the number of videos that you get in the result. Default is 20.
Note: to find publisherIds, click on your team's logo in the top right corner of the homepage. Click on the ID to copy it to your Clipboard.
Examples
Here are several examples of how to create different video lists using the feed.
Get all My Videos from the last 2 days:
https://int-api.wibbitz.com/feed?format=rss&publisherIds=9999&clipType=Highlight&fromDays=2
Get the 10 latest public templates, tagged with "facts":
https://int-api.wibbitz.com/feed?format=rss&clipType=PublicTemplate&size=10&tags=facts
Get the 5 latest lifestyle Top Stories:
https://int-api.wibbitz.com/feed?format=rss&clipType=TopStory&size=5&category=lifestyle
Get the 5 latest French Politics Top Stories:
https://int-api.wibbitz.com/feed?format=rss&clipType=TopStory&size=5&language=french&category=politics
Search for "COVID" in Top Stories. Limit to 3 results max:
https://int-api.wibbitz.com/feed?format=rss&clipType=TopStory&size=3&query=COVID