Pzaz MRSS Feed Specifications

Overview
Feed Formats
Elements List
Channel
Item
References

The content feed for Pzaz channels provides the metadata needed to play your content on Pzaz. The content feed includes basic information for each video in your catalog such as the unique ID, title, description, and category; the URL where the video is hosted; and the thumbnail for the video, which is displayed in the channel and in Pzaz Search.

If your catalog only contains short-form videos (a video that is typically less than 15 minutes and is not a movie or television show), you can use the MRSS feed format. This format is ideal for partners who want to leverage an existing MRSS feed because none or a very small amount of additional work is required to create or modify the feed. If you have films, series or live channels, please do not use MRSS feed format.

The MRSS feed enables partners to quickly distribute existing content to the Pzaz platform. This option is provided so that partners can re-purpose existing MRSS feeds with little or no changes when creating a Pzaz channel.

Pzaz supports catalog feeds of content for launching channels on the Pzaz Publishing Platform. Specifically, we support MRSS feeds with required fields to ensure have the best experience with your channel.

This specification has detailed information on the MRSS elements you can use to build a Pzaz-compatible MRSS feed, as well as examples to help along the way.

Note: only parse the elements described in this spec. Any other elements provided will be ignored.

Feed Formats

MRSS Feeds for Pzaz are based industry standards. See the References section below for more information. Pzaz indicates below which items which elements are required and/or optional.

Elements List:

The following is a complete list of the elements that Pzaz supports along with descriptions and examples.

Channel
- lastBuildDate
Item

Channel:

The following are sub-elements of a <channel> tag:

lastBuildDate

Optional

The last time the feed was updated: {YYYY}-{MM}-{DD}T{hh}:{mm}:{ss}+{TZ}. E.g.: 2015-11-11T22:21:37+00:00. Note: Use date and time format ISO 8601.

Example:

Item:

Each <item> in an MRSS feed correlates to one video / content item.

Example:

<item>

<guid>https://example.org/cdn/video/vaaaXaaX</guid>

<media:title>The Best Show Ever</media:title>

<media:description>So long, and thanks for all the fish.</media:description>

<media:category>cooking</media:category>

<media:category>reality</media:category>

<media:thumbnail url="http://example.org/cdn/thumbs/42/lkmfaAAmA.jpg" />

<media:content

url="https://example.org/videos/your-video-id.mp4"

duration="74.74"

bitrate="2500"

language="en-us" />

<media:subTitle

lang="en-us"

href="http://www.example.org/cdn/subtitles/subtitle.srt" />

</item>

The following are sub-elements of an <item> tag:

guid

Required

The unique and immutable id for the video.

Example:

<guid>https://example.org/cdn/video/vaaaXaaX</guid>

PubDate

Required

The release date or publication date of the item: {YYYY}-{MM}-{DD}T{hh}:{mm}:{ss}+{TZ}. E.g.: 2015-11-11T22:21:37+00:00. Note: Use date and time format ISO 8601.

Example:

media:title or <title>

Required

The video title. We use this value for matching. Please use plain text and do NOT include extra information like year, version label, etc. Any extra information in the video title will make your feed void and unable to be used.

You can also use <title>

Example:

<media:title>The Best Show Ever</media:title>

media:description or <description>

Required

A description of the video that does not exceed 200 characters. The text will be clipped if longer.

You can also use <description>

Example:

<media:description>So long, and thanks for all the fish.</media:description>

media:category

Required

One or more categories, maximum of three categories. Categories are used as tags to organize your content so your users can quickly find what they want. You can find more information about categories and tags in Pzaz Categories.

Examples:

<media:category>Cooking Shows</media:category>

or:

<media:category>cooking</media:category>

<media:category>reality</media:category>

media:thumbnail

Required

The thumbnail is used within the Pzaz platform. The image size must be 1920x1080 (width x height) or larger, with a 16x9 aspect ratio. Supported formats are JPG and PNG.

Flag(s):

Flag	Required	Description
url	Required	The URL of the thumbnail

Example:

<media:thumbnail url="http://example.org/cdn/thumbs/42/lkmfaAAmA.jpg"/>

media:content

Required

The actual video file(s) in minimum resolution of 1024x576 and maximum of full HD. Pzaz accepts most video formats.

Flags:

Flag	Required	Description
url	Required	the URL of the video file
duration	Required	The duration of the video (in seconds)
bitrate	Optional	The bitrate of the file
lang	Optional	The original language of the video in ISO 639-2 format (3-letter country code)

Example:

<media:content url="https://example.org/videos/your-video-id.mp4" duration="74.74" bitrate="2500" language="en-us" />

media:subTitle

Not yet available. Optionally, subtitles can be included if available and will be implemented once ready.

One or more subtitle files for the video.

Flags:

Flag	Required	Description
href	Required	The URL of the subtitle file
lang	Required	The language of the subtitle file in ISO 639-2 format (3-letter country code)

Example:

<media:subTitle lang="en-us" href="http://www.example.org/cdn/subtitles/subtitle.srt" />

dcterms:valid

Optional, not supported at this time. Please include if necessary and we will implement it once available.

The validity period for the video. The video will not be displayed to the user unless it is within the validity period. The video will only be displayed to the user during the validity period.

This field conforms to the ISO 8601 format: {YYYY}-{MM}-{DD}T{hh}:{mm}:{ss}+{TZ}. E.g.: 2015-11-11T22:21:37+00:00

Example:

<dcterms:valid>

start=2016-07-13T09:42:31+00:00;

end=2016-07-13T09:42:31+00:00;

scheme=W3C-DTF

</dcterms:valid>