Feedeo Feed Specification

This document contains the list of attributes and elements available for use in the Feedeo XML feed.
The more product attributes the better!
You can find our XML schema here: http://schemas.keybroker.com/productfeed_v1_2.xsd
The feed should be UTF-8 encoded.

Take a look at our Feedeo feed examples article: Feedeo Feed Examples

Element/Attribute

Type

Description

Required

currency

Three character string (ISO 4317) *Attribute to the <products> element

The currency used for all prices of all products

Yes

sku

String (must be unique)

A unique ID for this product within this feed. It is important that the ID doesn’t change for a given product

Yes

active

Boolean, true or false

Is the product active or not

No

category

String (non empty)

The major category that this product is included in

No

subCategory

String (non empty)

A subcategory that this product is included in

No

subCategory2

String (non empty)

A deeper level subcategory that this product is included in

No

subCategory3

String (non empty)

A even deeper level subcategory that this product is included in

No

description

String (non empty)

Description of the product

No

manufacturer

String (non empty)

The name of the manufacturer or brand of the product.

No

manufacturerProductNumber

String (non empty)

The manufacturer’s reference ID

No

productFamily

String (non empty)

Product family

No

modelName

String (non empty)

The model name of the product

No

color

String (non empty)

Color of product in writing (“Green”, “Red”, “Blue”)

No

size

String (non empty)

Size of the item

No

gender

String (non empty)

Target gender

No

artist

String (non empty)

Perfomring artist / writer / group

No

title

String (non empty)

Title of the product

No

media

String (non empty)

Media i.e. Book, CD, DVD

No

onPromotion

String (non empty)

Boolean, true or false

No

promotionCode

String (non empty)

Code for promotion

No

promotionName

String (non empty)

Name of promotion

No

selectMe

Boolean, true or false

Use filters to only export a selection of products

No

priceWithTax

double >= 0, max 2 decimals

The price of the product, including all taxes

No

priceWithoutTax

double >= 0, max 2 decimals

The price of the product, not including any taxes

No

originalPriceWithTax

double >= 0, max 2 decimals

The original price of the product, including all taxes. Will be the same as priceWithTax unless there is a dfiscount for this product

No

originalPriceWithoutTax

double >= 0, max 2 decimals

The original price of the product, not including any taxes. Will be the same as priceWithoutTax unless there is a dfiscount for this product

No

shippingCostWithTax

double >= 0, max 2 decimals

The cost of shipping this product, including all taxes

No

originalShippingCostWithoutTax

double >= 0, max 2 decimals

The cost of shipping this product, not including any taxes

No

newItem

Boolean, true or false

Is this a new or used item?

No

inStock

Boolean, true or false

Indicates if the product is in stock

No

quantityForSale

integer >= 0

Number of products available for sale

No

releaseDate

Date (ISO 8601)

Date of product release

No

availableFromDate

Date (ISO 8601)

First day of availability for product

No

availableToDate

Date (ISO 8601)

Last day of availability for the product

No

salesStat

double >= 0, max 2 decimals

Number of sold items, a ranking according to sold items, etc.

No

productMargin

double >= 0, max 2 decimals

The price margin for the product

No

reviewRank

Integer

Review rank, 1 = best

No

priceComparisonRank

Integer

Price comparison rank, 1 = best

No

productUrl

HTTP or HTTPS URL

A URL linking directly to the product page

No

imageUrl

HTTP or HTTPS URL

A URL linking to an image of the product

No

imageUrlBig

HTTP or HTTPS URL

A URL linking to a big image of the product

No

categoryUrl

HTTP or HTTPS URL

A URL linking to the category of the product

No

subCategoryUrl

HTTP or HTTPS URL

A URL linking to the sub category of the product

No

manufacturerUrl

HTTP or HTTPS URL

A URL linking to the manufacturer page

No

productFamilyUrl

HTTP or HTTPS URL

A URL linking to the product family page

No

lastUpdated

dateTime (ISO 8601) Both the date and time

The date and time when this information was last updated

No


Product code attributes

asin

String (non empty)

Amazon Standard Identification Number

No

isbn10

Integer

ISBN number

No

ean

Integer

EAN

No

gs1Code

String (non empty)

Bar code

No

unspscCode

8 or 10 digits (www.unspsc.org)

The United Nations Standard Products and Services Code

No


Additional attributes

customUrl1

HTTP or HTTPS URL

Additional URL

No

customUrl2

HTTP or HTTPS URL

Additional URL

No

customUrl3

HTTP or HTTPS URL

Additional URL

No

customText1

String (non empty)

Custom text

No

customText2

String (non empty)

Custom text

No

customText3

String (non empty)

Custom text

No

customNum1

Decimal

Custom number

No

customNum2

Decimal

Custom number

No

customNum3

Decimal

Custom number

No

adCopyText1

String (non empty)

Text for use in ad copy (or other)

No

adCopyText2

String (non empty)

Text for use in ad copy (or other)

No

adCopyText3

String (non empty)

Text for use in ad copy (or other)

No

adCopyText4

String (non empty)

Text for use in ad copy (or other)

No


Feedback and Knowledge Base