The easiest and most comfortable way of getting your products listed on PriceRunner is by sharing your products with us through a feed. Simply upload your product catalog to a server and send us the link so we can import it. The majority of e-commerce platforms have out of the box solutions for this and are usually included in their standard solution.
A product feed is a quick and effective way of sharing your product information with us. It often takes between just a few seconds and a minute for our system to process the information, and you have complete control of what is displayed. If you do not have a product feed, PriceRunner can collect all the information directly from your site. This solution is more time and resource-intensive, and if you make any changes to your site there is a risk that your products will disappear from PriceRunner. Please contact us to discuss the most appropriate solution for your particular site.
PriceRunner always strives to display correct and complete information. You should therefore try to update the data in the feed often and include all relevant information.
Bulk pricing is not accepted. If you have a specific price for bulk buys, such as four of a product, the price for purchasing a single product should still be shown in the price file, regardless of how common bulk buying is amongst your visitors.
If you have any questions about the price file, please do not hesitate to contact us.
The file should be placed at an HTTPS or FTP address from which we can retrieve it. If you have blockages at IP address level, you must ensure that PriceRunner's IPs have access.
Refrain from using timestamps or other information that will change the URL of the feed as this will cause your products to disappear from PriceRunner.
In order for PriceRunner to optimize update routines and display the most recent version of your product catalog with prices and item availability, we highly encourage the last-modified HTTP response header to be provided and serviced. The header indicates the date and time the product feed was last changed. By servicing the date and time of this header PriceRunner can check for updates more frequently.
Use one of the following encodings for the price file:
UTF-8, UTF-16, ISO-8859-1, Windows-1252
We can handle the majority of formats. The most common are: TEXT/CSV, XML and JSON. Note that the price file cannot be in Excel or any other non-text format. To make our processing and your updates run faster, compress your feed using gzip/zip.
In the case of a CSV feed:
The data must be structured in rows and columns, where one row represents a product and each column consists of fields with product information.
Each field or column must be separated by a particular separator. Recommended separators are tab, pipe, semicolon and comma.
Use "field qualifiers" at the start and end of each field. Please note that this character may not occur within a field. Recommended “field qualifiers” single ( ‘ ‘ ) or double ( “ ” ) quotation marks
Below is a list of the columns recommended for successful listing on PriceRunner. The order and title is unimportant (provided that they are comprehensible).
SKU/id
Name
Price
Shipping costs
Stock status
Delivery time
Manufacturer
EAN/GTIN
Manufacturer SKU / MPN
URL
Image URL
Category
Description
Condition
Sale Price
Sale Price Effective Date
Color
Size
SizeSystem
AdultContent
AgeGroup
Bundled
EnergyEfficiencyClass
Gender
GroupId
Material
Multipack
Pattern
Use SKUs as IDs where possible. Since SKUs are unique, they can also help prevent you from accidentally reusing IDs which would result in products being discarded.
Any variant or model of a product should be clearly stated. PriceRunner's search engine and filters work using the information in this field. Try to use keywords you want to be found for.
Your product name will be used to match your product to our products and user’s search. Include the important details that define your product.
Put the most important details first. Users will usually see only the first 70 or fewer characters of your title, depending on screen size.
Use keywords. Keywords will help connect your product with a user's search and help the user recognize what you’re selling. Your keywords could include these types of product details:
Dont include info about discounts, sales or stock info in the name.
The product price including VAT. The currency should be stated. Use a comma or a period as the decimal marker.
The product's shipping cost. Shipping cost needs to combine all shipping-/order costs for the consumer, like for example environmental surcharge, freight surcharge, handling surcharge, packaging fee etc.
As a starting point, there must be a buy/order button so that the consumer can buy or order the product to show the product on PriceRunner. If the product cannot be purchased/ordered online or offline at all, it can’t be included in your product feed.
We don’t distinguish if the product is in local or remote storage by the merchant. Your stock status in the product feed should always be based on your online storage status, and cant for example show the stock status for one of your offline stores. However, we allow chain stores to display their offline prices as long as they are in stock in their offline stores, but the products must be tagged as "out of stock" in your product feed to us.
Pre-order products can not be tagged as "in stock", use "pre-order" or "out of stock".
"in stock"/"out of stock" or Yes/No or number of products in stock.
The promised delivery time from the time of the order in the number of days. Its important that the delivery time in the feed corresponds to the info on your site.
The product manufacturer. Used in our filters.
Manufacturer's unique article number, used by us for matching products.
EAN code. Unique barcode number. Used by us to automatically match many product types and make the products searchable in the barcode scanner in our app.
URL to the product in your shop. It can also contain tracking parameters for analysis tools such as Google Analytics.
URL to the product image. Use a static URL. The URL you submit should not be changed unless the actual image is moved or replaced. For example, do not use URLs with timestamps, cache values or parts that can be changed each time you generate feed data. A change to the URL will result in download and reprocessing. The CMYK format is not supported.
Example: https://www.yourstore.com/product1.jpg
Preferable images between 700x700 and 2000x2000px
No watermarks on images
No placeholder images
Use the specific colour for colour versions
Use the full "breadcrumb information". Wherever possible, we recommend you to include more granular categories as it classifies your product more precisely. For example, Shoes > Sport Shoes > Running Shoes.
Remember not to mix up different product types within the categories. One example is to avoid adding accessories for a coffee machine to the same category as the machines themselves.
Use > to separate multiple levels in a category. Also, include a space before and after the > symbol. For example: Clothing > Women > Dresses.
For gender-specific products (e.g. clothes and perfume), it is important to divide them up into Women, Men and Children. Our filters are partly based on the category names.
Detailed information about the product. The more relevant specifications about the product, the better. PriceRunner's search engine and filters work using the information in this field. Try to include the keywords you want to be found for, maximum 30 words.
The condition of your product at time of sale.
We support the following values:
When including this detailed product data in your feed, you should do it for each variant of your product whenever possible. For example, if you are selling a shoe in 7 different sizes, the shoe should be included 7 times in your product feed, each with its own size attribute, unique EAN/GTIN value, unique SKU, and so on.
The product sale price including VAT. The currency should be stated. Use a comma or a period as the decimal marker.
Keep empty if the product is not on sale. Information in this column will override your original Price column.
The length of your sale period. When you specify the sale price effective date (in combination with a sale_price attribute), we can display your sale price and the sale period directly in your listings.
The sale price effective date can be specified in several ways, and you can define it with a specific time.
If the time is not specified on your product offer, the sale price will start at 00:00 (midnight) on the start date and end at 23:59 on the end date (UTC).
Your product’s color(s)
Your product’s size
The country of the size system used by your product
Indicate a product includes sexually suggestive content (yes/no)
The demographic for which your product is intended
Indicates a product is a merchant-defined custom group of different products featuring one main product (yes/no)
Your product’s energy label
The gender for which your product is intended
ID for a group of products that come in different versions (variants)
Your product’s fabric or material
The number of identical products sold within a merchant-defined multipack (yes/no)
Your product’s pattern or graphic print