Open Catalog Interface (OCI): Manual for Open Icecat XML and Full Icecat XML

Version 2.1 (Updated on May 5th, 2025)

Icecat XML is a powerful and standardized format designed to deliver structured product information for e-commerce platforms and online marketplaces. By leveraging Icecat’s product catalog, channel partners can seamlessly integrate up-to-date product content into their systems. This manual will guide you through the structure of Icecat XML, helping you understand how to retrieve, parse, and use the data effectively to enhance your product presentations and improve the shopping experience for your customers.

Where to start?

Free Open Icecat Subscription

Icecat provides a Free Open Icecat subscription with access to the Open Icecat repository.

The Open Icecat repository is the part of the Icecat XML repository that is sponsored by Brands and is provided for free to the channel. The most recent list of Open Icecat brands is here.
Open Icecat is also useful for testing purposes before you upgrade to Full Icecat. The technical structures are 100% compatible with those of Full Icecat.
We require any user of Open Icecat product data – in a free Open Icecat subscription or as part of the Full Icecat data – to respect the Open Icecat Fair Use Policy.
Explicitly relevant for website development is:

• to mention explicitly the “Specs Icecat” on all product datasheets, with a link to Icecat.biz.
• to include explicitly an AS IS Disclaimer, an example of which is here: English Disclaimer.

Full Icecat Subscription

However attractive the free Open Icecat database is, the Full Icecat database still contains many, many more brands: tens of thousands. Datasheets are often provided with service levels and coverage guarantees.

🔍 Read more:
📖 Main advantages of Full Icecat over Open Icecat
📖 Icecat Subscription Plans

The Full Icecat XML repository is a set of product data files and an index file, which includes all pointers to individual product files and gives some basic information as timestamp updated, content quality level, etc. The Icecat XML repository contains product information for products of all brands and categories that subscribers want us to support.

In case you want to upgrade to Full Icecat, please contact us via the contact form or click on the Upgrade in your Settings.

For users who already have their product catalogue

1. Prepare your feed as an Excel or CSV file with a new identifier on each row. We process GTINs and Brand + Product Codes.
2. Upload your feed here: My Pricelist
3. Match your columns, and Icecat will automatically provide you with the available data.
4. In the match analysis, you get the match percentages for Full Icecat and Open Icecat. Also, you get a list of unrecognized products.
5. You might receive a Personal Interface File (PIF) and a Personalized Catalogue File (PCF)

Example of feed:

🔍 Read more:
📖 Coverage Analysis of Your Catalog
📖 Manual Personalized Interface File and Catalog from Icecat

For users who don’t have the product catalogue

Please check the following Index Files endpoints to view the complete catalogue of the products represented in Icecat. Replace EN with the language from the Language Table, and the destination file with the examples below.

💡The export files are to be downloaded with scripts or special apps from server to server. If you try to download them via the browser, you may sometimes experience memory problems. This does not mean that the data is not accessible or available. In case you experience any problem, contact us via the contact form.

Index Files are updated overnight and share the structure, described in the MetaXML section.

We recommend downloading only the XML files that you need for your shop or application. It is useless to import all the global product data files if you only operate in one geographic area or have an assortment limited to a certain category.

Icecat creates a daily.index.xml file every day to keep channel partners informed about products that were updated in the past 24 hours. Also, the daily.index.xml file includes the list of product codes that are removed the day before (Quality=REMOVED). We remove product data-sheets, for example, when editors map them away. You can use it for cleansing your catalog.

Use the on_market.index.xml file in case you think the files.index.xml is too big for you to process.

💡The product is considered On Market if Icecat partner distrubutor includes the product in their catalog on certain market. Therefore, on_market.index.xml includes only the products that we can guarantee are distributed in certain country.

Disclaimer: If our monitor for your market is incomplete, the on_market.index.xml is probably too incomplete for your purposes.

In case you want to recategorize your products for which we have no data-sheet (Quality=NOEDITOR), make use of the nobody.index.xml.

💡Check the Updated timestamp to only download products that have changed or check only for new products to improve update performance cycles.

🔍 Read more:
📖 How to Retrieve Export Files
📖 Full Index Files per Vertical – an index file with references to products that are in files.index.xml but limited to a specific vertical.

Icecat Taxonomy and Repository Structure

In product XML feeds, you will find a lot of structures. We provide Reference files as helpers to understand Categories, Product Features, and even translations of the feature values.
The reference files are present in the /refs/ subdirectory. Depending on your subscription, you can access the Full Icecat and Open Icecat.

The explanation is below in the Reference Files section.

How to use Product XML API?

There are two types of XML Links endpoints, though the output is the same.

1. Export Links – appear in most Icecat export files, such as PCF, PIF, and Index files. While straightforward, they are not the focus of this article, as they only allow a product to be requested by its Icecat product ID. The output is identical to the Product XML for XML_s3.
   Example: https://data.icecat.biz/export/<AccessLevel>/<Lang>/<Icecat_ID>.xml
2. XML_s3 Links – This client-oriented API enables product searches by GTIN, Product Code, Brand, as well as meta requests. Throughout the article, any mention of XML requests refers to the XML_s3 request.
   Example: https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=<Lang>&prod_id=<Product Code>&vendor=<Brand>&output=productxml

Every Product XML strictly follows the following XML Schema Definition (XSD). XSD ensures that the XML document follows a specific structure and that the data inside is correct.
The XML repository files comply with the standard Icecat XML response DTD, which is located here.
Apart from XML, Icecat is compliant with an increasing number of international standards. See here a quick overview of such supported standards.
You can utilize GET and HEAD HTTP methods for retrieving the product information. GET will return a regular output with a product datasheet, while HEAD will only indicate the existence of the product.

Access Requirements

Take care that you provide us with the right IP addresses of your content servers, as the access is secure. You can test the login/password combination by entering it by hand in the Basic HTTP authorization pop-up screen.

If you don’t know your public IP address, check it here.

We support the following IPv4 values:
16.0.0.5 – single IP.
152.168.1.0/24 – CIDR notation.
152.168.1.1-152.168.1.100 – IP range.

Changing passwords and IP whitelisting can be done in My Icecat.

💡After a rip of our general site, an IP address may be temporarily blocked (error 499). A rip is not acceptable as it may hurt site performance and can be a copyright infringement.
Maximum limitation is 100 requests per IP per second. We recommend keeping it on 50-70.

Examples:

XML_s3 Product Request by Product Code & Brand:

<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=EN&prod_id=75252&vendor=LEGO&output=productxml>

XML_s3 Product Request by GTIN (EAN/UPC):

<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=EN&ean_upc=5702016371116&output=productxml>

XML_s3 Product Request by Icecat product ID:

<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=EN&icecat_id=74951614&output=productxml>

XML_s3 Product Request with Relations Limit

<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=NL&icecat_id=35443992&output=productxml&relations_limit=400>

XML_s3 Meta Request by Product Code & Brand:

<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=EN&prod_id=75252&vendor=LEGO&output=metaxml>

Product request by Icecat product ID (Open):

<https://data.icecat.biz/export/freexml/EN/74951614.xml>

Product request by Icecat product ID (Full):

<https://data.icecat.biz/export/level4/EN/74951614.xml>

Product HEAD request with curl and wget

curl --request HEAD \\
  --url '<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=EN&icecat_id=74951614&output=productxml>'

wget --method HEAD \\
  --output-document \\
  - '<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=EN&icecat_id=74951614&output=productxml>'

XML_s3 Request Parameters

lang

Language short identifier. The full list can be viewed at the Language Table or in the LanguageList.xml. Note that country is a main identifier for a language; therefore, 🇬🇧 EN and 🇦🇺 EN_AU are different languages in Icecat.

The 🌐INT (International) language will provide the data in every language you are subscribed to. In general, we follow the language codes as given by the ISO 639-1 standard. However, in some cases, we choose the simpler two-character country codes. For example, when it’s obvious to which language code it relates, for example 🇧🇷BR and 🇺🇸US.

If you feel that your language or the language that you need is missing, feel free to contact us. Probably we can work something out.

prod_id

Product Code. It’s a unique code assigned by Brands to identify each of their products. Think of it like a serial number for a specific product model.

Product Codes are unique only within a brand; therefore, for a correct request, a Brand name is also required. A product might have many Product Codes, and different distributors often produce different Product Codes for the same product.

To help you correct the Product Codes from many distributors and to help you to get the best coverage, we are publishing the available mappings along with the official Product Code.

💡In the files.index.xml and MetaXML requests, the official Product Code is a value of Prod_id attribute, while the mapped Product Code is a value of M_Prod_id attribute.

💡Product Codes are always upper-case and may contain characters that should be URL-encoded. For instance, # needs to be replaced with %23. Other examples: @, &, =, etc.

vendor

Name of the Brand of the requested product. We log all Icecat product requests, which gives a product popularity indication, useful for sorting products and analyzing market trends. The brands are sorted by popularity here.

🔍Read more:

• Open Icecat Brand list: for browser; reference file for scripts
• Full Icecat Brand list: for browser; reference file for scripts

ean_upc

GTIN, EAN, or UPC code to identify a product. Further, it is referred to as GTIN because it’s a more general term that means a unique numeric product identifier. GTIN is unique within all Icecat repository, and hence you may search for the product with GTIN only. A product might have more than one GTIN.

💡A single GTIN might be assigned to different products because Brands may reuse them. Only one product can have a certain GTIN at once.

It is important to note that a GTIN may change its association with products over time. This can happen due to directives from brands or actions taken by brand users in Icecat Cloud. To ensure accuracy and avoid any confusion, we recommend performing an extra check by verifying the combination of the GTIN and the Icecat product ID. This will help confirm that the GTIN has not shifted from one product to another.

icecat_id

Icecat product ID, unique within Icecat Repository, and product can only have one ID. Useful for testing.

output

• productxml – default XML view. See Product XML Structure.
• metaxml – exists for the purpose of ping command. Returns a row from files.index.xml. See Meta XML Structure below.

relations_limit

The amount of Up-sell and cross-sell products related to this product. Optional attribute: By default, you will see a maximum of 500 related products. Using the relations_limit parameter, you can adjust it up to 3,000.

🔍Read more: Related Products in Icecat XML and JSON Data Channels

HEAD Request

HEAD requests provide a lightweight way to check whether the product exists in Icecat.

You can only get three responses for product XML HEAD requests:

• ✅ 200 – product exists in Icecat Database.
• ❌ 401 – You did not pass login and password to your request.
• ❌ 404 – The product does not exist / your credentials are incorrect / your IP isn’t whitelisted.

After receiving ✅ 200, you can send a GET request to check whether the datasheet is available for your account.

💡In the HEAD response, check the header Last_Modified. You can utilize this timestamp to update only the recently modified products.

Example of workflow that utilizes HEAD requests to build the Index file for a retailer.

Meta XML and *.index.xml Structure

<files.index Generated="YYYYMMDDHHMMSS">
	<file 
		path="/export/level4/JA/36153639.xml" 
		Product_ID="0" 
		Updated="20240830203543" 
		Quality="ICECAT" 
		Supplier_id="25" 
		Prod_ID="HR2345/19" 
		Catid="2266" 
		On_Market="1" 
		Model_Name="HR2345/19" 
		Product_View="213335" 
		HighPic="<http://images.icecat.biz/img/gallery/img_36153639_high_1505590007_7852_25770.jpg>" 
		HighPicSize="320472" 
		HighPicWidth="2400" 
		HighPicHeight="2400">
			<M_Prod_ID>MAPPED PRODUCT CODE</M_Prod_ID>
			<EAN_UPCS>
				<EAN_UPC Value="9999999999999"/>
				<EAN_UPC Value="9999999999998"/>
			</EAN_UPCS>
			<Country_Markets>
				<Country_Market Value="BG"/>
				...
				<Country_Market Value="SE"/>
			</Country_Markets>
			<Distributors>
				<Distributor 
					ID="3242" 
					Name="Eurocom - Italy" 
					Country="IT" 
					ProdlevId="" 
					Stock="not disclosed" 
					Updated = "20241125085857" 
					EAN_UPC="8710103814405"/>
			</Distributors>
	</file>
</files.index>

• Generated – Date when the files.index.xml (source for the data) was generated in format YYYYMMDDHHMMSS

<file>

• path – path within data.icecat.biz to export link https://data.icecat.biz/export/<AccessLevel>/<Lang>/<Icecat_ID>.xml
• Product_ID – Icecat product ID
• Updated – When the product was last updated in format YYYYMMDDHHMMSS
• Quality – The quality of the product. It may be one of two values: SUPPLIER – only the original product data as imported from a brand’s CMS, not yet standardized by our editors. ICECAT – data-sheet is standardized and reviewed by our editors.
• Supplier_id – Brand ID from the SuppliersList.xml.
• Prod_ID – Product Code
• Catid – Category unique ID from CategoriesList.xml.gz
• On_Market – if the product has at least one channel distributor of Icecat partners.
• Model_Name – The product description (product model description) for the requested locale or the international value if the former is absent.
• Product_View – how many times the product datasheet was fetched.
• HighPic – A link to the product’s main picture of type ‘high‘ or an empty string if there is no main picture.
• HighPicSize – The size of the main picture of type ‘high‘ in bytes, or 0 if there is no main picture.
• HighPicWidth – The width of the main picture of type ‘high‘ in pixels, or 0 if there is no main picture.
• HighPicHeight – The height of the main picture of type ‘high‘ in pixels, or 0 if there is no main picture.

<M_Prod_ID>

Other mapped Product Code for the same product.

<EAN_UPC>

• Value – GTIN (EAN, UPC)

<Country_Market>

Active markets for the product. The product is considered on a country market if it has at leat one distributor in the country.

• Value – Country code

<Distributor>

❗Exists only in MetaXML response.

💡All Distributors are available in DistributorsList.xml

• ID – Distributor’s unique ID
• Name – Distributor’s name
• Country – Distributor’s country
• ProdlevId – Distributor’s Product Code.
• Stock – Distributor’s stock balance, which may not be disclosed.
• Updated – Date of the last update in format YYYYMMDDHHMMSS
• EAN_UPC – Distributor’s GTIN (EAN/UPC)

Product XML Structure

<?xml version="2.0" encoding="UTF-8"?>
<!DOCTYPE ICECAT-interface
SYSTEM "<https://data.icecat.biz/dtd/ICECAT-interface_response.dtd>">
<!--source: Icecat.biz 2024-->
<ICECAT-interface 
	xmlns:xsi="<https://www.w3.org/2001/XMLSchema-instance>" 
	xsi:noNamespaceSchemaLocation="<https://data.icecat.biz/xsd/ICECAT-interface_response.xsd>">
 <Product>
  <CategoryFeatureGroup/>
  <Category/>
  <EanCode/>
  <FeatureLogo/>
  <ReleaseDate/>
  <EndOfLifeDate/>
  <ReasonsToBuy/>
  <BulletPoints/>
  <GeneratedBulletPoints/>
  <ProductBundled/>
  <ProductDescription/>  
  <Disclaimers/>
  <ProductFamily/>
  <ProductFeature/>
  <ProductGallery/>
  <ProductMultimediaObject/>
  <ProductRelated/>
  <SEOs/>
  <SummaryDescription/>
  <SummaryDescriptionLocal/>
  <Supplier/>
  <BrandOrganizations/>
  <CatalogObjectCloud/>
  <Variants/>
  <Reviews/>
  <ProductModelDescriptions/>
  <ProductTitles/>
 </Product>
</ICECAT-interface>

<Product> Metadata Fields

• Code – A deprecated field; earlier, it was used as a response status. Always equals 1.
• ID – The product’s unique ID.
• Prod_id – The product identifier by the manufacturer (also known as product code).
• Name – The product description (product model description) for the requested locale or the international value if the former is absent.
• IntName – The international product description (product model description).
• LocalName – The product description (product model description) for the requested locale or an empty string if the former is absent.
• GeneratedIntTitle – Title created according to our rules for the international locale. Can be any type depending on product completeness.
• GeneratedLocalTitle – Title that always has localName in it for the requested locale, or its international variant if the record for the requested locale is absent. For the requested INT locale and for the products without localName, this field is always empty.
• BrandLocalTitle – Title that always has features in it for the requested locale or its international variant if the record for the requested locale is absent. For the requested INT locale, this field is always empty.
• Title – Title created according to our rules for the requested locale or its international variant if there is no data for the requested locale. Can be any type depending on product completeness. It is either a copy of a GeneratedLocalTitle or BrandLocalTitle.
• Quality – The quality of the product (ICECAT or SUPPLIER). SUPPLIER – only the original product data as imported from a brand’s CMS, not yet standardized by our editors; ICECAT – data-sheet is standardized and reviewed by our editors.
• ReleaseDate – The release date for the requested locale, or the international one if the former is absent, in the format YYYY-MM-DD. If the international release date is absent, an empty string is used.

<Product> Image Fields

• HighPic – A link to the product’s main picture of type ‘high’ or an empty string if there is no main picture.
• HighPicHeight – The height of the main picture of type ‘high’ in pixels, or 0 if there is no main picture.
• HighPicWidth – The width of the main picture of type ‘high’ in pixels, or 0 if there is no main picture.
• HighPicSize – The size of the main picture of type ‘high’ in bytes, or 0 if there is no main picture.
• LowPic – A link to the product’s main picture of type ‘low’ or an empty string if there is no main picture.
• LowPicHeight – The height of the main picture of type ‘low’ in pixels, or 0 if there is no main picture.
• LowPicWidth – The width of the main picture of type ‘low’ in pixels, or 0 if there is no main picture.
• LowPicSize – The size of the main picture of type ‘low’ in bytes, or 0 if there is no main picture.
• Pic500x500Height – The height of the main picture of type ‘medium’ in pixels, or 0 if there is no main picture. Also, 0 will be used if the medium-type picture is absent.
• Pic500x500Width – The width of the main picture of type ‘medium’ in pixels, or 0 if there is no main picture. Also, 0 will be used if the medium-type picture is absent.
• Pic500x500Size – The size of the main picture of type ‘medium’ in bytes, or 0 if there is no main picture. Also, 0 will be used if the medium-type picture is absent.
• ThumbPic – A link to the product’s main picture of type ‘thumb’ or an empty string if there is no main picture.
• ThumbPicSize – The size of the main picture of type ‘thumb’ in bytes, or 0 if there is no main picture.

<CategoryFeatureGroup>

<CategoryFeatureGroup ID="" No="">
  <FeatureGroup ID="">
    <Name ID="" langid="" Value=""/>
  </FeatureGroup>
</CategoryFeatureGroup>

• ID – Category Feature Group unique ID.
• No – a Priority indicator. The higher the number, the more important the feature group is for buyer orientation. Thus, we advise you to sort feature groups by priority to get a more customer-friendly user presentation.

<FeatureGroup>

• ID – Feature Group unique ID.

<Name>

• ID – Translation unique ID.
• langid – Locale numerical ID from Table.
• Value – translation of FeatureGroup for the current locale.

<Category>

<Category ID="">
	<Name ID="" langid="" Value=""/>
	<VirtualCategories>
		<VirtualCategory ID="195" UNCATID="43171895">
			<Name ID="1131406" langid="1" Value="PCs"/> 
		</VirtualCategory> 
	</VirtualCategories>
</Category>

• ID – Category unique ID from CategoriesList.xml.gz

<Name>

For Category and VirtualCategory

• ID – Translation unique ID.
• langid – Locale numerical ID from Table.
• Value – Translation of Category for current locale.

<VirtualCategory>

A virtual category is an extra way to group products in addition to the main Icecat category. For example, Ultrabooks is a virtual category under the main Notebooks category in Icecat.

• ID – Virtual Category unique ID.
• UNCATID – United Nations Standard Products and Services Code (UNSPSC).

<EanCode>

<EANCode EAN="" VariantID="" Format="" IsApproved=""/>

• EAN – EAN/GTIN without modifications.
• VariantID – Variant ID. Optional attribute, present only if GTIN belongs to product Variant
• Format – EAN/GTIN format. Possible values: 'GTIN-14','GTIN-13','GTIN-12','GTIN-8')
• IsApproved – Can be 1 (Yes) or 0(No).

GTIN is considered approved if either:

1. GTIN is approved by Brand.
2. Icecat editors manually approve it based on their data.
3. At least one trusted distributor has the product in their stock.
4. Three any distributors have the product in their stock.

By default, you will only see approved GTINs. In case you wish to access Non-Approved, please contact support.

<FeatureLogo>

This asset type represents specific features accompanied by textual descriptions and images. It functions similarly to a patent or certificate, where an image is required for validation.

🇪🇺 The EU Energy Efficiency Class Logo is also present as a Feature Logo!

<FeatureLogo ID="" Feature_ID="" Value="" LogoPic="" Width="" Height="" Size="">
  <Descriptions>
    <Description ID="" langid="">SOME_VALUE</Description>
  </Descriptions>
  <FeatureLogoFeatures>
    <FeatureLogoFeature ID="">
      <FeatureLogoValues>
        <FeatureLogoValue ID="">SOME_VALUE</FeatureLogoValue>
      </FeatureLogoValues>
    </FeatureLogoFeature>
  </FeatureLogoFeatures>
</FeatureLogo>

• ID – Feature Logo unique ID.
• Feature_ID – Identifier of the product feature. If there are multiple features, the one with the smallest ID is used.
• Value – Value of the product feature. If there are multiple features, the one with the smallest ID is used.
• LogoPic – Link to the Feature Logo picture.
• Width – Width of the Feature Logo picture in pixels.
• Height – Height of the Feature Logo picture in pixels.
• Size – Size of the Feature Logo picture in bytes.

<Descriptions>

• ID – Description ID
• langid – Locale numerical ID from Table.

<FeatureLogoFeatures>

Includes all features associated with the current FeatureLogo. It ID may be Feature_ID.

💡 FeatureLogoValue is always a single value in FeatureValueLogos

<ReleaseDate>

<ReleaseDate>
  <Date Value="" langid=""/>
</ReleaseDate>

<Date>

💡 Each product has only one release date for each locale.

• Value – Date in format YYYY-MM-DD.
• langid – Locale numerical ID from Table.

<EndOfLifeDate>

<EndOfLifeDate>
  <Date Value="" langid=""/>
</EndOfLifeDate>

The same as <ReleaseDate>.

<ReasonsToBuy>

<ReasonsToBuy>
	<ReasonToBuy ID="" Value="" HighPic="" HighPicSize="" No=""
  Title="" langid="" origin="RTB" IsRich="">
  
  <ReasonToBuy ID="" Feature_ID="" Value="" HighPic="" HighPicSize="" No=""
  Title="" langid="" origin="FeatureLogo" IsRich="">
    <FeatureList>
      <Feature ID="">
        <Titles>
          <Title langid="">SOME_VALUE</Title>
        </Titles>
        <Values>
          <Value langid="">SOME_VALUE</Value>
        </Values>
      </Feature>
    </FeatureList>
  </ReasonToBuy>
</ReasonsToBuy>

Reason to Buy – is marketing information provided by the Brand. There are two RTB types:

Original Reason To Buy – marketing information provided by the brand, may include text and pictures.

FeatureLogo Reason To Buy – some feature logos may be used as marketing information, for instance, Certificates. Reason to Buy, created from FeatureLogo. In this case, Certificate.

<ReasonToBuy>

• ID – Reason to Buy ID.
• Feature_ID – only in FeatureLogo RTB, the ID of the Feature associated with the logo.
• Value – marketing information to be used in the text.
• HighPic – Link to RTB image, if exists.
• HighPicSize – Size of the RTB image in bytes.
• No – Priority indicator. The higher the number the more important the RTB is for buyer orientation.
• Title – marketing information to be used in title.
• langid – Locale numerical ID from Table.
• origin – either RTB or FeatureLogo
• IsRich – whether the RTB is private

<Feature>

• ID – Feature ID

<Title>

Name of the Feature.

• langid – Locale numerical ID from Table.

<Value>

Value of the Feature.

• langid – Locale numerical ID from Table.

<BulletPoints>

<BulletPoints>
  <BulletPoint TaxonomyName="" Value="" langid="" No=""/>
</BulletPoints>

Manually added bullet points.

<BulletPoint>

• Value – Bullet Point value for chosen locale.
• langid – Locale numerical ID from Table.
• TaxonomyName – exists only in taxonomy-exclusive BulletPoints. Include the name of the Taxonomy.
• No – Priority indicator. The higher the number, the more important the BulletPoint is for buyer orientation.

<GeneratedBulletPoints>

<GeneratedBulletPoints>
  <GeneratedBulletPoint Value="" langid="" No=""/>
</GeneratedBulletPoints>

Bullet points are created from features according to templates. The minimal amount of GeneratedBullerPoints is 3, otherwise, the tag is empty.

<GeneratedBulletPoint>

• Value – Generated Bullet Point value for chosen locale.
• langid – Locale numerical ID from Table.
• No – Priority indicator. The higher the number the more important the BulletPoint is for buyer orientation.

<ProductBundled>

<ProductBundled/>

Technical value. Deprecated tag, always empty.

<ProductDescription>

<ProductDescription ID=""
   TaxonomyName="" 
   LongDesc="" 
   ManualPDFSize="" 
   ManualPDFURL="" 
   MiddleDesc="" 
   PDFSize="" 
   PDFURL="" 
   ShortDesc="" 
   URL="" 
   WarrantyInfo=""
   langid=""/>									

💡Our descriptions are formatted as HTML, so you may encounter the following elements: <b>, <br />, <sup>, <p>.

• ID – Description identifier. If ID is equal to 0, the Description is exclusive to certain Taxonomy.
• TaxonomyName – exists only in taxonomy-exclusive descriptions. Include the name of the Taxonomy.
• LongDesc – Long marketing product information.
• ManualPDFSize – Size of Manual PDF, if it exists in product multimedia objects.
• ManualPDFURL – Link to Manual PDF, the same as in multimedia objects.
• MiddleDesc – Middle marketing product information.
• PDFSize – Size of Leaflet PDF, if it exists in product multimedia objects.
• PDFURL – Link to Leaflet PDF, the same as in multimedia objects.
• ShortDesc – Short product information.
• URL – Description source.
• WarrantyInfo – Information on brand’s warranties.
• langid – Locale numerical ID from Table.

<Disclaimers>

<Disclaimers>
  <Disclaimer TaxonomyName="" langid="" value=""/>
</Disclaimers>

The footnotes ¹ from the <ProductDescription> will be displayed here.

• langid – Locale numerical ID from Table.
• value – Disclaimer text.
• TaxonomyName – exists only in taxonomy-exclusive Disclaimers. Include the name of the Taxonomy.

<ProductFamily>

<ProductFamily ID="" LowPic="" ThumbPic="">
  <Name ID="" langid="" Value=""/>
  <Series ID="">
    <Name ID="" langid="" Value=""/>
  </Series>
</ProductFamily>

• ID – Product Family ID.
• LowPic – Family Logo picture.
• ThumbPic – Family Thumb picture.

<Name>

The Name tag is a translation of ProductFamily for a certain locale.

• ID – translation ID.
• langid – Locale numerical ID from Table.
• Value – Product Family value for locale.

<Series>

If ProductFamily has Series, the corresponding tag is added. <Series> serves as a container for translations, and its only attribute is ID.

<Name>

The same as ProductFamily, translations for Series name for different locales.

<ProductFeature>

<ProductFeature 
	Localized="" 
	ID="" 
	Local_ID="" 
	Value="" 
	CategoryFeature_ID=""
	CategoryFeatureGroup_ID="" 
	No="" 
	Presentation_Value="" 
	Translated="" 
	Mandatory=""
	Searchable=""
	Optional=""
	>
		
  <LocalValue Value="">
    <Measure ID="">
      <Signs>
        <Sign ID="" langid=""><![CDATA[SOME_VALUE]]></Sign>
      </Signs>
    </Measure>
  </LocalValue>
  <Feature ID="">
    <Measure ID="" Sign="">
      <Signs>
        <Sign ID="" langid=""><![CDATA[SOME_VALUE]]></Sign>
      </Signs>
    </Measure>
    <Name ID="" langid="" Value=""/>
  </Feature>
</ProductFeature>

• Localized – Feature might have Local_ID or International ID. The localized attribute shows which of the IDs is present in the product. In case the feature has only International ID, it is not Localized ⇒ Localized is equal to 0 (FALSE), otherwise, it is 1 (TRUE).
• ID – presentation value ID.
• Local_ID – local presentation value ID.
• Value – raw value.
• CategoryFeature_ID – which CategoryFeature group the Feature belongs to. Can be matched with CategoryFeaturesList.
• CategoryFeatureGroup_ID – which CategoryFeature group the Feature belongs to.
• No – Priority indicator. The higher the number, the more important the feature is for buyer orientation.
• Presentation_Value – fancy-looking value.
• Translated – if the feature has a translation.
• Mandatory – Is mandatory.
• Searchable – is searchable.
• Optional – specifications tagged with Optional=”1″ are not standardized specifications in Icecat. These specs are used only for supporting automated data imports from brands to avoid losing attribute values.

💡Use the Presentation_Value parameter in localized data-sheets for display of a data-sheet, and use the Value parameter for search and compare.

<LocalValue>

LocalValue is a transformation of the international Value according to the local dictionary and the applicable Metric/Imperial value system. For the US, the values will be shown in inches; for Europe, in centimeters.

For local applications, we advise using LocalValue for search and compare functionalities

<Measure>

You can check the Measures using the MeasuresList export file.

<Signs>

Visual representation of a measure (″ for inches).

<Feature>

Contains only FeatureID. Can be matched with FeaturesList export file. Measure and Signs are the same.

<Name>

Represents a feature name. ID, Value and LangID. An example of a value is Display resolution .

<ProductGallery>

<ProductGallery>
    <ProductPicture 
ExpirationDate="" 
	    LowPic="" 
	    LowPicHeight="" 
	    LowPicWidth=""
	    LowSize="" 
	    No="" 
	    Original="" 
	    OriginalSize="" 
	    Pic="" 
	    Pic500x500="" 
	    Pic500x500Height="" 
	    Pic500x500Size="" 
	    Pic500x500Width="" 
	 PicHeight=""
	    PicWidth="" 
	    ProductPicture_ID="" 
			Size="" 
			ThumbPic="" 
			ThumbSize="" 
			Type=""
	    UpdatedDate="" 
	    langid=""/>
</ProductGallery>

💡Icecat may change links for pictures, they are not constant. Make sure you download the images to share with your clients.

Each picture in Icecat is transformed the following resolutions:

💡For users convenience, pictures from FeatureLogos are duplicated in <ProductGallery>.

🔍Read More: How to Make the Product Gallery Great Again

<ProductPicture>

• IsMain – Shows if the picture is Main. Duplicates the picture from <Product>. If the picture is not Main, the attribute is not present. Hence, IsMain always equals Y.
• ExpirationDate – Shows when the picture is going to be deactivated in format YYYY-MM-DD. If the image has no expiration date, the attribute is not present.
• IsRich – Whether the picture is private.
• LowPic – Link for the Low picture.
• LowPicHeight – Up to 200px.
• LowPicWidth – Up to 200px.
• LowSize – Size of a low picture in bytes.
• No – Priority indicator. The higher the number, the more important the picture is for buyer orientation.
• Original – link to original picture with initial format and intitial size. Allowed image formats are: image/jpeg, image/png, image/tiff, image/bmp, image/x-windows-bmp, image/x-ms-bmp, image/webp.
• OriginalSize – Original picture’s size in bytes.
• Pic – A Link to the original image converted to .jpg.
• Pic500x500 – Link to 500x500 picture.
• Pic500x500Height – Up to 500px.
• Pic500x500Size – 500x500 picture size in bytes.
• Pic500x500Width – Up to 500px.
• PicHeight – Original picture height.
• PicWidth – Original picture width.
• ProductPicture_ID – Picture ID.
• Size – Size of the original picture converted to .jpg.
• Source – Optional, link for the source link in case it exists.
• ThumbPic – Link to the Thumb picture (75x75px).
• ThumbSize – Sie for the Thumb in bytes.
• Type – Image type. For more information, please check this article.
• UpdatedDate – Last modification in format YYYY-MM-DD hh:mm:ss.
• langid – Locale numerical ID from Table. Optional. For INT images, this attribute is not present.

<ProductMultimediaObject>

Icecat provides a variety of multimedia objects. Please note that depending on the MMO type, the attributes can be different!

• 🇪🇺 EU Product Fiche (.pdf) – The product sheet for determining results in accordance with energy labeling requirements and considering ecodesign requirements. The information is intended for users to reduce the overall environmental impact of the product’s operation.
• 🇪🇺 EU Energy Label (.pdf and .jpeg)
• 🇬🇧 UK Energy Label (.pdf and .jpeg)
• 🇫🇷 Repairability index overview (.pdf and .jpeg)
• Leaflet (.pdf) – marketing brochure.
• Manual PDF (.pdf) – manual for product.
• Other PDF (.pdf) – see Other PDFs below.
• Safety Data Sheet (.pdf) – safety instructions.
• Size Chart (.pdf) – document with the dimension and sizes data, for instance for cloths.
• video (.mp4)
• 360 (.jpeg) – a gallery of 360° 3D view of the product
• ProductStory (.html/.zip) – a folder with an HTML page and its assets. Usually, a promo material with product presentation.
• ProductStory2.0(.txt) – a text with compressed HTML document with the same purpose.

• Story text (.txt) the text document with HTML code for embedding;
• Generated PDF – in case the product does not have a Leaflet asset, Icecat will create a PDF based on existing information. ❗This feature applies to the Open Icecat catalogue only.

Other PDFs:

• Carbon Footprint
• CE Marking
• Safety Information
• 🇪🇺 EU Declaration of Conformity
• 🇬🇧 UK Declaration of Conformity
• Quick Start Guide
• Durability Index
• Other

<ProductMultimediaObject> Default View

Types: EU Product Fiche, Repairability Index Overview, Leaflet, Manual PDF, Other PDF, Safety Data Sheet, Size Chart, ProductStory, ProductStory2.0, Generated PDF

<ProductMultimediaObject>
  <MultimediaObject 
	  ContentType="" 
	  Date="" 
	  Description="" 
	  ExpirationDate="" 
	  Height="" 
	  IsRich="" 
	  KeepAsURL="" 
	  MultimediaObject_ID="" 
	  PreviewHeight="" 
	  PreviewSize="" 
	  PreviewUrl="" 
	  PreviewWidth="" 
	  Size="" 
	  Source="" 
	  Type="" 
	  URL=""
	  UUID="" 
	  Width="" 
	  langid=""/>
</ProductMultimediaObject>

• ContentType – MIME-type.
• Date – Last updated date in format YYYY-MM-DD hh:mm:ss.
• Description – ММО description.
• ExpirationDate – if an MMO has an expiration date, it is added in format YYYY-MM-DD. If attribute is not present, the MMO never expires.
• Height – Technical field. Always 0.
• IsRich – Whether the MMO is Private
• KeepAsURL – If 1, the third-party website is used in the URL attribute. If 0, MMO object is stored on object.icezat.biz.
• MultimediaObject_ID – MMO unique ID.
• PreviewHeight – Technical attribute Always 0.
• PreviewSize – Technical attribute. Always 0.
• PreviewUrl – Technical attribute. Always an empty string.
• PreviewWidth – Technical attribute. Always 0.
• Size – Size of the MMO in bytes. For the objects with KeepAsURL=1, the size is always 0.
• Source – Link to the MMO object on Brand’s official website. Optional.
• Type – In this case, EU Product Fiche, Repairability index overview, Leaflet, Manual PDF, Other PDF, Safety Data Sheet, Size Chart, ProductStory, ProductStory2.0, Generated PDF.
• URL – Link to MMO for the user to fetch.
• UUID – UUID for the ММО.
• Width – Technical attribute. Always 0.
• langid – Locale numerical ID from Table.

<ProductMultimediaObject> for Video

Type: video/mp4

<ProductMultimediaObject>
  <MultimediaObject 
	ContentType="" 
	Date="" 
	Description="" 
	ExpirationDate=""
	Height="" 
	IsRich="" 
	KeepAsURL="" 
	MultimediaObject_ID="" 
	OriginalMD5="" 
	PreviewHeight="" 
	PreviewSize="" 
	PreviewUrl="" 
	PreviewWidth=""  
	Size="" 
	Source="" 
	ThumbUrl=""
	Type="video/mp4" 
	URL="" 
	UUID="" 
	Width="0" 
	langid=""/>
</ProductMultimediaObject>

• OriginalMD5 – MD5 hash of the video on Icecat storage. For products with KeepAsURL=1 does not appear.
• ThumbUrl – Link to a video thumb picture.
• Type – Always video/mp4.
• Other – Same as in default view.

<ProductMultimediaObject> for Energy Label

Types: EU Energy Label**,** UK Energy Label

<ProductMultimediaObject>
  <MultimediaObject 
	  ContentType="" 
	  Date="" 
	  Description="" 
	  ExpirationDate=""
	  Height="" 
	  IsRich="" 
	  KeepAsURL="" 
	  MultimediaObject_ID="" 
	  PreviewHeight="" 
	  PreviewSize="" 
	  PreviewUrl="" 
	  PreviewWidth=""  
	  Size="" 
	  Source="" 
	  ThumbUrl=""
	  Type="" 
	  URL="" 
	  UUID="" 
	  Width="0" 
	  langid=""
	  LabelType=""
	  EprelLink=""
	  ConvertedURL="<https://objects.icecat.biz/objects/36273251_13720781.jpeg>"
	  ConvertedSize="259644" 
	  ConvertedContentType="image/jpeg"
	  EprelId=""
	  />
</ProductMultimediaObject>

• Type – EU Energy Label / UK Energy Label
• LabelType – Energy Label type: rescaled or non-rescaled .
• EprelLink – Link to EPREL. What is EPREL?
• EprelId – ID from EPREL link.
• ConvertedURL – Any Energy Label is provided in two formats: .jpg and .pdf . If the orginal URL has .pdf document, the ConvertedURL will contain the link to .jpg and vice versa.
• ConvertedSize – The size of the converted PDF/JPG in bytes.
• ConvertedContentType – Either .PDF or .JPG
• Other – Same as in default view.

<ProductMultimediaObject> for 360° 3D view

<ProductMultimediaObject>
  <MultimediaObject 
	ContentType="" 
	Date="" 
	Description="" 
	ExpirationDate="" 
	Height="" 
	IsRich="" 
	KeepAsURL="" 
	MultimediaObject_ID="" 
	Type="360" 
	UUID=""
	Width="" 
	langid="">
    <ImagesList360>
      <Image Link="" No=""/>
    </ImagesList360>
  </MultimediaObject>
</ProductMultimediaObject>

• Height – Height of the pictures in px.
• KeepAsURL – Always 0.
• Type – Always 360.
• Width – Width of the pictures in px.
• Other – Same as in default view.

<ImageList360> contains a set of images clockwise that show the product from every angle.

<Image>

• Link – Link for the picture.
• No – The serial number of the picture in the 360 set.

<ProductRelated>

Up-sell and cross-sell products. Additional info is available here: Related Products in Icecat XML and JSON Data Channels. By default, you will see up to 500 related products, but you may adjust this value with the relations_limit parameter. Each Product Relation is indicated in a separate <ProductRelated> tag.

<ProductRelated ID="" Category_ID="" Preferred="">
  <Product ID="" Prod_id="" ThumbPic="" Name="">
    <Supplier ID="" Name=""/>
    <Names>
       <Name langid="" Value="" />
    </Names>
  </Product>
  <ProductRelatedLocales>
    <ProductRelatedLocale ID="0" langid="0" Preferred="0" StartDate="" EndDate=""/>
  </ProductRelatedLocales>
</ProductRelated>

• ID – Product Relation ID. If the ID is equal to 0, the relation is added automatically.
• Category_ID – ID of the Category of the product.
• Preferred – Whether Brand recommends the product.

<Product>

• ID – Icecat Product ID.
• Prod_id – Product Code of a related product.
• ThumbPic – Link to the main image of a related product in thumb size. May be empty if picture is unavailable.
• Name – Product model description of a related product.

<Supplier>

• ID – Brand ID from the SuppliersList.xml.
• Name – Brand Name.

<ProductRelatedLocales>

• ID – Related locale ID.
• Language – Language code.
• Preferred – Whether the brand recommends the product.
• StartDate – The Date since the brand recommends the product.
• EndDate – The Date until the brand recommends the product.

<SEOs>

<SEOs>
  <SEO TaxonomyName="" Description="" Keywords="" Title="" langid=""/>
</SEOs>

• Description – meta description used by search engines to summarize the content of the page. It often appears below the clickable title in search results.
• TaxonomyName – exists only in taxonomy-exclusive SEOs. Include the name of the Taxonomy.
• Keywords – used to define relevant keywords for the content of the page.
• Title – meta title for the page, displayed as the clickable headline in search results and at the top of the browser tab.
• langid – Locale numerical ID from Table.

<SummaryDescription>

<SummaryDescription>
    <ShortSummaryDescription langid="">SOME_VALUE</ShortSummaryDescription>
    <LongSummaryDescription langid="">SOME_VALUE</LongSummaryDescription>
</SummaryDescription>

This tag provides a SummaryDescription for the requested language.

• <ShortSummaryDescription> – Automatically generated short summary description based on general data and key specs
• <LongSummaryDescription> – Automatically generated Long summary description based on general data and key specs

<SummaryDescriptionLocal>

<SummaryDescriptionLocal>
    <ShortSummaryDescriptionLocal langid="">SOME_VALUE</ShortSummaryDescription>
    <LongSummaryDescriptionLocal langid="">SOME_VALUE</LongSummaryDescription>
</SummaryDescriptionLocal>

This tag appears only in 🌐 International XML. Contains non-International SummaryDescriptions. The structure is the same.

<Supplier>

<Supplier ID="" Name="">
  <Names>
    <Name ID="" langid="" Value=""/>
  </Names>
</Supplier>

• ID – ID from SuppliersList.xml.gz
• Name – International name from SuppliersList.xml.gz

<Names> tag contains translations of a brand name to other languages. For instance, Japanese XML might have Brand’s name written in Katakana.

<Name>

• ID – Name ID
• langId – Locale numerical ID from Table.
• Value – Name in a certain language.

<BrandOrganizations>

<BrandOrganizations>
    <BrandOwner>
       <Organization 
		       ID="000000000-0000-0000-0000-0000000000000" 
		       Name="Organization Name 1" 
		       CountryCode="US" 
		       State="Oregon" 
		       City="Beaverton" 
		       Street="One Bowerman Drive" 
		       HouseNumber="1" 
		       ZIP="97005">
		      <URLs>
           <URL><https://website1.com></URL>
           <URL><https://website2.com></URL>
          </URLs>
          <Emails>
	          <Email>email1@domain.com</Email>
	          <Email>email2@domain.com</Email>
	         </Emails>
	      </Organization>
	  </BrandOwner>
	<Licensees>
	  <Licensee ID="123456790">
	    <Organization 
		ID="000000000-0000-0000-0000-0000000000000" 
		Name="Organization Name 2" 
		CountryCode="US" 
		State="California" 
		City="Los Angeles" 
		Street="Main Street" 
		HouseNumber="100" 
		ZIP="90001">
	     <URLs>
	       <URL><https://website3.com></URL>
             </URLs>
             <Emails>
	       <Email>email3@domain.com</Email>
	        <Email>email4@domain.com</Email>
	     </Emails>
	       </Organization>
	   </Licensee>
	</Licensees>
	   <Representatives>
	     <Representative ID="123456791">
              <Organization 
		ID="000000000-0000-0000-0000-0000000000000" 
		Name="Organization Name 3" 
		CountryCode="UK" 
		City="London" 
		Street="Baker Street" 
		HouseNumber="221B" 
		ZIP="NW1 6XE">
	<URLs>
           <URL><https://website4.com></URL>
	</URLs>
	<Emails>
	   <Email>email5@domain.com</Email>
	   <Email>email6@domain.com</Email>
	</Emails>
    </Organization>
   </Representative>
  </Representatives>
</BrandOrganizations>

BrandOrganizations Section

• This section contains all the Brand-Organization relationships associated with a product.
• The structure mirrors that of BrandOrganizations.xml.gz, except that the product XML does not contain the Updated attribute.

Brand Relations

• <BrandOwner>: The main manufacturer of the brand’s products. A brand has only one owner.
• <Licensees>: Organizations that manufacture products under the brand. A brand may have multiple licensees.
• <Representatives>: Legal entities responsible for sustainability-related matters for the brand.

<Organization>

• ID – Unique UUID identifier for the organization.
• Name – Official name of the organization.
• CountryCode – ISO Alpha-2 country code.
• State – Only available for applicable countries (e.g., US).
• City, Street, HouseNumber, ZIP – Address details.
• URLs – List of official websites (mandatory).
• Emails – Contact email addresses (optional).

<CatalogObjectCloud>

<CatalogObjectCloud>
  <ProductPage QRCodeURL="" URL=""/>
</CatalogObjectCloud>

Contains a QR code and a link to https://coc.icecat.biz, permalink to product information.

<ProductPage>

• QRCodeURL – link to https://coc.icecat.biz represented as QR-code
• URL – link to https://coc.icecat.biz represented as link

<Variants>

<Variants>
  <Variant ID="" Desc="">
    <VariantIdentifiers>
      <Identifier Type="" Value="" IsApproved=""/>
    </VariantIdentifiers>
    <VariantFeatures>
      <VariantFeature Feature_ID="" Value="" langid=""/>
    </VariantFeatures>
    <VariantImages>
      <VariantImage/>
      <VariantImage ExpirationDate="" LowPic="" LowPicHeight="" LowPicWidth=""
      LowSize="" No="" Original="" OriginalSize="" Pic="" Pic500x500="" 
      Pic500x500Height="" Pic500x500Size="" Pic500x500Width="" PicHeight=""
      PicWidth="" ProductPicture_ID="" Size="" ThumbPic="" ThumbSize="" Type=""
      UpdatedDate="" langid=""/>
    </VariantImages>
    <VariantMultimedias>
      <VariantMultimedia ContentType="" Date="" Description="" ExpirationDate=""
      Height="" IsRich="" KeepAsURL="" MultimediaObject_ID="" OriginalMD5="" 
      PreviewHeight="" PreviewSize="" PreviewUrl="" PreviewWidth=""  Size="" 
      Source="" ThumbUrl="" Type="video/mp4" URL="" UUID="" Width="0" langid=""/>
  
      <VariantMultimedia ContentType="" Date="" Description="" ExpirationDate="" 
      Height="" IsRich="" KeepAsURL="" MultimediaObject_ID="" Type="360" UUID=""
      Width="" langid="">
        <ImagesList360>
          <Image Link="" No=""/>
        </ImagesList360>
      </VariantMultimedia>
  
      <VariantMultimedia ContentType="" Date="" Description="" ExpirationDate="" 
      Height="" IsRich="" KeepAsURL="" MultimediaObject_ID="" PreviewHeight="" 
      PreviewSize="" PreviewUrl="" PreviewWidth="" Size="" Source="" Type="" URL=""
      UUID="" Width="" langid=""/>
    </VariantMultimedias>
  </Variant>
</Variants>

Product Variant – a product that is the same as the original product but differs in one or two parameters. For instance, the yellow iPhone is a variant of the silver iPhone. The tag <Variants> describes the differences of a variant from the original product.

<Variant>

• ID – Unique Variant ID
• Desc – Variant description

<Identifier>

• Type – Type of the variant Identifier; can be GTIN or Product Code
• Value – Value or the variant Identifier
• IsApproved – exists for type GTIN only and shows whether it is confirmed by the distributor.

<VariantFeature>

• FeatureID – ID of the variant feature that differs from the original
• Value – New value of the feature.
• langid – Locale numerical ID from Table.

<VariantImage>

The same as <ProductPicture> in <Product Gallery>

<VariantMultimedia>

The same as <ProductMultimediaObject>

<Reviews>

  <Reviews>
   <Review ID="" langid="" Score="" Published="" Author="">
    <URL>SOME_VALUE</URL>
    <Comment>SOME_VALUE</Comment>
    <Good>SOME_VALUE</Good>
    <Bad>SOME_VALUE</Bad>
    <Bottomline>SOME_VALUE</Bottomline>
   </Review>
  </Reviews>

💡This tag is available for brands HP and ATEN.

🔍 Read more: Reviews Manual.

<Review>

• ID – Unique ID of the review
• langid – Locale numerical ID from Table.
• Score – Review score, 0 if undefined.
• Published – Publication date in format YYYY-MM-DD
• Author – name of the author

<URL>

Link to the website where the review is published. For instance, https://monitornerds.com/.

<Comment>

Comment to the product. If long, not published fully. Please check the original review.

<Good>

Positive sides of the product mentioned in the review. If long, not published fully.

<Bad>

Negative sides of the product mentioned in the review. If long, not published fully.

<BottomLine>

Summary of the review. If long, not published fully.

<ProductModelDescriptions/>

<ProductModelDescriptions>
  <Name langid="" Value=""/>
  ...
</ProductModelDescriptions>

🌐Is available in International (INT) locale only.

Includes all Names (Product Model Descriptions) from a <Product> tag in all languages available to the user.

<Name>

• langid – Locale numerical ID from Table for Name (Product Model Description)
• Value – value of the Name (Product Model Description) in chosen language

<ProductTitles/>

<ProductTitles>
  <Titles>
    <Title langid="" Value=""/>
    ...
  </Titles>
  <GeneratedLocalTitles>
    <GeneratedLocalTitle langid="" Value=""/>
    ...
  </GeneratedLocalTitles>
  <BrandLocalTitles>
    <BrandLocalTitle langid="" Value=""/>
    ...
  </BrandLocalTitles>
</ProductTitles>

🌐Is available in International (INT) locale only.

Shows Product Title attributes from <Product> for all locales the user is subscribed to.

<Title>

The same as the Title attribute from <Product>

• langid – Locale numerical ID from Table.
• Value – Title (either GeneratedLocalTitle or BrandLocalTitle)

<GeneratedLocalTitle>

The same as the GeneratedLocalTitle attribute from <Product>

• langid – Locale numerical ID from Table.
• Value – always GeneratedLocalTitle

<BrandLocalTitle>

The same as BrandLocalTitle attribute from <Product>

• langid – Locale numerical ID from Table.
• Value – always BrandLocalTitle.

Error Messages

📖 Which JSON and XML Error Messages can I get using Icecat?

Reference Files

• CategoriesList.xml.gz
• CategoryFeatureIntervalsList.xml
• CategoryFeaturesList.xml.gz
• DistributorList.xml.gz
• FeatureGroupsList.xml.gz
• FeatureLogosList.xml.gz
• FeatureValuesVocabularyList.xml.gz
• FeaturesList.xml.gz
• LanguageList.xml.gz
• MeasuresList.xml.gz
• RelationsList.xml
• SupplierProductFamiliesListRequest.xml.gz
• SuppliersList.xml.gz
• BrandOrganizations.xml.gz

Almost all files are present in gzipped format. The typical use of the files is in combination with data from the INT (international) directory, not the localized directories as there the language-specific values are already automatically applied to the product XML files.

To benefit in your server scripts from gzip, you must use in any HTTP request this additional parameter:

Accept-Encoding: gzip

To retrieve the files mentioned above, you can refer to the manual on obtaining Icecat export files. The manual outlines the steps to retrieve these files, ensuring a seamless integration with your data processing needs.

CategoriesList

<CategoriesList>
	<Category ID="1" LowPic="" Score="0" Searchable="0" ThumbPic="" UNCATID="" Visible="0" Updated="2014-10-23 08:54:42">
		<ParentCategory ID="1">
			<Names/>
		</ParentCategory>
	</Category>
	<Category ID="2" LowPic="<http://images.icecat.biz/img/low_pic/2-8879.jpg>" Score="0" Searchable="0" ThumbPic="<http://images.icecat.biz/thumbs/CAT2.jpg>" UNCATID="43160000" Visible="0" Updated="2020-12-17 11:29:58">
		<Description ID="548795" Value="Instructions for a computer's processor..." langid="1" Updated="2018-10-30 14:47:54"/>
		<Description ID="423769" Value="Podstawowa jednostka dystrybucji..." langid="14" Updated="2018-10-30 14:47:54"/>
		<Description ID="2386698" Value="Instructions for a computer's processor..." langid="55" Updated="2018-10-30 14:47:54"/>
		<Keywords ID="332" Value="" langid="2" Updated="2021-01-19 13:27:57"/>
		<Keywords ID="333" Value="" langid="3" Updated="2021-01-19 13:27:57"/>
		<Name ID="3727364" Value="Software" langid="1" Updated="2018-02-14 15:44:49"/>
		<Name ID="3768558" Value="Software" langid="2" Updated="2018-02-14 16:29:19"/>
		<Name ID="3785003" Value="Logiciels" langid="3" Updated="2018-02-14 16:58:55"/>
		<ParentCategory ID="2833">
			<Names>
				<Name ID="3729373" Value="Computers & Peripherals" langid="1" Updated="2020-05-14 16:39:06"/>
				<Name ID="6842958" Value="Computers & accessories" langid="2" Updated="2020-10-16 16:43:00"/>
			</Names>
		</ParentCategory>
	</Category>
</CategoriesList>

This chunk provides information on Icecat categories. Each category may be either searchable or not. Searchable categories may be used for product lookup by product feature values, as Icecat editors systematically maintain data integrity to allow smart searches.

The Score attribute in the response reflects the category usage statistic. The higher the number means the higher the usage level.

CategoryFeaturesList

<CategoryFeaturesList Code="1">
	<Category ID="2" LowPic="<http://images.icecat.biz/img/low_pic/2-8879.jpg>" UNCATID="43160000" Updated="2020-12-17 11:29:58">
		<CategoryFeatureGroup ID="120" No="0">
			<FeatureGroup ID="0">
				<Name ID="7675635" Value="Technical details" langid="73" Updated="2020-12-15 14:27:37"/>
				<Name ID="7876998" Value="Dettagli tecnici" langid="74" Updated="2020-12-15 14:27:37"/>
			</FeatureGroup>
		</CategoryFeatureGroup>
		<Feature CategoryFeatureGroup_ID="120" CategoryFeature_ID="111" Class="0" ID="66" LimitDirection="0" Mandatory="0" No="111226" Searchable="0" Type="numerical" Use_Dropdown_Input="N" ValueSorting="0" Updated="1970-01-01 23:00:00">
			<Measure ID="19" Sign="MB" Updated="2008-03-09 17:19:09">
				<Sign>MB</Sign>
				<Signs>
					<Sign ID="15506" langid="1" Updated="2013-12-03 10:19:26">MB</Sign>
					<Sign ID="196" langid="2" Updated="2020-12-24 15:56:40">MB</Sign>
				</Signs>
			</Measure>
			<Name ID="1469" Value="Minimum storage drive space" langid="1" Updated="2018-12-27 16:41:27"/>
			<Name ID="477748" Value="Minimale opslag schijfruimte" langid="2" Updated="2019-01-04 10:37:33"/>
			<RestrictedValue/>
		</Feature>
		<Feature CategoryFeatureGroup_ID="120" CategoryFeature_ID="112" Class="0" ID="68" LimitDirection="0" Mandatory="0" No="111225" Searchable="0" Type="numerical" Use_Dropdown_Input="N" ValueSorting="0" Updated="1970-01-01 23:00:00">
			<Measure ID="19" Sign="MB" Updated="2008-03-09 17:19:09">
				<Sign>MB</Sign>
				<Signs>
					<Sign ID="15506" langid="1" Updated="2013-12-03 10:19:26">MB</Sign>
					<Sign ID="196" langid="2" Updated="2020-12-24 15:56:40">MB</Sign>
				</Signs>
			</Measure>
			<Name ID="1473" Value="Minimum RAM" langid="1" Updated="2020-12-15 14:27:37"/>
			<Name ID="1047944" Value="Minimale RAM" langid="2" Updated="2013-03-12 14:10:09"/>
			<RestrictedValue/>
		</Feature>
		<Name ID="3727364" Value="Software" langid="1" Updated="2018-02-14 15:44:49"/>
		<Name ID="3768558" Value="Software" langid="2" Updated="2018-02-14 16:29:19"/>
	</Category>
</CategoryFeaturesList>

This chunk provides information about features that are assigned to every single category and are used for describing products in the category.

Sometimes, the possible feature values are restricted to a limited set of values. In that case, we list the possible values for the combination Category-Feature in the container RestrictedValue.

FeaturesList

<FeaturesList>
	<Feature Class="0" DefaultDisplayUnit="0" ID="5" Type="numerical" Updated="2008-09-25 12:25:49">
		<Descriptions>
			<Description ID="577544" langid="0" Updated="2018-10-30 14:47:54">The clock rate is the fundamental rate in cycles per second (measured in hertz) at which a computer performs its most basic operations such as adding two numbers. There are more factors</Description>
			<Description ID="579264" langid="1" Updated="2018-10-30 14:47:54">The clock rate is the fundamental rate in cycles per second (measured in hertz) at which a computer performs its most basic operations such as adding two numbers. There are more factors, like internal memory size, that influence a computer's actual response time.</Description>
		</Descriptions>
		<Measure ID="18" Sign="MHz" Updated="2008-03-09 17:19:09">
			<Signs>
				<Sign ID="53806" langid="71" Updated="2021-07-19 10:43:18">MHz</Sign>
				<Sign ID="53525" langid="72" Updated="2021-07-19 10:43:18">MHz</Sign>
			</Signs>
		</Measure>
		<Names>
			<Name ID="7674521" langid="73" Updated="2014-12-03 10:36:12">Processor frequency</Name>
			<Name ID="7879696" langid="74" Updated="2014-12-03 10:36:12">Frequenza del processore</Name>
		</Names>
		<RestrictedValues ValueSorting="0">
			<RestrictedValue/>
		</RestrictedValues>
	</Feature>
</FeaturesList>

LanguageList

<LanguageList>
	<Language Code="english" ID="1" ShortCode="EN" Sid="2" Updated="2020-12-15 16:51:02">
		<Countries>
			<Country Code="GB" ID="7" System_Of_Measurement="metric" Updated="2020-12-29 13:52:20"/>
			<Country Code="CA" ID="69" System_Of_Measurement="metric" Updated="2020-12-29 13:52:20"/>
		</Countries>
		<Name ID="1" Value="English" langid="1" Updated="2020-12-15 14:27:37"/>
		<Name ID="2" Value="Engels" langid="2" Updated="2021-04-01 10:36:10"/>
	</Language>
</LanguageList>

MeasureList

<MeasuresList>
	<Measure ID="16" Updated="2012-10-25 15:16:08">
		<Descriptions>
			<Description ID="45" langid="1" Updated="2018-10-30 14:47:54">Size in inches. (1 cm = 0.39 inch. 1 inch = 2.54 cm)</Description>
			<Description ID="46" langid="2" Updated="2018-10-30 14:47:54">Grootte in inches</Description>
			<Description ID="2654" langid="3" Updated="2018-10-30 14:47:54">Size in inches</Description>
		</Descriptions>
		<Names>
			<Name ID="1222508" langid="1" Updated="2013-12-03 10:30:26">inch</Name>
			<Name ID="1284" langid="2" Updated="2020-12-15 14:27:37">inch</Name>
			<Name ID="344748" langid="3" Updated="2020-12-15 14:27:37">pouce</Name>
		</Names>
		<Sign>&quot;</Sign>
		<Signs>
			<Sign ID="11" langid="1" Updated="2011-05-04 11:27:54">&quot;</Sign>
			<Sign ID="13408" langid="2" Updated="2013-02-05 09:44:14">&quot;</Sign>
		</Signs>
	</Measure>
</MeasuresList>

RelationsList

<RelationGroup ID="82" name="Dynabook" description="x-sells Dynabook products">
  <Relation ID="806" name="notebooks (Satellite Pro C50-E)">
	<SourceIncludeRules>
		<Rule ID="5289">
			<Supplier ID="30558" />
			<Prod_id value="PA5356E-1PRP" />
		</Rule>
		<Rule ID="5290">
			<Supplier ID="30558" />
			<Prod_id value="PA5217E-1PRP" />
		</Rule>
	</SourceIncludeRules>
	<DestinationIncludeRules>
		<Rule ID="5298">
			<Supplier ID="30558" />
			<Prod_id value="PYS20E-007007EN" />
		</Rule>
		<Rule ID="5299">
			<Supplier ID="30558" />
			<Prod_id value="PYS20E-005005EN" />
		</Rule>
	</DestinationIncludeRules>
  </Relation>
  <Relation ID="807" name="notebooks (Satellite Pro L50-G)">
	<SourceIncludeRules>
		<Rule ID="5289">
			<Supplier ID="30558" />
			<Prod_id value="PA5356E-1PRP" />
		</Rule>
	</SourceIncludeRules>
	<DestinationIncludeRules>
		<Rule ID="5318">
			<Supplier ID="30558" />
			<Prod_id value="PBS12E-04501PIT" />
		</Rule>
	</DestinationIncludeRules>
  </Relation>
</RelationGroup>

Icecat has dynamic relations (x-sells). They are based on the manually defined product sets. One product set relates to another one.

SupplierProductFamiliesListRequest

<SupplierProductFamiliesList>
	<ProductFamily Category_ID="151" ID="2" Updated="2013-09-10 11:02:06">
		<Description ID="2" Value="" langid="2" Updated="2018-10-30 14:47:54"/>
		<Description ID="31" Value="" langid="1" Updated="2018-10-30 14:47:54"/>
		<Name ID="9512" langid="1" Value="TravelMate" Updated="2011-02-09 16:43:15"/>
		<ParentProductFamily ID="1"/>
		<Series ID="3161">
			<Name ID="9753" langid="1" Value="mini" Updated="2014-07-09 13:48:26"/>
		</Series>
		<Supplier ID="7" Name="#Delete"/>
	</ProductFamily>
	<ProductFamily Category_ID="151" ID="4" Updated="2013-09-10 11:02:06">
		<Description ID="2" Value="" langid="2" Updated="2018-10-30 14:47:54"/>
		<Description ID="31" Value="" langid="1" Updated="2018-10-30 14:47:54"/>
		<Name ID="9530" langid="1" Value="Aspire" Updated="2011-02-09 16:43:16"/>
		<ParentProductFamily ID="1"/>
		<Series ID="3161">
			<Name ID="9753" langid="1" Value="mini" Updated="2014-07-09 13:48:26"/>
		</Series>
		<Supplier ID="7" Name="#Delete"/>
	</ProductFamily>
</SupplierProductFamiliesList>

This chunk provides the list of brand product families. Each product family may have information about its Name, Description in different languages, and Сategory.

SupplierList

<SuppliersList>
  <Supplier 
    ID="1"
    Sponsor="1"
    Name="HP"
    LogoOriginalSize="119902"
    LogoOriginal="<http://images.icecat.biz/img/brand/original/1_e8b5a9ede56c45cf9428740dc937d071.png>"
    LogoHighPicSize="113825"
    LogoHighPicWidth="625"
    LogoHighPicHeight="642"
    LogoHighPic="<http://images.icecat.biz/img/brand/high/1_df42767c3ddf465b89464fb59064c6ce.jpg>"
    LogoMediumPicSize="83864"
    LogoMediumPicWidth="487"
    LogoMediumPicHeight="500"
    LogoMediumPic="<http://images.icecat.biz/img/brand/medium/1_0aec37306b8647b2a6043657e5749396.jpg>"
    LogoLowSize="30145"
    LogoLowPicWidth="195"
    LogoLowPicHeight="200"
    LogoLowPic="<http://images.icecat.biz/img/brand/low/1_d0a20d639fc74672915c2b5e13682a06.jpg>"
    LogoPicSize="9425"
    LogoPicWidth="75"
    LogoPicHeight="75"
    LogoPic="<http://images.icecat.biz/img/brand/thumb/1_cf8603f6de7b4c4d8ac4f5f0ef439a05.jpg>"
    Updated="2020-01-28 16:11:59"
    >
  <Names>
    <Name Name="惠普" langid="12" Updated="2020-01-28 16:11:59" />
    ...
  </Names>
  </Supplier>
  ...
</SuppliersList>

From the Supplier list, users can identify if a brand belongs to Full or Open Icecat.

Other Integration Methods

If you are interested in pretty HTML datasheets, we provide Icecat Live.

If you want to have full control over the data, it is also provided in JSON, CSV, and Excel (as PCF).

🔍 Read more:
– Icecat Live
– Manual for JSON Product Requests
– Manual for CSV Interface
– Full Overview of Methods and Manuals
– Add-On page for popular platforms
– Manual Personalized Interface File and Catalog from Icecat

For Brand Owners:
📖 Push-API
📖 Free Vendor Central

Vazha Abramishvili

Chief Operating Officer at Icecat