Listings

Here are all the technical specifications that you should meet when listing your products on PriceRunner. If you have any questions, the PriceRunner Operations team will be happy to help you.

Basic feed requirements

A data feed is a text format file containing all product information. For us to be able to use the feed it has to fulfill the below requirements:

  • Text format: The file has to be in text format, such as .xml, .txt, .csv, .html, .php or .asp. Please note that the data feed cannot be submitted in Microsoft Excel .xsl format or any other non-text formats.
  • FTP or HTTP address location: PriceRunner requires an FTP or HTTP address location from which to collect your file (ftp://pricerunner:password@ftp.homepage.com or www.homepage.com/pricerunner.csv). This will be imported on a daily basis. If you don't have a server where you can post the data, please contact PriceRunner Operations and we'll help you find other ways of making your feed accessible to us.
  • Keep the feed URL and feed name unchanged: Don't include dates, times or other naming conventions in the URL or feed name. The URL and feed name should always remain the same.
  • Use one of the following encodings for the feed: iso-latin-1, iso-8859-1 or utf-8.
Additional requirements
  • Make sure that the data feed contains current prices.
  • Don't include any HTML markup within the data feed, as this will delay the processing of the feed and your listing on PriceRunner.
  • Check category specific requirements (see below).
  • Please make sure your feed has a minimum of 50 products. Any fewer, and your feed will be classed as 'limited', which may cause an error or for your feed to be deactivated. Any questions, your account manager will be happy to help.
Field specification

Below is a list of all the information fields that can be contained in the feed. Please note that:

  1. The order in which these fields are shown is not the order they should appear in the feed. Please follow the 'sample product feed' provided for the preferred feed structure.
  2. The first 8 fields below are REQUIRED, and are marked in bold.
  3. The 6th, 8th and 18th fields are required for the auto-matching of products.
  4. The 10th field (ISBN) is required for book retailers
  5. The 11th and 12th fields are very important for 'free text' products like clothing and jewellery. We don't compare free text products with the cheapest price first; instead, we display them in a grid or list view.
Field Description Example

1 Category

Product category

  • Always include the category information to avoid delays in the matching process.
  • Try to use the same categories that you see on PriceRunner so that we can match your products into our database quickly and easily.
  • Make the category names as descriptive as possible. Use 'Mobile Phone Accessories' rather than 'Accessories' and identify your product by type, for example: TVs, Digital Cameras, Freeview Boxes.

Digital Cameras

2 SKU

Unique product ID (usually the one used on your website)

  • 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 must not be used for multiple products as this results in inaccurate product matches.

BFC105

3 Price

Your product price (Separated by a dot or a comma)

  • The price should exclude shipping cost.
  • It should exclude tax in the United States.
  • But it should include tax (VAT) in Europe.
  • The price you list must be the price the consumer pays you, not the price after the mail-in-rebate (MIR).
  • If you have instant rebates lowering the price the consumer pays at checkout, input the actual price paid at checkout.

646.77

4 Product URL

The URL to the product on your website

http://www.x.com/
store/product.html

5 Product name/model

Product name and model

  • If the product is an accessory for another product, please include in the name. For example: 'Battery for Nokia 6230'

Powershot SD300

6 Manufacturer SKU (MPN)

Unique product ID used by the manufacturer

  • This information increases our matching speed significantly and is essential for computer products.

V11H187020

7 Manufacturer

Manufacturer name (product brand)

  • The manufacturer name helps use the manufacturer SKU in our matching process.

Sony

8 EAN or UPC

Unique universal product code

  • The product code is used to identify a product and its manufacturer, and is a required field for auto-matching products.
  • The UPC is a 12-digit number used to identify products in the United States.
  • The EAN is a 13-digit number used to identify products in Europe.
  • This information makes listings much more timely and accurate.
  • The EAN/UPC number can also be used as the SKU (see point 2 above).

012569732162 (UPC)
or
4975769285394 (EAN)

9 Product state

Condition of the product (new, refurbished, open box)

  • We only accept new products in feeds so please remove refurbished products.

New

10 ISBN

The ISBN number of a book

  • This is a required field for book retailers.

0563389532

11 Description

Description of the product

  • This is particularly important in our 'free text' categories like clothing, jewellery, toys etc.
  • It helps customers can search products by their description on PriceRunner.

Long sleeve zip-neck sweater. 100% cotton.

12 Graphic URL

The URL to an image of the product on your site or server

  • The URL should be in gif or jpg format.
  • The standard image size on PriceRunner is at least 120 pixels wide, up to approximately 300 pixels. Always provide the largest available image.
  • Only provide links that go to real product images.
  • This is particularly important in our 'free text' categories like clothing, jewellery, toys etc.

http://www.x.com/
images/product.jpg

13 Retailer message

You can include a message next to your logo

  • You can tailor different messages for each product - ideal for free shipping and other promotions.
  • Your message should be up to 125 characters in total.
Free shipping included

14 In stock

Available stock

  • These fields should be filled in with 'In stock' or 'Out of stock' depending on the product's availability.

In stock

15 Delivery time

Delivery time

  • This is the length of time from the order being placed to the time the product arrives with the customer.

Delivers in 5-7 days

16 Shipping cost

Shipping cost per product

  • Only include shipping cost in your feed if it's a flat rate, i.e. the shipping cost for a specific product is the same across the country.

10.00

17 Product code (PRID)

PriceRunner product ID (PRID)

  • The PRID is used to auto-match your products, letting you match your own products.
  • It can be found within the PriceRunner product page URLs:
  • http://www.pricerunner.co.uk/pl/2-1215526/TVs/Panasonic-Viera-TX-P50S10-Compare-Prices
  • Your account manager can provide you with a list of product IDs

1215526



Category specific requirements


If you'd like to list products within Women's Fragrances or Men's Cologne categories, you'll need to provide information on:

  • Sort: Eau De Toilette (EDT) or Eau de Parfum (EDP)
  • Size: in ml/oz e.g. 50ml
  • Refill: Yes or no
  • Manufacturer or brand: E.g. Donna Karan

Information outside your feed

If you don’t include shipping cost in your feed, please send us information on how you calculate shipping costs for your products e.g. free shipping above a certain amount.