Data Feed Specification

A data feed is a file made up from a grouping of attributes that define each one of your products in a unique way that allows customers to search and find your items.

Attributes are broken into two categories; required and recommended. While you only need required attributes for your item to get successfully processed, we highly encourage that you include all the recommended attributes whenever they are available. For example, Product ID is a required field for products in all categories.

Required Attributes

These attributes must be included in any data feed and any items missing these attributes will not be processed. For more detailed instructions for each attribute click on them.

Product ID [product_id]

A unique alphanumeric identifier for each item- e.g. your internal ID code.

IMPORTANT:
  • Once an item is submitted the unique id cannot change when you update your data feed.
  • Item identifiers must be unique within your account. If you have multiple feeds, items within different feeds must still have a unique identifier.
Type Alphanumeric characters
Text/Tab delimited 230987
XML <product_id>230987</product_id>

Product Model [product_model]

The manufacturer product number (the number which uniquely identifies the product to it's manufacturer). It is required to provide product model for all products except for those under the apparel and custom made goods categories. Please read more about providing strong identifiers.

Type Alphanumeric characters
Text/Tab delimited NQ128PA
XML <product_model>NQ128PA</product_model>

Product Name [product_name]

The name of the item should be placed here and as described in our editorial guidelines please don't include any promotional text. In addition, all symbols should adhere to their true meaning, for example, do not use the @ symbol to replace the letter "a".

Type Text, that should be not longer than 70 characters
Text/Tab delimited HP Pavilion DV7-1211TX NQ128PA C2D T9550 2.66GHz, CHIPSET PM45, 4GB, 800GB,GF9600M GT WITH 512MB, 17", Wi-Fi, W7HP,1Yr
XML <product_name>HP Pavilion DV7-1211TX NQ128PA C2D T9550 2.66GHz, CHIPSET PM45, 4GB, 800GB,GF9600M GT WITH 512MB, 17", Wi-Fi, W7HP,1Yr</product_name>

Product URL[product_url]

This attribute is a direct link to your product URL. As our policies state that it is your responsibility to maintain the website associated with your account at all times. All your URLs must link directly to webpages about your products without pop ups or redirects to other pages. This includes landing pages requiring sign ups, passwords, or direct links to files/email addresses. Links should not contain raw ip addresses.

Type URL. (this must include the http:// portion)
Text/Tab delimited http://www.example.com/product.php?product_id=230987
XML <product_url>http://www.example.com/product.php?product_id=230987</product_url>

Product Price [product_price]

Only items with fixed prices are allowed in Product Search; items with variable prices such as plane tickets or auctions are not valid. For items sold in bulk quantities the price for the lowest purchasable number of items must be defined in this attribute (not the per unit price) as described in our policies. All submitted prices must exactly match the price displayed on your website and include all applicable taxes and charges except shipping. Please do not provide any currency with the price (e.g. 15.00 AUD), As an UK Site, we assume that the currency is AUD (UK Dollar).

Type Number
Text/Tab delimited 315.75
XML <product_price>315.75</product_price>

 

Recommended Attributes

Product Description [product_description]

This text describes each item. As laid out in our policies you may not use promotional or boiler plate text, such as "Free Shipping" or "Click Here Now".

Type Text. Include as much text as is necessary to accurately describe the item. You can submit up to 10,000 characters. The description can be in HTML too.
Text/Tab delimited This teddy bear is fuzzy and cuddly. The bear is yellow with with white paws and stuffed with high quality hypoallergenic synthetic cotton.
XML <product_description>This teddy bear is fuzzy and cuddly. The bear is yellow with with white paws and stuffed with high quality hypoallergenic synthetic cotton.</product_description>

Manufacturer Name [manufacturer_name]

The brand / manufacturer company name of the product. It is required to provide for all products except for those under the apparel and custom made goods categories.

Type Text
Text/Tab delimited Toshiba
XML <manufacturer_name>Toshiba</manufacturer_name>

Category Name [category_name]

This describes the overall category of the product. For example, if your item is a laptop / notebookit might be in the category of "Laptops". Ideally, please match the product to our own taxonomy shown here.

Type Text. You may include multiple product types if its appropriate for your item. Separate by a comma for tab-delimited; Include multiple <product_type> attributes for XML.
Text/Tab delimited Laptops
XML <category_name>Laptops</category_name>

Image URL [image_url]

This is the URL of an associated image for a product. Please use full size images (250x250 pixels or larger), not thumbnails. Please do not include logos in images. Including valid images is important for users and merchants, we strongly recommend you include this attribute if you have an image for your products. If you do not have an image for your product leave this attribute blank.

Type URL. (Must include the http:// portion.)
Text/Tab delimited http://www.example.com/images/product23873.jpg
XML <image_url>http://www.example.com/images/product23873.jpg</image_url>