Bing Video Feed Guidelines

noteNote
Bing supports the video extension to the XML Sitemap protocol to discover and index your videos, but you get the best results using the mRSS format which is described below.

If your site contains video content, we recommend you provide video feeds to Bing which ca be in addition to any generic XML Sitemaps or RSS feeds you have. A video-specific feed can be a very effective supplement to the usual video discovery mechanisms in that it can make sure Bing knows all of the video-related content, that is, not just the URLs that are hosting video, but also the rich meta data information of the video such as title, thumbnail location, video location, and so on.

All you need is a suitable feed for your site according to the requirements detailed below. We've also included some examples at the bottom of the page to help you better understand the required format.

Once you have create the feed or feeds, you can submit them using the Sitemap feature. Alternatively, you can email the feed location or locations to Bing Content Feed Support.

noteNote
For the partners who have provided feeds to us, please note we also support the old feed format version, but highly recommend you to update to the new guidelines listed below.

Bing Video Feed Types and Requirements

We suggest you use Bing Media format to conflate your video content following these guidelines. Alternatively, if you have existing video-specific Sitemaps or Yahoo mRSS, you can also use them – depends on which is more convenient for you. You can find the formats we support in our blog post here.

There are three types of video feeds we currently support: full back-catalog feeds (aka “full feed”), incremental update feeds (aka “incremental feed”), and expire feeds. They are defined as follows,

  • Full Feed is used to ensure Bing is able to fetch and index all partner videos with the right metadata. This feed is generally processed once for initial indexing, but should be kept up to date with all videos that should be included in Bing.
  • Incremental Feed is used to provide updated video content. Here you should specify the update frequency, such as hourly, daily, or weekly. You should add <changefreq>daily</changefreq> to figure out update frequency in the beginning part - site information. The size of each incremental feed should be limited to 10MB max. We suggest that you can archive all incremental files in one summary page and add a new one if the size reaches limitation.
  • Expire feed is used to identify published videos that have expired and need to be removed from the Bing index. The Expire feed should only contain the latest expired videos. Only the <link> field is required in the expire feed.
    noteNote
    The ideal method to delete videos is to ensure that the <expireDate> tag is included in the original feed read by Bing. This value should be the date you want Bing to pull the video out of the search results. However, it is recognized that not all content expiration is known at time of publishing, so the expire feed is available for removing videos that have no specified expire date to avoid search result serving expired video to users.

Bing video feed tags:

Your feed must include the required information for each video: title, playpage URL, publish date, description, thumbnail URL and the raw video URL or URL of player. We cannot guarantee your videos in search results if these six kinds of information cannot extract.

Tag name
Attributes if any:
* Required attributes
Description Example

< title>


Specify the title of the video. The appropriate title depends on the domain in which the video is published.

<title>30 Rock - Sandwich Day</title>

<link>

The URL that is rendered for the play page when a user actually watches the video.

<link>http://www.contoso.com/video?vid=12345</link>

<pubDate>

The date when the video was first published on your web site.
Format: Day, DD MM YYYY HH:MM:SS ZZZ. See RFC 822 for more information.

<pubDate>Wed, 26 Mar 2008 18:20:45 PST</pubDate>

< description>

A short description of the video.

<description>Liz ends her date with Floyd in a high note.</description>

<thumbnail>

URL to a thumbnail or image that you want to represent your video in the Bing results page. For best results, image should be at least 300 pixels (width).

<thumbnail url="http://www.contoso.com/video/123.jpg" width="300" height="88"/>

<content>
Attributes:
• url*
• type*
• height*
• width*
• duration* (in seconds)
• medium, lang, filesize, bitrate

The URL to the actual video media (if available). Otherwise you can add the url of player.

The media can be in many formats, Windows Media, MPEG, Flash, Real, QuickTime, etc.

<content url=" http://media.contoso.com/content/12345.mp4" type="video/mp4" medium="video" height="240" width="340" duration="243" lang="en" fileSize="5000124" bitrate="432"/>

In addition to the parameters mentioned above, the following tags are also recommended.

Tag name
Attributes if any:
* Required attributes
Description Example

<category>

The category of the video. You can provide the categories of your site, but please make sure the category name is easy to understand and separate multiple category names by comma.

<category>Entertainment</category>

< keywords>

A list of keywords you use to identify the video.

<keywords>tags, associated, with, video, comma, separated</keywords>

<embedHtml>

Attributes:
• allowed

Embed HTML codes for embedding video in a webpage. Specify attributes "allowed" to show whether this video is permitted to embed or not, default is "yes".

 

<embedHtml allowed="yes">&lt;embed src="http://www.contoso.com/ 12345.swf"&gt;&lt;/embed &gt;</embedHtml>

<viewCount>

The number of times the video has been viewed on your site.

<viewCount>200</viewCount>

<restriction>

Attributes:
• relationship*
• type*

Indicates that the video is only available for playback in a restricted set of countries. Without this, the video is assumed to be available worldwide.

The type attribute is the type of restriction that the media can be syndicated (“country” or “uri”). See ISO 3166 for more information on country codes.

<restriction relationship="allow" type="country">US, CA</ restriction>

<rating>

Specifies whether the video is adult in nature, default is nonadult:
adult: If the video includes sex or nudity.
nonadult: If the video does not include sex or nudity.

<rating>nonadult</rating>

<expireDate>

The date when you would like the video to no longer be seen in the results page.

If using <expireDate>, specify the date in the following format: Day, DD MM YYYY HH:MM:SS ZZZ. See RFC 822 for more information.

<expireDate>Wed, 26 Mar 2008 18:20:45 PST </ expireDate>

<payment>

Attributes:
• type*
• price*
• currency*

This element should be included if payment is required for rental, purchase price, or subscription price. If payment is required to view, include price for viewing video. Set type = rent, buy, or free (default). Price and currency is set if it is rent or buy option.

<payment type="rent" price="10.00" currency="USD" />

 

Example of a complete video feed document:

Here’s an example of the Bing video feed. You can start with this template to build your own feed. For simplicity, you can also download any of the following templates: Full Feed, Incremental Feed, Expired Feed.


<?xml version="1.0" encoding="utf-8" ?>
<rss version="2.0" xmlns:bing="http://bing.com/schema/media/">

<channel>

<!-- Feed Description Section - add some information to describe this feed.-->
<site>Contoso.com</site>
<webMaster>webmaster@contoso.com</webMaster>
<feedType>incremental</feedType>
<lastBuildDate>Wed, 26 Mar 2014 18:20:45 PST</lastBuildDate>
<changefreq>daily</changefreq>

<!-- For each video, create an item element.-->
<item>
<!-- Required tags. -->
<title>Firefly - Serenity</title>
<link>http://www.contoso.com/video?vid=12345</link>
<pubDate>Wed, 26 Mar 2008 18:20:45 PST</pubDate>
<description>The crew transports passengers to another planet to sell salvaged goods.</description>
<content url="http://media.contoso.com/content/12345.mp4" type="video/mp4" medium="video" height="240" width="340" duration="243" fileSize="5000124" bitrate="432" />
<thumbnail url="http://www.contoso.com/thumbnails/12345.jpg" width="100" height="88"/>

<!-- Optional but highly recommended tags. -->
<keywords>tags, associated, with, video, comma,separated</keywords>
<category>tvshow</category>
<viewCount>200</viewCount>
<embedHtml>&lt;embed src="http://www.contoso.com/12345.swf"&gt;&lt;/embed&gt;</embedHtml>

<!-- Optional tags. --> <restriction relationship="allow" type="country">US, CA</restriction>
<rating>nonadult</rating>
<expireDate>Wed, 26 Mar 2008 18:20:45 PST </expireDate>
<payment type="rent" price="10.00" currency="USD"/>
</item>
<item><!-- more items --></item> </channel>
</rss>