Product data specifications

id

id

Required

Your product’s unique identifier

Format

Max 50 characters

Example

SKU123

• Use a unique value (e.g. SKU) for each product within your account

• The value of this id should always be kept the same (for the same product) when updating your data

• Please do not use the for a different product later

title

title

Required

Your product’s name

Format

Max 150 characters

Example

Adidas Retrorunner Sneakers - Blue - UK 7

• Accurately describe your product and match the title from your landing page

• Don’t include promotional text like "free shipping," all capital letters, or gimmicky foreign characters

• For variants : Include a distinguishing feature such as color or size

• Do not use HTML code

description

description

Required

Your product’s description

Format

Max 3000 characters

Example

If you want a sporty sneaker that you can wear casually or every day, then the adidas Retrorunner is perfect for you! Plus, the cool retro design will go great with all sorts of outfits.

• Accurately describe your product and match the description from your landing page

• Don’t include promotional text like "free shipping," all capital letters, or gimmicky foreign characters

• Include only information about the product.

• Don’t include links to your store, sales information, details about competitors, other products, or accessories

• Do not use HTML code

product_url

Required

The URL leading to your product's landing page

Examples

• https://www.store.com/product123.html?utm_source=kelkoouk&utm_medium=cpc&utm_campaign=kelkooclick

• https://www.tracking.com/3e5tFqs28

• Start with https

• This URL can be the landing page URL using your own domain name, or a tracking URL which will redirect to your landing page URL (eg. if you use tracking solutions like Lengow, Beezup, ShoppingFeed, TradeDoubler, etc., you can provide URLs from those tracking solutions into this field)

• If you use Google Analytics , it is strongly recommended that you add UTM parameters into your product's landing page URL, otherwise you may not be able to correctly track the traffic received from KelkooGroup. Here are some suggested values: utm_source=kelkoouk utm_medium=cpc utm_campaign=kelkooclick

landing_page_url

link

Required

Your product's landing page

Example

https://www.store.com/product123.html

• Must be the final URL seen by the user

• Must not include any tracking solution or any URL parameter

• Must use your own domain name

mobile_url

mobile_link

Optional

Your product’s mobile-optimized landing page when you have a different URL for mobile and desktop traffic

Example

https://m.store.com/product123.html?utm_source=kelkoouk&utm_medium=cpc&utm_campaign=kelkooclick

• Meet the requirements for the product-url attribute

• If you use Google Analytics, it is strongly recommended that you add UTM parameters into your product's landing page URL, otherwise you may not be able to correctly track the traffic received from Kelkoo. See description of the product-url field.

image_url

image_link

Required

The URL of your product’s main image

Example

https://www.store.com/images/image1.jpg

• For the image URL:

  • Link to the main image of your product

  • Start with http or https

  • Make sure the URL can be accessed by KelkooGroup

• For the image:

  • Accurately display the product you're selling

  • Use an accepted format: JPG, PNG, GIF, WebP

  • Don't include promotional text, watermarks, or borders

  • Avoid placeholder or generic images

  • Favor images on a white background

  • Use an image of at least 300 * 300 pixels

  • Don't submit an image larger than 20 megapixels

image_url_2

additional_image_link

Optional

The URL of an additional image for your product

Example

https://www.store.com/images/image2.jpg

• Meet the requirements for the image-url attribute

• Make sure the image is different than image-url or any other additional image.

image_url_3

additional_image_link

Optional

The URL of an additional image for your product

Example

https://www.store.com/images/image3.jpg

• Meet the requirements for the image-url attribute

• Make sure the image is different than image-url or any other additional image.

image_url_4

additional_image_link

Optional

The URL of an additional image for your product

Example

https://www.store.com/images/image4.jpg

• Meet the requirements for the image-url attribute

• Make sure the image is different than image-url or any other additional image.

price

Required

Your product's price

Format

Numeric value, without the currency

Example

75.95

• Accurately submit the product's price, and match with the price from your landing page

• Do not include possible reduction from a voucher code

• Do not include delivery or shipping costs

• If the price is discounted, use price-no-rebate to provide the price before rebate

price_no_rebate

Optional

Your product's price excluding the rebate

Format

Numeric value, without the currency

Example

20.00

• Will be displayed scratched, next to the effective price

• A discount percentage will also be displayed, automatically computed from price and price-no-rebate attributes.

ecotax

Required (for France only and for relevant categories)

Optional (for all other countries)

The amount of the ecotax for your product.

Format

Numeric value, without the currency

Example

4.70

• If your product has an ecotax attached to it, submit the ecotax into the "ecotax" field and do not include the ecotax in the "price" field.

availability

Required

Optional (if "stock_quantity" is provided)

Your product's availability

Format

Text, or numerical status

Supported values for numerical status

• 1 = In stock

• 2 = Stock on order

• 3 = Unknown (check site)

• 4 = Pre-order

• 5 = Available on order

• 6 = Not in stock

Examples

• 1

• In stock

• Out of stock

• 
  

• The preferred values for this attribute are the numerical statuses. But availability can also be given as text in English or your local language.

• If availability is blank and there is no stock_quantity provided, we consider the availability is unknown, which may result in limited or no exposure of your product.

stock_quantity

Optional

Required (if availability attribute is not provided)

The number of items in stock for your product

Format

Numeric

Example

25

• If you cannot fill the availability attribute, provide the stock quantity

• If availability is blank and there is no stock_quantity provided, we consider the availability is unknown, which may result in limited or no exposure of your product.

unit_price

Required for CH and DE by local laws or regulations (optional elsewhere)

Format

Text

Examples

• 7.59€ / 1l

• 18.27€ / 100ml

• 2.96€ / 1kg

• 0.23€ / 1ct

• Unit price for products where price per unit is required where unit is size, volume or weight.

• For example price per litre (1l) for beverages

• For example price per kilogram (1kg) for food products

• For example price per item (1ct) for multi-pack products

unit_price_measure

unit_pricing_measure

Required for CH and DE by local laws or regulations (optional elsewhere)

The "size" of your product as it is sold

Format

Numerical value + unit

Example

1.5kg

• The “size” of the product sold (without packaging)

• For a bottle of wine this could be "0.75l"

• For a bottle of perfume it could be "70ml"

• For a bag of flour it could be "1kg"

• For a multi-pack of 25 envelopes it could be "25ct"

unit_price_base_measure

unit_pricing_base_measure

Required for CH and DE by local laws or regulations (optional elsewhere)

The product’s base measure for pricing (e.g. 100ml means the price is calculated per 100ml)

Format

Numerical value + unit

Example

100g

• The “size” of the product the unit price should be based on.

• For example "1l" to calculate and show unit price as "xx eur / 1l"

• For example "100ml" to calculate and show unit price as "xx eur / 100ml"

• For example "1kg" to calculate and show unit price as "xx eur / 1kg"

• For example "1ct" to calculate and show unit price as "xx eur / 1ct"

on_sales

Required (for summer and winter sales period in France only)

Optional (for all other countries and for non-sales period items in FR)

Used to flag products on sales during the official sales period.

Format

Numeric (or leave empty)

Supported values

• 1 = product is on sales

• 0 (or empty) = not flagged as sales product

• This flag must be set to correctly present products on sale during the summer and winter sales periods in FR Products can be discounted at any time without setting this flag by providing price-no-rebate

promotion

Optional

Promotion for your product

Format

Max 80 characters

Examples

• 3 for the price of 2 today

• Spring promotion. 10% off at checkout with code SPRING2021

• To indicate a promotion for the product

• Promotion means something that may impact conditions or price of an order at checkout time like

  • "3 for the price of 2" deal

  • Promotional free delivery

  • Price reduction by giving a promotion (discount) code

brand

brand

Required (for all new products, except movies, books)

Your product’s brand name

Format

Max 70 characters

Example

Apple

• Provide the brand name of the product generally recognized by consumers

• Only provide your store name as the brand in case you manufacture the product, or your product falls into a generic brand category. For example, you could submit your store name as the brand if you sell white label products or customized jewelry

• If the product doesn’t have a brand, submit the manufacturer or supplier name under the brand attribute.

• Don't submit values such as "N/A", "Generic", "No brand", or "Does not exist".

gtin

gtin

Required (For all new products with a GTIN assigned by the manufacturer)

Your product’s Global Trade Item Number (GTIN)

Supported values

• 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 GTIN codes for a specific reason, please contact your Kelkoo Group account manager.

mpn

mpn

Required (Only if your new product does not have a manufacturer assigned GTIN)

Optional for all other products

Your product’s Manufacturer Part Number (mpn)

Syntax

Max 70 alphanumeric characters

Example

MPN1234

• Only submit MPNs assigned by a manufacturer

• Use the most specific MPN possible. For example, different colors of a product should have different MPNs.

merchant_category

product_type

Required

Product category that you define for your product

Format

Text

Example

Men > Men's Shoes > Casual Shoes

• Include the full category. For example, include Men > Men's Shoes > Casual Shoes instead of just Shoes

• Avoid generic category names. E.g. "Chair" without hierarchy or further details makes it difficult to correctly place the product

google_product_category

google_product_category

Optional

Google-defined product category for your product

Format

Text or Numeric

Examples

• 2505

• Toys & Games - Toys - Play Vehicles

• If you have Google product category for your product, provide it in addition to your own category set in merchant-category field.

• Include only one category

• Include the most relevant category

delivery_cost

Required

Your product's delivery price (shipping cost)

Format

Numeric value, without the currency

Example

1.99

• delivery_cost only applies for the cost for home delivery, not for withdrawal in a shop or warehouse.

• If there is a free delivery for your product, set delivery_cost = 0

• Depending on local laws or requirements from some channels, your product may not be displayed if this attribute is not properly filled.

delivery_time

Optional

The expected delivery time to ship your product to your customer

Format

Max 70 characters

Examples

• 2 days

• 2 to 5 days

shipping_weight

shipping_weight

Optional

The weight of the product used to calculate the shipping cost

Format

Numeric value + unit

Example

5kg

• If your delivery cost is based on weight, please include the shipping weight of your products and communicate relevant delivery cost rules to be applied to your KelkooGroup account manager.

condition

condition

Required if your product is not a new product

Optional for new products

The condition of your product at time of sale

Format

Text, or numerical status

Supported values for numerical status

• 0 = New (Default value)

• 1 = Used

• 2 = Refurbished

• 3 = Open box

• 4 = Returned

• 5 = Damaged

• 6 = Over stock

• 7 = Liquidation

• 8 = Unknown

• 9 = Download

• 10 = Offers for professional

Examples

• 0

• 1

• New

• Used

• The preferred values for this attribute are the numerical statuses. But condition can also be given as text in English or your local language.

age_group

age_group

Required for apparel items

Optional for all other products

The age group for which your product is intended

Format

Text

Examples

• children

• kids

• adult

• Use text saying "children", "kids", "adults" in English or in your local language

color

color

Required for apparel items

Optional for all other products

Your product's color(s)

Format

Max 100 characters

Example

brown

• If this product is available in different colors, submit one product for each different color

• If this product features several colors for this product, use delimiter “;” to separate each value

• Don't use a value that isn't a color, such as "multicolor", "various", "variety", "men's", "women's".

gender

gender

Required for apparel items

Optional for all other products

The gender for which your product is intended

Format

Text

Examples

• male

• female

• unisex

• Use text saying "male", "female", "unisex" in English or in your local language

material

material

Optional

Your product’s fabric or material

Format

Text

Examples

• cotton

• wool

• silk

• To indicate multiple materials for a single product, add a primary material, followed by up to 2 secondary materials, separated by the delimiter "/". For example, instead of "CottonPolyesterElastane", use "cotton/polyester/elastane"

size

size

Required for apparel items

Optional for all other products

Your product’s size

Format

Text

Examples

• XS

• 36

• 36;37;38

• If your product is available in several sizes, we recommend that you submit one product per size. However, you can indicate several sizes in the "size" attribute by separating each size using the delimiter ";".

made_in

Required for wine and spirits

Optional for all other products

The country where your product has been manufactured or produced

Format

Text

Example

France

green_label

Optional

The green label(s) or eco-label()s your product is certified with.

Example

• EU-Eco-regulation

• NF Environment

• FSC

• Fair Trade

• If your product has several labels, use the delimiter ";" to separate values, for example "EU-Eco-regulation; Fair Trade"

energy_efficiency_class

energy_efficiency_class

Optional

Your product’s energy label

Supported values

• A+++

• A++

• A+

• A

• B

• C

• D

• E

• F

• G

• Include the legally required energy label

year

Required (for spirits and wine only)

Optional (for all other products)

The year your product has been manufactured or produced

Format

Numeric

Example

2018

wine_region

Optional (for spirits and wine only)

The area (domain or region) of the product

Format

Text

Examples

• Alsace

• Dry Creek Valley

• Friuli-Venezia Giulia

• Languedoc-Roussillon

• Piemonte

• Veneto

• Use text in English or in your local language

wine_number_bottles

Optional (for spirits and wine only)

The number of bottles included in your product

Format

Numeric

Examples

• 1

• 6

wine_capacity

Optional (for spirits and wine only)

The capacity of your product

Format

Numeric + unit

Example

0.75l

tyre_wet_grip

Optional (for tyres only)

Wet grip rating for tyres

Supported values

• A

• B

• C

• D

• E

• F

• G

• For tyres, include the legally required energy label by using one of the supported values.

tyre_noise_class

Optional (for tyres only)

Noise class rating for tyres

Supported values

• A

• B

• C

• For tyres, include the legally required energy label by using one of the supported values.

format

Optional (for music, films & books)

The type of support of your product

Format

Text

Examples for music

• CD

• Vinyl

• Boxset

• Streaming

Examples for films

• Blu-ray

• DVD

• Streaming

Examples for books

• eBook

• Hardback

• Paperback

• Use text in English or in your local language

genre

Optional (for music, films & books)

The genre of your product

Format

Text

Examples for music

• Blues

• Hip-hop

• Country

• Electro

Examples for film

• Action

• Animation

• Bollywood

Examples for books

• Biography

• Children

• Fiction

• Use text in English or in your local language

seller

text

• Name of seller of the offer