‹ All supported channels
Kelkoo Feed Specifications
Monthly visitors
9 million
Headquarters
London, United Kingdom
International or Domestic
International
Year founded
1999
Ready to reach a whole new audience? Let us help you get your products listed on Kelkoo.
About Kelkoo
Kelkoo is a digital eCommerce advertising and price comparison shopping platform. The name of the company comes from a phonetic spelling of the French phrase “Quel coût?”, which essentially means “At what price?”.
How to create a Kelkoo feed
You will need to fill out the information in this contact form to begin the process of setting up your store and feed with Kelkoo
If you decide to submit your feed using an XML format, then the following recommendations will be helpful.
- The name of your file must be in the following format “'<sitename>_kelkoo_<countryprefix>.xml”
- Respect the name of the XML tags as shown in the Fields details table
- To validate your XML file, it is preferable to insert the contents of the text fields in a CDATA section
- The description often includes non-escaped specific characters such as &, >, or <. The CDATA section is not analyzed. Thus, we recommend using it if you do not take care to validate your XML Product data feed before sending it to us.
If you choose a text file, here are some recommendations:
- Name your file ‘<sitename>_kelkoo_<countryprefix>.txt’ and save it in UNIX format / DOS
- Use field separators to separate offers, the new line allows our system to distinguish between offers.
- You can use any type of field separator.
- Of course, the field separator should not be present within a same field (for example in the description). The tab will be the only field separator accepted for a the Kelkpack offer.
- All offers must contain the same number of fields. If a field is blank, the field separator must be present.
Required Kelkoo Fields with description of each field
Field Name | Description |
---|---|
title | Model name is limited to 80 characters. Example values: “EOS 400D”, or “Pull-over 100% wool”… Leaving the title field blank will mean the products are dropped by our process. |
product-url | URL of product’s page on your own site. The url must start with either “http://” or “https://”. Your offer will not be displayed on Kelkoo if your URL does not begin with http:// or https:// . |
price | Net price for a typical customer.Should not include possible reduction from a voucher code…(see dedicated fields below) |
availability | Availability of a product. Accepted values are as follow :1 = In Stock 4 = Preorder 5 = Available on Order Your offer will not be displayed on Kelkoo if this field is blank |
delivery-cost | 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…Your offer will not be displayed on Kelkoo if this field is blank. |
offer-id | 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. After submitting an article, you should not change their identifier when updating your data feed .After submitting an article, you must not use its identifier to designate a different product later . |
Optional Kelkoo Fields with description of each field
All of these fields are optional but some of them are highly recommended to use. Others are recommended and some are simply optional based on product characteristics.
Recommended Status | Field Name | Description |
---|---|---|
XML TAG | DESCRIPTION | |
Highly Recommended | brand | Product’s brand: just leave empty if not relevant… |
Highly Recommended | description | Product specifications. This is free text, limited to 300 characters (no use of html). |
Highly Recommended | image-url | 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 Your image will not be displayed on Kelkoo if your URL does not begin with http://. |
Highly Recommended | ean | 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) |
Highly Recommended | merchant-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… |
Highly Recommended | delivery-time | Delivery time for product after order. Example values :* x – y days * x days * x – y hours * y hours * x – y weeks * y weeks |
Highly Recommended | condition | 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 |
Highly Recommended | ecotax | 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’ |
Highly Recommended | warranty | 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 |
Highly Recommended | mpn | MPN code (manufacturer part number) for product. This helps with the integration of your product. |
Recommended | mobile-url | URL of your ‘mobile website’ containing details of the products and the ‘buy button’ to the corresponding product |
Recommended | kelkoo-category-id | Unique ID for the category on Kelkoo. For example, in the category Air Conditioner and Fan, indicate catkkid 144801.] |
Recommended | color | 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. |
Recommended | color | 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. |
Recommended | unit-price | Unit Price. Ex. 14,56 EUR/kg, 0.14 ? per 100 ml, per 100ml = 14.56 |
Recommended | offer-type | Offer type. Mainly 2 possible values : “single” or “bundle”. |
Recommended | green-product | Ecological product. Indicate whether the product can be considered environmentally friendly (green):1 = yes 0 = no (or empty = default value) |
Recommended | green-label | Eco-label product. Ex: NF Environment, FSC, Fair Trade, … |
Recommended | shipping-method | Method of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala … |
Recommended | delivery-cost-2 | Alternative delivery cost |
Recommended | shipping-method-2 | Method of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala … |
Recommended | delivery-cost-3 | Alternative delivery cost |
Recommended | shipping-method-3 | Method of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala … |
Recommended | delivery-cost-4 | Alternative delivery cost |
Recommended | shipping-method-4 | Method of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala … |
Recommended | zip-code | Postal code of the shop. Specific to the U.S., but necessary for all countries to allow geoloc |
Recommended | voucher-title | Voucher title. Limited to 80 characters including spaces |
Recommended | price-no-rebate | Crossed prices. Price of your offer excluding rebate amount. Will be displayed scratched, next to effective price on rebates periods, and should be ignored otherwise. Strictly numeric field (no alphabetical character or symbol…), with a dot as decimal separator (no comma). |
Recommended | fashion-type | Kind of product (tee-shirt, shoes…) |
Recommended | fashion-gender | Gender (Man, Woman, Children). |
Recommended | fashion-size | Size of the product. EX: 36;37;38;39;42;45 |
Recommended | software-platform | Platform (i.e. XBox, PlayStation 4…) |
Recommended | property-type | Values :* Buy * Renting * Flatsharing * life annuity * Rental investment |
Recommended | property-source | Source. values :* Particular * Professional |
Recommended | propery-garage-parking | Values :* Garage * With garage and parking * With parking * Without garage and parking |
Recommended | property-city | Name of the city |
Recommended | property-zip-code | Zip code |
Recommended | property-number-rooms | Number of bedroom (ex: 1, 2, 3..) |
Recommended | property-surface | Surface |
Recommended | property-publication-date | Date of publication. Format YYYY-MM-DD. |
Recommended | property-tenure | Tenure |
Recommended | movie-director | Movie director like Steven Spielberg, Stanley Kubrick, etc |
Recommended | movie-actors | Actors |
Recommended | movie-format | (VHS, DVD, Blu-Ray). |
Recommended | movie-region | Zone (e.g. 1 (USA), 2 (Europe), etc.) |
Recommended | movie-media-rating | Public. Ex: Interdit aux moins de 18 ans… |
Recommended | music-artist | Artists |
Recommended | music-media | Media |
Recommended | music-genre | Genre |
Recommended | book-author | Author |
Recommended | book-format | Format (Poche, broché ..). |
Recommended | book-edition | Edition |
Recommended | book-publisher | Publisher |
Recommended | wine-country | Country |
Recommended | wine-year | Year |
Recommended | tyre-wet-grip | Wet Grip |
Recommended | tyre-noise-class | Noise Class |
Recommended | mobilephone-network | Network |
Recommended | mobilephone-contract-type | Contract Type |
Recommended | mobilephone-contract-length | Contract Length |
Recommended | mobilephone-contract-total-cost | Total contract cost |
Recommended | mobilephone-tariff | Tarif |
Recommended | mobilephone-monthly-hours | Hours monthly |
Recommended | vehicle-year | Year |
Recommended | vehicle-mileage | Mileage |
Recommended | vehicle-vendor-type | Values :* Professional * Particular |
Recommended | vehicle-city | City |
Recommended | vehicle-zip-code | Zip code |
Recommended | vehicle-doors | Number of doors |
Recommended | vehicle-chassis | Chassis |
Recommended | vehicle-engine-size | Engine Size |
Recommended | vehicle-transmission | Value :* Manual * Automatique * Sequential |
Recommended | vehicle-fuel-type | Fuel Type |
Recommended | vehicle-bonus-malus | Bonus-malus. |
Recommended | vehicle-all-fuel-types | Values :* Petrol * Diesel * Gaz * Electric * Electric+Petrol * Electric+Diesel * Gaz+Petrol * Gaz+Diesel |
Recommended | vehicle-consumption-highway | Consumption details for highway driving |
Recommended | vehicle-consumption-city | Consumption details for city driving |
Recommended | vehicle-consumption-mixed | Mixed consumption details |
Recommended | vehicle-electric-consumption-highway | Consumption details for highway driving |
Recommended | vehicle-electric-consumption-city | Consumption details for city driving |
Recommended | vehicle-electric-consumption-mixed | Mixed consumption details |
Recommended | vehicle-co2-emmission | Emission |
Recommended | event-zip-code | Zip Code |
Recommended | event-city | City |
Recommended | event-location | Location |
Recommended | event-start-date | Format YYYY-MM-DD. |
Recommended | event-genre | Genre |
Optional | sku | SKU code for product. This helps with the integration of your product. |
Optional | merchant-info | 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). |
Optional | currency | Ex. EUR, GBP, DKK etc. |
Optional | image-url-2 | Link to an alternative image of the offer. Enter the largest image available on your site. Each image must be different |
Optional | image-url-3 | Link to an alternative image of the offer. Enter the largest image available on your site. Each image must be different |
Optional | image-url-4 | Link to an alternative image of the offer. Enter the largest image available on your site. Each image must be different |
Optional | sales-rank | The classification of this product in terms of sales for the merchant. Lower numbers indicate they are most often sold. |
Optional | unit-quantity | The quantity of contents. Ex: package contains 8 units of toothpaste. |
Optional | made-in | The country where the product was manufactured. |
Optional | efficiency-class | Efficiency class of offer (A+++,A++,A+,A,B,C,D,E,F,G). |
Optional | stock-quantity | Number of products in stock |
Optional | shipping-weight | Weight of the item to shipping. |
Optional | payment-methods | List of methods of payment accepted (Visa, Paypal …) |
Optional | voucher-description | Voucher description. Limited to 180 characters including spacesRequired in France |
Optional | voucher-url | Voucher url. Link to your voucher page if available, or to your home page otherwise (limited to 20 characters including spaces).Required in France |
Optional | voucher-code | Voucher code. Code users have to type to benefit from your site’s voucher. Limited to 20 characters including spaces.Required in France |
Optional | voucher-start-date | Starting date for you voucher, formatted as YYYY-MM-DD (ex : 2015-01-29) |
Optional | voucher-end-date | End date for you voucher, formatted as YYYY-MM-DD (ex : 2012-11-29) |
Optional | percentage-promo | Leave this field empty, Kelkoo will calculate it for you |
Optional | occasion | Used to mark offers for special events like Christmas day, Valentine day, and so on. |
Optional | promo-start-date | Starting date for promotion. Formatted as YYYY-MM-DD (ex : 2015-10-29). |
Optional | promo-end-date | End date for promotion. Formatted as YYYY-MM-DD (ex : 2015-10-29) |
Optional | user-rating | Note to users. How users rated the product on the merchant site, 1 to 5, with 5 being best |
Optional | nb-reviews | Number of user reviews. The number of user reviews for this product on the merchant site |
Optional | user-review-link | The URL for the user reviews on the merchant site. |
Optional | video-link | The URL to a video of the product. |
Optional | video-title | The title of the video. |
Optional | movie-languages | Languages |
Optional | movie-release-date | Format YYYY-MM-DD. |
Optional | music-format | Format |
Optional | music-record-label | Record label |
Optional | music-language | Language |
Optional | music-release-date | Format YYYY-MM-DD. |
Optional | book-genre | Genre |
Optional | book-language | Language |
Optional | book-release-date | Format YYYY-MM-DD. |
Optional | book-audience | Audience |
Optional | book-number-of-pages | Pages |
Optional | wine-domain | Domain |
Optional | wine-zone | Zone |
Optional | wine-number-bottles | Number of bottles |
Optional | wine-capacity | Capacity |
Optional | event-end-date | Format YYYY-MM-DD. |
What formats does Kelkoo accept (CSV, XML, API, etc)
Kelkoo accepts files in XML, TXT and CSV.
How to send your feed to Kelkoo
Kelkoo can receive feeds in several different ways:
HTTP transfer mode
To use this transfer mode, you must provide a URL where we can find your complete Product data feed.
For example: http://yoursite.fr/kelkoo.xml
In the case of large volumes of data, your http server must be set to allow the complete download of the Product data feed.
FTP transfer mode
If you want to submit your file to your FTP account, you must provide:
- The address / URL of your FTP server
- The name of the file(s) used, zipped if possible
- A login and a password
On demand, you have the possibility to host your file on a Kelkoo FTP server. We will communicate your login and password as soon as your Kelkoo FTP server account will be created.
FTP upload using Internet Explorer
- Type in the following URL including username and password: ftp://username:password@ftpkelkoo.kelkoo.net/(username/password need to be changed into the values provided by Kelkoo)
- The next step is to open a FTP site in Windows Explorer. Press Alt, click View, and then click Open FTP Site in File Explorer.
- You will then be prompted again for the username and password. Type in the provided values given by Kelkoo.
- After opening the FTP Site, you are ready to upload your file. This can be done by either drag and drop, or copy paste into the FTP folder from your local folder.
- Afterwards, either drag and drop or copy paste, you should see a confirmation that the file is being uploaded.
Need help in optimizing your feed and getting it to Kelkoo? We can help! Feel free to contact us.
Monthly visitors
9 million
Headquarters
London, United Kingdom
International or Domestic
International
Year founded
1999
Ready to reach a whole new audience? Let us help you get your products listed on Kelkoo.
Find out why the world's most prolific brands and online retailers choose Feedonomics.
Check out our success stories
Large Department Store
Find out how Impression Share skyrocketed by over 200% with a 117% increase in Revenue.
Automotive
Find out how our agency partners Subaru campaign generated over $1 million in sales within 4 months.