Welcome to the Kelkoo Group Customer Service

Feed layout and fields details


Feed layout

The full list of fields is shown in the table below. The keys used are the following:

  • M are mandatory fields. Your offer will not be displayed on Kelkoo if these fields are not provided!
  • HR are Highly Recommended fields.
  • R are Recommended fields.
  • O are Optional fields.

For a better Product data feed integration, you are expected to respect the following:

  • The XML tag name (4th column of table below)
  • The order of the fields and the separator ‘Tab (t)’ in a text file
  • The data types:
    • Numeric : Only numeric values (no text or symbols), the surcharges are always separated by a dot and not a comma.
    • Date : The date must be formatted YYYY-MM-DD (ex : 2009-10-29)
    • Text : The text fields are limited in number of characters on the display. HTML is not allowed in your feed.

Fields details

For certain products, we need specific information such as the year or engine for a car or the size and colour for fashion and accessories categories. These fields must also be included in the feed.

Code Fevad (FR only) XML TAG DATA TYPE DESCRIPTION
135 M offer-id text The identifier of each article must be unique within your account . It can not be reused from one feed to another for the same country and the same language. If you have multiple feeds to a country, the identifiers of articles in the various feeds must also be unique.
If your codes only appear once in your inventory and comply with the requirements listed below, we recommend that you use for this attribute.
Warning: After submitting an article, you should not change their identifier when updating your data feed .
Warning: After submitting an article, you must not use its identifier to designate a different product later .
1 M title text Model name is limited to 80 characters. Example values: “EOS 400D”, or “Pull-over 100% wool”…
WARNING: Leaving the title field blank will mean the products are dropped by our process.
2 M product-url text Link to offer
URL of product’s page on your own site. The url must start with either “http://” or “https://”.
WARNING: Your offer will not be displayed on Kelkoo if your URL does not begin with http:// or https:// .
136 M landing-page-url text Link to offer

URL of product’s page on your own site. The url must start with either http:// or https://.
WARNING: The landing-page-url differs from the product-url field in the following way:
– Landing-page-url can’t integrate tracking – for instance: Lengow, Beezup, ShoppingFeed….
– Landing-page-url must be the final url seen by the user, and use the domain name of your shop.

3 M price numeric Net price for a typical customer.
Should not include possible reduction from a voucher code…(see dedicated fields below)
4 M brand text Product’s brand
5 M description text Description : product specifications. This is free text, limited to 300 characters (no use of html).
6 M image-url text Link to an image of the offer. Enter the largest image available on your site. They should not contain any watermark or logo of trade. It is recommended to provide images on a white background in jpg, png or gif..
Minimum recommended size 300 * 300.
Maximum size 6 600 000 pixels. Examples:
* image 1024 * 768 = 786 432 pixel = OK
* image 1600 * 1200 = 1 920 000 pixel = OK
* image 1518 × 5908 = 8 968 344 pixel = NOT OK
WARNING: Your image will not be displayed on Kelkoo if your URL does not begin with http://.
7 M ean text EAN code product, you guarantee a good matching at the product level. We support:
* UPC-E (6 digits)UPC-E (
* EAN-8/UCC-8/GTIN-8 (8 digits)
* UPC-A/GTIN-12 (12 digits)
* EAN-13/UCC-13/GTIN-13 (13 digits)
* ISBN-13 (13 digits for books)
* EAN-14/UCC-14/GTIN-14 (14 digits)
 If you cannot supply EAN codes for a specific reason, please contact your Kelkoo account manager or contact us here
8 HR merchant-category text Category :
Please fill with a relevant category name, as this field is used by our categorization process. For example, “Accessories” would be somewhat confusing for our process, while “Car accessories” or “PC tuning accessories” have a much more better chance to to fill the proper category…
9 M Feed layout and fields details fevad logo availability numeric Availability of a product. Accepted values are as follow :
1 = In Stock
4 = Preorder
5 = Available on Order
WARNING: Your offer will not be displayed on Kelkoo if this field is blank
10 M Feed layout and fields details fevad logo delivery-cost numeric Please provide here exact amount of your product’s delivery price. This applies only for delivery at home, not for withdrawal in a shop, warehouse, or else…
Warning: Your offer will not be displayed on Kelkoo if this field is blank.
11 HR Feed layout and fields details fevad logo delivery-time text Delivery time for product after order. Example values :
* x – y days
* x days
* x – y hours
* y hours
* x – y weeks
* y weeks
12 HR condition numeric Product status. Values expected:
0 = new (considered as default value)
1 = used
2 = refurbished
3 = open box
4 = returned
5 = damaged
6 = overstock
7 = liquidation
8 = unknown
9 = download (for pure-bits products)
10 = offers for professional
13 HR Feed layout and fields details fevad logo ecotax numeric Accepted values in this field (numeric):
* Offer is not affected by the environmental tax, indicate ‘0’
* Offer is affected but price does not include ecotax, specify the amount of the tax
* If the total price of the offer already contains environmental tax, enter ‘0’
14 HR Feed layout and fields details fevad logo warranty text Warranty applied to the offer. Typically expected values:
* x years + additional information
* x months + additional information
* check site
Ex. : 2 years manufacturer warranty, 6 months on site
15 R mobile-url text URL of your ‘mobile website’ containing details of the products and the ‘buy button’ to the corresponding product
16 R kelkoo-category-id numeric Unique ID for the category on Kelkoo. For example, in the category Air Conditioner and Fan, indicate catkkid 144801.]
17 M mpn text MPN code (manufacturer part number) for product. This helps with the integration of your product.
18 O sku text SKU code for product. This helps with the integration of your product.
19 R color text Color of the element. If the item is available in several colors, you can specify multiple colors, or use the delimiter “;”to separate each value.
20 R unit-price text Unit Price. Ex. 14,56 EUR/kg, 0.14 ? per 100 ml, per 100ml = 14.56
21 R offer-type texte Offer typeMainly 2 possible values : “single” or “bundle”.
22 O merchant-info text This field allows you to associate additional information to your brand (and not the product). Ex: company overview, points of sale, delivery. (limited to 150 characters, including spaces).
23 O currency text Ex. EUR, GBP, DKK etc.
24 O image-url-2 text Link to an alternative image of the offer. Enter the largest image available on your site. Each image must be different
25 O image-url-3 text Link to an alternative image of the offer. Enter the largest image available on your site. Each image must be different
26 O image-url-4 text Link to an alternative image of the offer. Enter the largest image available on your site. Each image must be different
Product features
27 R green-product text Ecological product. Indicate whether the product can be considered environmentally friendly (green):
1 = yes
0 = no (or empty = default value)
28 R green-label text Eco-label product. Ex: NF Environment, FSC, Fair Trade, …
29 O sales-rank numeric The classification of this product in terms of sales for the merchant. Lower numbers indicate they are most often sold.
30 O unit-quantity numeric The quantity of contents. Ex: package contains 8 units of toothpaste.
31 O made-in text The country where the product was manufactured.
32 O efficiency-class text Efficiency class of offer (A+++,A++,A+,A,B,C,D,E,F,G).
Shipping Method
33 R shipping-method text Method of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala …
34 R delivery-cost-2 numeric Alternativ delivery cost
35 R shipping-method-2 text Method of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala …
36 R delivery-cost-3 numeric Alternativ delivery cost
37 R shipping-method-3 text Method of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala …
38 R delivery-cost-4 numeric Alternativ delivery cost
39 R shipping-method-4 text Method of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala …
40 R zip-code numeric Postal code of the shop. Specific to the U.S., but necessary for all countries to allow geoloc
41 O stock-quantity numeric Number of products in stock
42 O shipping-weight text Weight of the item to shipping.
43 O payment-methods text List of methods of payment accepted (Visa, Paypal …)
Coupon
44 R voucher-title text Voucher title. Limited to 80 characters including spaces
45 O voucher-description text Voucher description. Limited to 180 characters including spaces
Required in France
46 O voucher-url text Voucher url. Link to your voucher page if available, or to your home page otherwise (limited to 20 characters including spaces).
Required in France
47 O voucher-code text Voucher code. Code users have to type to benefit from your site’s voucher. Limited to 20 characters including spaces.
Required in France
48 O voucher-start-date date Starting date for you voucher, formatted as YYYY-MM-DD (ex : 2015-01-29)
49 O voucher-end-date date End date for you voucher, formatted as YYYY-MM-DD (ex : 2012-11-29)
Crossed price / Sales
50 R price-no-rebate numeric Crossed prices. Price of your offer excluding rebate amount. Will be displayed scratched, next to effective price on rebates periods, and should be ignored otherise. Strictly numeric field (no alphabetical character or symbol…), with a dot as decimal separator (no comma).
51 O percentage-promo numeric Leave this field empty, Kelkoo will calculate it for you
52 O occasion texte Used to mark offers for special events like Christmas day, Valentine day, and so on.
53 O promo-start-date date Starting date for promotion. Formatted as YYYY-MM-DD (ex : 2015-10-29).
54 O promo-end-date date End date for promotion. Formatted as YYYY-MM-DD (ex : 2015-10-29)
User Agreement
55 O user-rating numeric Note to users. How users rated the product on the merchant site, 1 to 5, with 5 being best
56 O nb-reviews numeric Number of user reviews. The number of user reviews for this product on the merchant site
57 O user-review-link text The URL for the user reviews on the merchant site.
58 O video-link text The URL to a video of the product.
59 O video-title text The title of the video.
Fashion and accessories
60 R fashion-type text Kind of product (tee-shirt, shoes…)
61 R fashion-gender text Gender (Man, Woman, Children).
62 R fashion-size text Size of the product. EX: 36;37;38;39;42;45
19 R color text Color of the element. If the item is available in several colors, you can specify multiple colors, or use the delimiter “;”to separate each value.
Sofwtare and video-games
63 R software-platform texte Platform (i.e. XBox, PlayStation 4…)
Real estate (extra)
64 R property-type text Values :
* Buy
* Renting
* Flatsharing
* life annuity
* Rental investment
65 R property-source text Source. values :
* Particular
* Professional
66 R propery-garage-parking text Values :
* Garage
* With garage and parking
* With parking
* Without garage and parking
67 R property-city text Name of the city
68 R property-zip-code numeric
69 R property-number-rooms numeric Number of bedroom (ex: 1, 2, 3..).
70 R property-surface numeric Surface.
71 R property-publication-date date Date of publication. Format YYYY-MM-DD.
72 R property-tenure text Tenure.
Movies (extra)
73 R movie-director text Movie director like Steven Spielberg, Stanley Kubrick, etc.
74 R movie-actors text
75 R movie-format text (VHS, DVD, Blu-Ray).
76 R movie-region text Zone (e.g. 1 (USA), 2 (Europe), etc.)
77 O movie-languages text
78 O movie-release-date date Format YYYY-MM-DD.
79 R movie-media-rating texte Public. Ex: Interdit aux moins de 18 ans…
CD (extra)
80 R music-artist text
81 R music-media text
82 R music-genre text
83 O music-format text
84 O music-record-label text
85 O music-language text
86 O music-release-date date Format YYYY-MM-DD.
Books (extra)
87 R book-author text
88 R book-format texte Format (Poche, broché ..).
89 R book-edition text
90 R book-publisher text
91 O book-genre text
92 O book-language text
93 O book-release-date date Format YYYY-MM-DD.
94 O book-audience text
95 O book-number-of-pages text
Wine and Champagne (extra)
96 R wine-country text
97 R wine-year numeric
98 O wine-domain text
99 O wine-zone text
100 O wine-number-bottles numeric
101 O wine-capacity text
Tyre (extra)
102 R tyre-wet-grip text
103 R tyre-noise-class numeric
Mobile phone prepaid (extra)
104 R mobilephone-network text
105 R mobilephone-contract-type text
106 R mobilephone-contract-length text
107 R mobilephone-contract-total-cost numérique Prix total minimum par an (produits et abonnement combiné).
108 R mobilephone-tariff numerique Tarif mensuel du forfait.
109 R mobilephone-monthly-hours text
Cars (extra)
110 R vehicle-year numeric /td>
111 R vehicle-mileage numeric
112 R vehicle-vendor-type text Values :
* Professional
* Particular
113 R vehicle-city text
114 R vehicle-zip-code numeric
115 R vehicle-doors numeric
116 R vehicle-chassis text
117 R vehicle-engine-size numeric
118 R vehicle-transmission text Value :
* Manual
* Automatique
* Sequential
119 R vehicle-fuel-type text
120 R vehicle-bonus-malus numeric Bonus-malus.
121 R vehicle-all-fuel-types text Values :
* Petrol
* Diesel
* Gaz
* Electric
* Electric+Petrol
* Electric+Diesel
* Gaz+Petrol
* Gaz+Diesel
122 R vehicle-consumption-highway numeric
123 R vehicle-consumption-city numeric
124 R vehicle-consumption-mixed numeric
125 R vehicle-electric-consumption-highway numeric
126 R vehicle-electric-consumption-city numeric
127 R vehicle-electric-consumption-mixed numeric
128 R vehicle-co2-emmission numeric
Ticketing (extra)
129 R event-zip-code numeric
130 R event-city text
131 R event-location text
132 R event-start-date date Format YYYY-MM-DD.
133 O event-end-date date Format YYYY-MM-DD.
134 R event-genre text