Product feed instructions

Basic feed requirements

A data feed is a text file containing all your product information. You need to provide your feed following all the below requirements.

  • Text format: The file has to be in text format, generally xml, txt, csv, html, php or asp. Unfortunately we can’t accept the data feed in Microsoft Excel .xls format or any other non-text formats.
  • FTP or HTTP address location: You will need an FTP or HTTP address location that we can collect your file from each day (i.e. ftp://pricerunner:password@ftp.homepage.com or www.homepage.com/pricerunner.csv.). If you don’t have a server where you can post the data then please contact the PriceRunner operations team to discuss other ways of sending us your feed. Please note we do not host feeds.
  • Keep the feed URL and name unchanged. Don’t include dates of updates or any other information in the URL. The URL and name must always be the same so we can match it.
  • Use one of these encoding formats for the feed: iso-latin-1, iso-8859-1 or utf-8.

Additional requirements

  • Make sure that the data feed contains the current prices.
  • Do not include any html markups within the fields in the data feed.
  • Please be aware that if you limit your feed to less than 80% of your online product inventory (which must be at least 100 products) then we may have to use a previous version of your feed. If the limited feed persists then we may have to deactivate your account. Please talk to your account manager if you have any questions on this.
  • The products you list must all be in new condition, we don’t accept refurbished, damaged or secondhand items.
  • If you’re listing fragrances then you’ll need to provide this information in the feed:
Sort EDT (eau de Toilette) or EDP (eau de Parfum) EDT
Size Size in ml/oz 50ml
Refill yes/no Yes
Brand Manufacturer/brand Donna Karan

Fields to include in your feed

There is a list and description below of the information fields that the feed should contain. Please note that:

  • Please follow the sequence and structure below and in the Sample Product Feed csv file precisely.
  • Some fields are MANDATORY and we won’t be able to list you without them. Some fields are RECOMMENDED and we strongly encourage you to include all of those to optimize your listing. There are also a couple of OPTIONAL fields which you can include if you wish.
  • If you don’t include a delivery cost in your feed then please contact the operations team or your account manager to advise how you calculate delivery costs for your products.
Field Description Example Inclusion
SKU

A unique product ID. Normally the one used on your website. Please note that:

  • The SKU must be unique and unchanged over time. If a product is removed from the feed, its SKU must not be reused for another product.
  • The SKU cannot be used for multiple products.
BFC105 MANDATORY
Price

The price you charge for the item. Comma or dot separated. The price must:

  • Exclude delivery cost.
  • Exclude tax in United States
  • Include tax (VAT) in Europe

Important – In case there are mail-in-rebates available for the product, the price you list MUST be the price the consumer pays, not the price after the MIR. If you have instant rebates then you must provide the actual price paid at checkout including the rebate in your feed.

646.77 MANDATORY
Manufacturer This information is important to help us to match your products. Sony MANDATORY
Product / Model Name If the product is an accessory for another product, it’s important that this is included in the name, for example “Battery for Nokia 6230”. Powershot SD300 MANDATORY
Category

To match your products as quickly as possible please use the same categories as PriceRunner.

The category names should be as descriptive as possible. A category name like “Accessories” or “Other products” makes it difficult for us to match the products. “Accessories mobile phones” is much easier for us to match correctly.

Digital Cameras MANDATORY
Product URL The URL to the product on your website. http://www.site.com
/store/product19.html
MANDATORY
Graphic URL

A URL to an image of the product on your site/server.

  • It has to be in gif or jpg format.
  • Standard image size on PriceRunner is between 120 and 300 pixels wide. Please try to include the largest possible picture.
  • This is especially important in non-comparison categories like clothing, jewellery, toys etc.
  • Only include links to real product images. Please exclude links that lead to a “no image” picture or similar.
http://www.site.com
/images/product19.jpg
RECOMMENDED MANDATORY FOR NON-COMPARISON CATEGORIES (eg clothes, shoes, beauty)
Manufacturer SKU

The unique product ID used by the manufacturer.

This information increases our matching speed significantly and is mandatory for Computing products.

V11H187020 RECOMMENDED MANDATORY FOR COMPUTING CATEGORY
Delivery Cost

Only include delivery cost if it’s not based on location.

If it can vary for each item based on location then please contact your account manager to explain how it’s calculated.

10.00 RECOMMENDED
Availability Stock availability, please use either “In Stock” or “Out of Stock” In Stock RECOMMENDED
Delivery Time Delivery time from time of order to product arriving with customer. Delivers in 5-7 days RECOMMENDED
Description A description of the product.
  • This is especially important in non-comparison categories like clothing, jewellery, toys etc.
  • Customers can search for products by description on PriceRunner so you’ll reach more customer if you include this.
Long sleeve zip-neck sweater. 100% cotton. RECOMMENDED
EAN or UPC

A unique universal product code to identify an individual item and the manufacturer.

  • The EAN is a 13 digit number to identify a product in Europe.
  • The UPC is a 12 digit number to identify a product in the US.
  • The EAN/UPC number can also be used in the SKU field if required.
012569732162 or 4975769285394 RECOMMENDED
Retailer Message

You can place a message next to your logo on your listings.

  • Up to 125 characters total.
  • By including this in the feed you can show a different message for each product which is great for free delivery promotions etc.
OPTIONAL
Product Code (PRID)

This is useful for you to match your own products.

The PriceRunner product code (PRID) can be found in the URL string

e.g. http://www.pricerunner.co.uk/pl/2-1215526/TVs/Panasonic-Viera-TX-P50S10-Compare-Prices has a product code of 1215526.

A list of product IDs is available from your account manager.

1215526 OPTIONAL

Product Feed FAQs

Which is the best product feed format to use?

We’re happy to receive your feed in any text format, most commonly xml, csv or txt files.

Can you work with any plug-ins/add-ins for the feed ie Magento?

No, unfortunately our systems don’t work with any type of plug-ins. We can accept Magento feeds as long as no plug-ins are used and they are in xml format.

Do you accept feeds through feed management companies ie ChannelAdvisor, Feed Optimise, Intelligent Reach, Fuse Pump?

Yes, we can accept feeds from any feed management company as long as they are in one of the required formats (xml, csv or txt).

Can you accept feeds in the same format as Google or any other similar partner?

Yes we can, but we do have slightly different mandatory fields to Google and some other partners so you’ll need to make sure they are all included. Please check the above instructions and the Sample Feed for more details. If you’re not able to provide all the mandatory information we can try to scrape your site but this isn’t always technically possible.

Can I exclude products from the feed that I send to PriceRunner?

It’s up to you to manage the feed you send to us but we recommend starting off with your full product range so we can optimise your account to find the sweet spots. In some instances we may be able to exclude certain categories for you but this will be on a case by case base. If we’re scraping your site to generate the product feed then we’re not able to exclude any products.

How and when can you do a product scrape of my site?

This depends on the structure of your website. It should only take two working days to do a test scrape so we can see whether it’s possible and two more working days to get your account live after that.

When is the feed uploaded onto PriceRunner?

All the product feeds on our site are uploaded between midnight and 4am each night. We’re only able to upload feed updates once a day as it does impact our site load time, which is why we do it at night. Unlike some comparison sites we use our own database to ensure we have the most accurate data but this does slightly limit our flexibility with the update time as we’re dealing with over 4 million products.

Product Feed Checklist

  • Check you’ve given the correct URL
  • Make sure all headers match the listings instructions and sample feed
  • Check that all mandatory fields are included
  • Make sure each mandatory field has data throughout the column
  • Check category information in your feed, make sure that categories are all separated clearly with the correct products in each one.

If you have any questions at all please contact your account manager.