Feed Fields¶

A set of required and optional fields defined by a feed for XML and TSV file formats are listed below.

TSV

Field	Description	Restrictions	Mandatory
vendor id	unique ad identifier	max. 64 chars	yes
seller name	your company name	max. 60 chars	no
title	product title	see title	yes
description	product description	description	yes
category id	category identifier	numeric, positive	yes
status	desired status (default ACTIVE)	ACTIVE,PAUSED	no
url	product URL	max. 2048 chars	no
vanity url	displayed URL	max. 256 chars	no
price type	sales model for product	enum	yes
price	product price in cents if applicable	positive integer	yes/no
original price	original price before discount	positive integer	no
image link	primary image	product images	no
additional image link	additional images	product images	no
attributes	collection of product attributes	attributes	no
autobid	budget details	budget details	no
cpc	budget details	budget details	no
total budget	budget details	budget details	no
daily budget	budget details	budget details	no
shipping	shipping options	shipping & pick-up	no
pickup location	pickup location	shipping & pick-up	no
phone number	phone number	max. 32 chars	no
email advertiser	allow emails to the seller	true,false	no
region id	only applicable for Kijiji Canada	numeric	no
micro tip	tiny product highlight	max. 18 chars	no
MPN	Manufacturer Part Number (MPN)	2-70 chars	no
google product category	google category for your product	string	no
product type	customer product type	max. 750 chars	no
brand	product brand name	max. 70 chars	no
GTIN	Global Trade Identification Number	max. 50 chars	no
item group id	groups product variants in your	max. 50 chars	no
condition	condition of product	enum	no
material	main product fabrics or materials	max. 200 chars	no
energy efficiency class	energy efficiency class	enum	no
min energy efficiency class	minimal energy efficiency class	enum	no
max energy efficiency class	maximal energy efficiency class	enum	no
color	product colors	max. 100 chars	no
gender	gender product is designed for	enum	no
age group	age group product is intended for	enum	no
size	size information	enum	no
unit pricing base measure	denominator for product unit price	string	no
unit pricing measure	measure and dimension of product	string	no

XML

Field	Description	Restrictions	Mandatory
vendor id	unique ad identifier	max. 64 chars	yes
external id	deprecated	–	–
seller name	your company name	max. 60 chars	no
title	product title	see title	yes
description	product description	description	yes
category id	category identifier	numeric, positive	yes
status	desired status (default ACTIVE)	ACTIVE,PAUSED	no
url	product URL	max. 2048 chars	no
vanity url	displayed URL	max. 256 chars	no
price type	sales model for product	enum	yes
price	product price in cents if applicable	positive integer	yes/no
original price	original price before discount	positive integer	no
media	product images	product images	no
attributes	collection of product attributes	attributes	no
budget	budget details	budget details	no
shipping options	shipping options	shipping & pick-up	no
phone number	phone number	max. 32 chars	no
email advertiser	allow emails to the seller	true,false	no
region id	only applicable for Kijiji Canada	numeric	no
micro tip	tiny product highlight	max. 18 chars	no
MPN	Manufacturer Part Number (MPN)	2-70 chars	no
google product category	google category for your product	string	no
product type	customer product type	max. 750 chars	no
brand	product brand name	max. 70 chars	no
GTIN	Global Trade Identification Number	max. 50 chars	no
item group id	groups product variants in your	max. 50 chars	no
condition	condition of product	enum	no
material	main product fabrics or materials	max. 200 chars	no
energy efficiency class	energy efficiency class	enum	no
min energy efficiency class	minimal energy efficiency class	enum	no
max energy efficiency class	maximal energy efficiency class	enum	no
color	product colors	max. 100 chars	no
gender	gender product is designed for	enum	no
age group	age group product is intended for	enum	no
size	size information	enum	no
unit pricing base measure	denominator for product unit price	string	no
unit pricing measure	measure and dimension of product	string	no

vendor id¶

The vendor id field is the unique identifier of the ad. It is there to let us know, for consecutive imports, which ads are the same. This results is allowing us to track and update an existing ad with the same vendor id instead of creating a new ad. vendor id is mandatory and, unique for each ad in the feed.

Note

If an ad in the feed remains unchanged (compared to previous import, including image urls), we will skip over this ad and leave it unchanged in our system. This also means we will not attempt to download the images and process them again. This is an optimization that allows us to speed up processing significantly and cut down on calls to your image server. Any change in the ad (including it re-appearing in the feed if it wasn’t present the previous time) will update the ad and trigger image re-processing.

TSV

Stored in vendor id column.

Example

15839942

XML

Use vendorId tag name to encapsulate vendor id.

Example:

<admarkt:vendorId>15839942</admarkt:vendorId>

Restrictions: Any non-empty string with a maximum length of 64 characters.

external id¶

Deprecated, replaced by vendorId

XML

Warning

There is still an external id field in the XSD, this field is replaced by vendor id. Please update your XML to reflect this change. This makes naming consistent between feeds and sellside API. The ref:feed_vendorId field in the feeds has the same meaning and constraints as the vendor id field in the sellside API.

seller name¶

Use the seller name field to communicate your company name to be displayed.

TSV

Stored in seller name column.

Example

Cups, Caps & Craps

XML

Example

<admarkt:sellerName>Cups, Caps &amp; Craps</admarkt:sellerName>

Restrictions: max. 60 characters

title¶

Use the title title field to clearly identify the product you are selling. The title is one of the most prominent parts of your ad or free listing. A specific and accurate title will help us show your product to the right customers.

TSV

Stored in title column.

Example

Goedkope A-merk herenfietsen

XML

Example

<admarkt:title>Goedkope A-merk herenfietsen</admarkt:title>

Restrictions: Any string, with minimum and maximum length determined by the category, with a maximum cap of 1024 characters. See Categories. URLs are not allowed as part of the title.

description¶

Use the description field to tell customers about the details of the product you are selling.

TSV

Stored in description column. Multiline descriptions must be quoted, or ending line characters, and tabulators escaped with \n, \t.

Example

"<p><strong><u>De goedkoopste webshop</u></strong>
        <strong>voor tweedehands fietsen met garantie!
        Gratis en rijklaar thuisbezorgd!</strong>
    </p>
    <p><strong><br></strong>
    </p>
    <ul>
        <li><strong>Laagste prijsgarantie</strong></li>
        <li>Fietsen <strong>100% rijklaar</strong>
        gratis thuisbezorgd</li>
        <li><strong>Ruime voorraad</strong>, voor ieder wat wils</li>
        <li>Snelle <strong>customer service</strong>
        via Whatsapp, bellen en e-mail</li>
        <li>1 <strong>maand garantie</strong></li>
        <li>Aangesloten bij <strong>Webwinkelkeur</strong></li>
    </ul>
    <strong><br></strong>
    <p>Check dus snel onze website en vind de fiets die bij je past!<br>
    </p>
    <strong><br></strong>
    <p>WhatsApp, bel of mail ons voor verdere vragen.
    </p>"

XML

Example

<admarkt:description><![CDATA[
    <p><strong><u>De goedkoopste webshop</u></strong>
        <strong>voor tweedehands fietsen met garantie!
        Gratis en rijklaar thuisbezorgd!</strong>
    </p>
    <p><strong><br></strong>
    </p>
    <ul>
        <li><strong>Laagste prijsgarantie</strong></li>
        <li>Fietsen <strong>100% rijklaar</strong>
        gratis thuisbezorgd</li>
        <li><strong>Ruime voorraad</strong>, voor ieder wat wils</li>
        <li>Snelle <strong>customer service</strong>
        via Whatsapp, bellen en e-mail</li>
        <li>1 <strong>maand garantie</strong></li>
        <li>Aangesloten bij <strong>Webwinkelkeur</strong></li>
    </ul>
    <strong><br></strong>
    <p>Check dus snel onze website en vind de fiets die bij je past!<br>
    </p>
    <strong><br></strong>
    <p>WhatsApp, bel of mail ons voor verdere vragen.
    </p>]]>
<admarkt:description/>

Restrictions: Any string, with minimum and maximum length determined by the category. See Categories. URLs are not allowed as part of the description. All HTML elements except for the ones below will be removed:

<u> <em> <ul> <li> <p> <strong> <br>

category id¶

Use category id to place your product in the Categories tree.

Each product belongs to one and only one category.

TSV

Stored in category id column.

Example

PAUSED

XML

Example

<admarkt:categoryId>945</admarkt:categoryId>

Restrictions: An integer value from the category list. Must be an id of a leaf category with a non-zero parent id.

status¶

Use status to change the state of your ad.

Must be one of the following:

Name	Description
ACTIVE	The ad will be active (as long as there is budget for it) and it can be found on the marketplace.
PAUSED	The ad will be paused, effectively not found on the marketplace.

The provided (desired) status may differ from the resulting one, depending on the other conditions. For instance, budget may be depleted, or you may have too many active ads already in the category.

TSV

Stored in status column.

Example

PAUSED

XML

Example

<admarkt:status>PAUSED</admarkt:status>

Allowed values: ACTIVE, PAUSED

url¶

Utilize the url to establish a connection to your product page from the advertisement. This represents an external URL, which will be displayed on the ad detail page or search result page.

TSV

Stored in url column.

Example

https://www.bmw.de

XML

Example

<admarkt:url>https://www.bmw.de</admarkt:url>

Restrictions: Must be a valid http(s) url.

vanity url¶

Use vanity url to provide the text for the url link.

TSV

Stored in vanity url column.

Example

BMW

XML

Example

<admarkt:vanityUrl>BMW</admarkt:vanityUrl>

price type¶

Use price type to define pricing model for your product.

TSV

Stored in price type column.

Example

FIXED_PRICE

XML

Example

<admarkt:priceType>FIXED_PRICE</admarkt:priceType>

Allowed Values: BIDDING, BIDDING_FROM, FIXED_PRICE, FREE, NEGOTIABLE, SEE_DESCRIPTION, SWAP, CREDIBLE_BID, ON_DEMAND, NOT_APPLICABLE, RESERVED

price¶

Use price to tell customers the price of the product you are selling. The meaning of the value depends on the price type.

If it is FIXED_PRICE or BIDDING_FROM then price is mandatory and needs to be greater than 0.

TSV

Stored in price column.

Example

XML

Example

<admarkt:price>1500</admarkt:price>

Restrictions: The maximum allowed price value is 10000000000 given in cents of the local market currency. (100.000.000,00 EUR / CAD / … ).

original price¶

Use original price to tell your product price before discount. Ignored if a seller does not have a discount feature enabled.

TSV

Stored in original price column.

Example

XML

Example

<admarkt:originalPrice>1500</admarkt:originalPrice>

Restrictions: Must be greater than price. The maximum allowed product price value is 10000000000 given in cents of the local market currency (100.000.000,00 EUR / CAD / … ).

product images¶

You can provide multiple images for your product.

All images will be resized if necessary to a size of maximum 1024px height and 1024px width (preserving the aspect ratio) The system will download the images and, if they meet the requirements, store them on our servers in several sizes.

TSV

Use image link column to give us a link to the best picture of your product.

Example

https://images.pexels.com/photos/62289.jpeg

Use additional image link for even more pictures of your product. If there are more than one, separate them with commas.

Example

https://images.pexels.com/photos/62290.jpeg,https://images.pexels.com/photos/62291.jpeg

All URLs must be complete links pointing to an image on a publicly available web server.

XML

Use <media> tag for grouping your product images. <media> should contain from 0 to N <image> ordered elements, where the exact limit depends on the category in taxonomy. <image> elements must contain a complete URL link pointing to an image on a publicly available web server.

Example

<admarkt:media>
    <admarkt:image url="https://images.pexels.com/photos/62289/62289.jpeg"/>
    <admarkt:image url="https://images.pexels.com/photos/47547/47547.jpeg"/>
<admarkt:media/>

The images will be presented in the provided order. The first image is shown in search results and acts as the main image on the item page.

Allowed image formats: JPEG, JPG, PNG, GIF*, BMP.

* Please note that GIFs are not recommended format as they are only 256 colors or less. Also, animated GIFs and PNGs are not supported.

attributes¶

Use attributes field to provide additional information on your product in a structured way.

TSV

Define your attribute as name:value pair in the attributes column.

Example

model:Adams Family

You can provide multiple attributes in a comma- separated list.

Example

model:Adams Family,multiball:TRUE,screen size:32"

If the name, or the value of your attribute contains commas, use quotes to escape it.

Example

resolutions:"1024x768:24dpi,800x600:18dpi"

XML

attributes tag contains collection of product User-Defined Attributes (category-dependent), that can be used to influence the ad relevance.

Example

<admarkt:attributes>
    <admarkt:attribute>
        <admarkt:attributeName>color</admarkt:attributeName>
        <admarkt:attributeLocale>nl</admarkt:attributeLocale>
        <admarkt:attributeLabel>Kleur</admarkt:attributeLabel>
        <admarkt:attributeValue>Rood</admarkt:attributeValue>
    </admarkt:attribute>
    <admarkt:attribute>
        <admarkt:attributeName>color</admarkt:attributeName>
        <admarkt:attributeLocale>en</admarkt:attributeLocale>
        <admarkt:attributeLabel>Color</admarkt:attributeLabel>
        <admarkt:attributeValue>Red</admarkt:attributeValue>
    </admarkt:attribute>
    <admarkt:attribute>
        <admarkt:attributeName>Model</admarkt:attributeName>
        <admarkt:attributeValue>Slim</admarkt:attributeValue>
        <admarkt:attributeValue>Pro</admarkt:attributeValue>
    </admarkt:attribute>
</admarkt:attributes>

budget details¶

Use budget details to tell us what is your preferred model for budgeting your ad. Use the following values to describe your model:

Name	Description	Required
autobid	use auto bidding option true/false	No
cpc	CPC for the given ad in cents	No
total budget	total budget for the given ad in cents	No
daily budget	daily budget for the given ad in cents	No

TSV

Use autobid column for your choice on that option.

Example

true

Use cpc to provide your cost per click in cents.

Example

Use total budget column to determine total budget for your ad.

Example

Use daily budget column to determine daily budget for your ad.

Example

XML

Example

<admarkt:budget>
    <admarkt:totalBudget>5000</admarkt:totalBudget>
    <admarkt:dailyBudget>1000</admarkt:dailyBudget>
    <admarkt:cpc>2</admarkt:cpc>
</admarkt:budget>

Restrictions: The minimum and maximum values for the total budget depend on the category.

If the total budget provided in the ad is lower than the total amount already spent, the ad will automatically be paused.

When this value of the daily budget is reached the ad will be offline for the rest of the day, and re-activated at the beginning of the following day, unless more money is added during the same day. The minimum value depends on the category.

The minimum and maximum values of the cost per click (CPC) depend on the category.

shipping & pick-up¶

Provide the information on how your product can be delivered to customers.

TSV

Use shipping field to tell customers about the different cost vs. time options for your product delivery. Each option should be formatted as follows:

[cost in cents]:[<time formatted string>], where <time formatted string> allows the following values/formats:

literal values: 2d-5d and 6d-10d. These default values represent [minimum transit time in days]-[maximum transit time in days] options.

format: <number (not starting with 0)>d. The format represents [transit time in days] only (without minimum/maximum components).

Example

2d-5d
6d-10d
1d
12d
123d

Use pickup location field to tell customers location your product can be picked up at. Location is given as a postal code.

Example

1097DN

XML

You can provide shipping/ pick-up options for each ad. Each option can be described with the following information:

Name	Description	Required
shippingType	SHIP, PICKUP	Yes
cost	cost of shipping in cents	No
time	time it takes to deliver the product	No
location	pick up location of the product	No

SHIP means the item can be delivered to the buyer in the provided time and for the provided cost. For shippingType ‘SHIP’ provide ‘cost’ in cents and ‘time’ in days. ‘location’ is ignored. Each option should be formatted as follows:

[cost in cents]:[<time formatted string>], where <time formatted string> allows the following values/formats:

literal values: 2d-5d and 6d-10d. These default values represent [minimum transit time in days]-[maximum transit time in days] options.

format: <number (not starting with 0)>d. The format represents [transit time in days] only (without minimum/maximum components).

PICKUP means the item can be picked up at the provided location For shippingType ‘PICKUP’ provide ‘location’. Both ‘cost’ and ‘time’ are ignored.

Example

<admarkt:shippingOptions>
    <admarkt:shippingOption>
        <admarkt:shippingType>PICKUP</admarkt:shippingType>
        <admarkt:location>1097DN</admarkt:location>
    </admarkt:shippingOption>
</admarkt:shippingOptions>

Restrictions: Shipping options can be disabled/optional/mandatory for an ad. Ads can contain maximum one shipping option per shipping option type (SHIP/PICKUP). It is configured per category, see Category Configuration.

phone number¶

Use the phone number field to allow customers call you and ask about the product.

TSV

Stored in phone number column.

Example

+31207894561

XML

Example

<admarkt:phoneNumber>+31207894561</admarkt:phoneNumber>

Restrictions: The number should be given as an international phone number format, e.g. +31207894561 or as a local phone number, e.g. 06789456612.

email advertiser¶

Use the email advertiser flag to allow customers to contact you via email (or the other platform defined form of contact), and ask about the product. The default value is false.

TSV

Stored in email advertiser column.

Example

true

XML

Example

<admarkt:emailAdvertiser>true</admarkt:emailAdvertiser>

Allowed values: true, false

region id¶

The region in which the ad is placed. (only applicable for Kijiji Canada)

Each ad belongs to one and only one region and region of an ad cannot be updated. This field can only be set once during creation of an ad.

TSV

Stored in region id column.

Example

XML

Example

<admarkt:regionId>1700274</admarkt:regionId>

Restrictions: An integer value from the region tree. Must be the id of a leaf region.

This field is mandatory if the region field of category configuration is MANDATORY and optional if the region field is OPTIONAL. This field must be omitted if the region field of category configuration is DISABLED.

Please refer to Categories and Regions

micro tip¶

Micro tip is a short freeform text, that can be shown as a highlight on your ad image. It is a feature enabled as part of a package that sellers can purchase (currently available only for Marktplaats tenant). It provides extra attention on the ad in the search results.

If micro tip feature is not enabled for the seller, the field will be ignored.

TSV

Stored in micro tip column.

Example

TODAY 15% SALE

XML

Example

<admarkt:microTip>TODAY 15% SALE</admarkt:microTip>

Restrictions: Limit your text to a maximum length of 18 characters. The following characters .,/@#<> are not allowed.

MPN¶

Manufacturer Part Number (MPN), definition follows Google Merchant Center guidelines.

TSV

Stored in mpn column.

Example

AB12345R89TN6E

XML

Example

<admarkt:mpn>AB12345R89TN6E</admarkt:mpn>

Restrictions: String identifier max 70 characters long.

google product category¶

Use this field to describe your product category in Google’s product taxonomy. See Google Merchant Center

TSV

Stored in google product category column.

Example	Apparel > Accessories > Clothing > Dresses
Example	2271

XML

Example	<admarkt:googleProductCategory> Apparel & Accessories > Clothing > Dresses </admarkt:googleProductCategory>
Example	<admarkt:googleProductCategory>2271</admarkt:googleProductCategory>

Restrictions: Should be a valid category. You can provide it, either with identifier, or giving full category path.

product type¶

The product type field provides an opportunity for you to incorporate your unique product classification system into the dataset. Definition follows Google Merchant Center guidelines.

TSV

Stored in product type column.

Example

Home > Women > Dresses > Maxi Dresses

XML

Example

 <admarkt:productType>
    Home &gt; Women &gt; Dresses &gt; Maxi Dresses
</admarkt:productType>

Restrictions: Do not exceed 750 characters limit for your text.

brand¶

Use the brand field to help customers identify your product. Brand definition follows Google Merchant Center guidelines.

TSV

Stored in brand column.

Example

iPhone

XML

Example

<admarkt:brand>iPhone</admarkt:brand>

Restrictions: Do not exceed 70 characters limit for your text.

GTIN¶

GTIN (Your product’s Global Trade Item Number), definition follows Google Merchant Center guidelines.

TSV

Stored in gtin column.

Example

44320194113475

XML

Example

<admarkt:gtin>44320194113475</admarkt:gtin>

Restrictions: String identifier max 50 chars.

item group id¶

Use this field to group product variants in your product data. Item group id definition follows Google Merchant Center guidelines.

TSV

Stored in conditionitem group id column.

Example

BC23456

XML

Example

<admarkt:itemGroupId>BC23456</admarkt:itemGroupId>

Restrictions: Text max. length 50 characters.

condition¶

Use this field to inform customers about the condition of your product. Condition definition follows Google Merchant Center guidelines.

TSV

Stored in condition column.

Example

used

XML

Example

<admarkt:condition>used</admarkt:condition>

Accepted values: new, refurbished, used

material¶

Material field describes the main fabric or material that your product is made of. Material definition follows Google Merchant Center guidelines.

TSV

Stored in material column.

Example

Cotton/Silk

XML

Example

<admarkt:material>Cotton/Silk</admarkt:material>

Restrictions: Use human readable material names. Provide up to 3 materials. Separate materials with a slash (“/”) character when there are multiple. Do not exceed 200 characters limit for your text.

energy efficiency class¶

Use this field to tell customers how your product rates on a given energy efficiency range. See Google Merchant Center

TSV

Stored in energy efficiency class column.

Example

A+

XML

Example

<admarkt:energyEfficiencyClass>A+</admarkt:energyEfficiencyClass>

Allowed values: A+++, A++, A+, A, B, C, B, E, F, G

min energy efficiency class¶

Used in combination with max energy efficiency class to describe the product energy efficiency label. Possible values defined in energy efficiency class

TSV

Stored in min energy efficiency class column.

Example

XML

Example

<admarkt:minEnergyEfficiencyClass>G</admarkt:minEnergyEfficiencyClass>

max energy efficiency class¶

Used in combination with min energy efficiency class to describe the product energy efficiency label. Possible values defined in energy efficiency class

TSV

Stored in max energy efficiency class column.

Example

XML

Example

<admarkt:maxEnergyEfficiencyClass>B</admarkt:maxEnergyEfficiencyClass>

color¶

Use color field to tell customers about the dominant colors of your product. Color definition follows Google Merchant Center guidelines.

TSV

Stored in color column.

Example

Black/Grey

XML

Example

<admarkt:color>Black/Grey</admarkt:color>

Restrictions: Use human readable color names. Provide up to 3 colors. Separate colors with / if more than one. Do not exceed 100 characters limit for your text.

gender¶

Use gender field to describe the gender your product is designed for. Gender definition follows Google Merchant Center guidelines.

TSV

Stored in gender column.

Example

unisex

XML

Example

<admarkt:gender>unisex</admarkt:gender>

Allowed values: male, female, unisex

age group¶

Use age group field to describe the age group your product is targeted at. Definition follows Google Merchant Center guidelines.

TSV

Stored in age group column.

Example

adult

XML

Example

<admarkt:ageGroup>adult</admarkt:ageGroup>

Allowed values: newborn, infant, toddler, kids, adult

size¶

Use size field to describe standardized size of your product. Size definition follows Google Merchant Center guidelines.

TSV

Stored in size column.

Example

XXL

XML

Example

<admarkt:size>S</admarkt:size>

Restrictions: String identifier max 1-100 chars.

unit pricing base measure¶

The denominator for product unit price. See Google Merchant Center. This field attribute tells the customer how the price of your product translates per unit.

TSV

Stored in unit pricing base measure column.

Example

1kg

XML

Example

<admarkt:unitPricingBaseMeasure>1kg</admarkt:unitPricingBaseMeasure>

Restrictions: Value should be an integer number with unit.

Supported unit values:

Weight: oz, lb, mg, g, kg
Volume: floz, pt, qt, gal, ml, cl, l, cbm
Length: in, ft, yd, cm, m
Area: sqft, sqm
Per unit: ct

unit pricing measure¶

Defines the measure and dimension of the product. That value helps the customers to understand the exact price per unit for your product. Example 125ml, 100g. See Google Merchant Center.

TSV

Stored in unit pricing measure column.

Example

15kg

XML

Example

<admarkt:unitPricingMeasure>15kg</admarkt:unitPricingMeasure>

Restrictions: Value should be an integer number with a unit.

Supported unit values:

Weight: oz, lb, mg, g, kg
Volume: floz, pt, qt, gal, ml, cl, l, cbm
Length: in, ft, yd, cm, m
Area: sqft, sqm
Per unit: ct