Change Notes

2007/08/27 - Created from version 1.0 and all attributes were changed to elements.

2008/06/09 - Modified to include additional optional elements

Namespace declaration

The namespace for Product RSS is defined to be: http://www.buy.com/rss/module/productV2/

For example:

<rss version="2.0" xmlns:product="http://www.buy.com/rss/module/productV2/">

Description

"Product RSS" is a new RSS module that supplements the enclosure capabilities of RSS 2.0. RSS enclosures are already being used to syndicate featured products and their images. Product RSS extends enclosures to handle specific Buy.com product information as individual elements of data so the consumer of the feed can reformat or use the information the way they desire.

Primary Elements

<product:sku> is a sub-element of <item>, and is the Buy.com product SKU for the <item>

<product:price> is a sub-element of <item>, and is the Buy.com purchase price the <item>

<product:description> is a sub-element of <item>, and contains a text only description of the product referenced in the <item> element.

<product:imagelink> is a sub-element of <item>, and contains the URL to the image of the product referenced in the <item> element.

Optional Elements

<product:listprice> is a sub-element of <item>, and is the retail list price of the product referenced in the the <item> element.

<product:shipping> is a sub-element of <item>, and is the Buy.com default shipping price for a single unit of the product referenced in the the <item> element. This is a string representation of the shipping price, so it will contain the text "FREE" if the product qualifies for free shipping.

<product:shipcharge> is a sub-element of <item>, and is the Buy.com default shipping price for a single unit of the product referenced in the the <item> element. This is a numeric representation of the shipping price, so it will not contain any letters or symbols. Zero (0) means the product qualifies for free shipping.

<product:rebate> is a sub-element of <item>, and is the largest of any rebates available for a single unit of the product referenced in the the <item> element. This is a numeric representation of the largest rebate available, so it will not contain any letters or symbols.

<product:pricebeforerebate> is a sub-element of <item>, and is the Buy.com price before applying any rebates that might be available for a single unit of the product referenced in the the <item> element. This is a numeric representation of the largest rebate available, so it will not contain any letters or symbols.

<product:priceafterrebate> is a sub-element of <item>, and is the Buy.com price after applying the largest single rebates that might be available for a single unit of the product referenced in the the <item> element. This is a numeric representation of the largest rebate available, so it will not contain any letters or symbols.

<product:rank> is a sub-element of <item>, and is the sequence order from 1 to n that the items in this feed should be displayed.

<product:shorttitle> is a sub-element of <item>, and a shorter alternative to the product title.

Examples

1. A recently promoted product on the Weekly Deals page, using the RSS 2.0 <enclosure> element and the use of the Buy.com Product RSS module.

   <?xml version="1.0" encoding="utf-8"?>
   <?xml-stylesheet type='text/xsl' href='rsspretty.xsl' version='1.0'?>
   <rss 
       version="2.0"
       xmlns:p="http://www.buy.com/rss/module/productV2/"
       xmlns:cf="http://www.microsoft.com/schemas/rss/core/2005">
   	<channel>
   		<title>Buy.com - Find a Best Buy on Weekly Deals & Sale Items</title>
   		<link>http://www.buy.com/rss/feed.asp?loc=62329&grp=2</link>
   		<description>Featured  Weekly Deals  Products</description>
   		<language>en-us</language>
   		<docs>http://www.buy.com/rss/default.asp</docs>
   		<image>
   			<title>Buy.com</title>
   			<url>http://ak.buy.com/buy_assets/corp/buy_logo.gif</url>
   			<link>http://www.buy.com</link>
   		</image>
   		<cf:treatAs>list</cf:treatAs>
   		<cf:listinfo>
   			<cf:sort ns="http://www.buy.com/rss/module/productV2/"
   			 element="price" data-type="number" label="Price" default="false"/>
   			<cf:sort ns="http://www.buy.com/rss/module/productV2/"
   			 element="rank" data-type="number" label="Rank" default="false"/>
   		</cf:listinfo>
   		<item>
   			<title>[Product Title]</title>
   			<description>[HTML Description of Product]</description>
   			<link>[Link to product page at Buy.com]</link>
   			<pubDate>Mon, 09 Jun 2008 08:00:00 GMT</pubDate>
   			<enclosure url="[Link to product image]" type="image/jpeg"/>
   			<p:sku>999999999</p:sku>
   			<p:price>89.99</p:price>
   			<p:shipping>FREE</p:shipping>
   			<p:shipcharge>0.00</p:shipcharge>
   			<p:listprice>229.99</p:listprice>
   			<p:rebate>20</p:rebate>
   			<p:pricebeforerebate>109.99</p:pricebeforerebate>
   			<p:priceafterrebate>89.99</p:priceafterrebate>
   			<p:description>[Text only description of product]</p:description>
   			<p:imagelink>[Link to product image]</p:imagelink>
   			<p:rank>1</p:rank>
   		</item>
     </channel>
   </rss>