Manual for Reference Files XML

Version 1.0 (Updated on August 14th, 2025)

Icecat uses a collection of Reference files to structure and organize product content, separating it into logical entities like categories and feature groups. This document provides a detailed overview of these files, which are available for both Open Icecat and Full Icecat users.

These files are foundational to how product data is organized and include important information on entities such as categories, features, suppliers, and languages. The guide also explains how to download these gzipped files efficiently and clarifies the connections between different files, such as how categories are linked to their specific features in CategoryFeaturesList.xml.

Advice on Downloading

Almost all files are present in gzipped format. To benefit from your server scripts from gzip, you must use this additional parameter in any HTTP request:

Accept-Encoding: gzip

To retrieve the Reference files, 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.

List

Open Icecat	Full Icecat
CategoriesList.xml	CategoriesList.xml
CategoryFeatureIntervalsList.xml	CategoryFeatureIntervalsList.xml
CategoryFeaturesList.xml	CategoryFeaturesList.xml
DistributorList.xml	DistributorList.xml
FeatureGroupsList.xml	FeatureGroupsList.xml
FeatureLogosList.xml	FeatureLogosList.xml
FeatureValuesVocabularyList.xml	FeatureValuesVocabularyList.xml
FeaturesList.xml	FeaturesList.xml
LanguageList.xml	LanguageList.xml
MeasuresList.xml	MeasuresList.xml
RelationsList.xml	RelationsList.xml
SupplierProductFamiliesListRequest.xml	SupplierProductFamiliesListRequest.xml
SuppliersList.xml	SuppliersList.xml
BrandOrganizations.xml	BrandOrganizations.xml

Common attributes

ID — a unique Icecat ID for an entity. For instance, <Feature ID=1> indicates the Feature that can be located by ID 1.
Updated — the last update timestamp of the entity in format YYYYMMDDHHMMSS
langid — Locale numerical ID from Table.

Picture sizes

Name	Height / Width
Original	original
LowPic	200px/200px
Pic500x500	500px/500px
Pic	original
Thumb	75px/75px

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>

The file contains the information for the product Categories on Icecat. The categories themselves have subcategories, which have subcategories, etc.

For instance, here is the full path of categories for the 3D printers. Note that products are assigned to bottom-level categories only, in this case, 3D Printers.

Computers & Peripherals → Printers & Scanners → Printing Equipment → 3D Printers

Top-level categories are named Verticals. Here is the list:

Telecom & Navigation
Office
AV & Photo
Food, Beverages & Tobacco
Health, Beauty & Personal Care
Domestic Appliances
Fashion & Lifestyle
Sports & Recreation
Vehicles
Baby & Children
Pet Care
Toys
Lighting
Home
Computers & Peripherals
Industrial & Lab Equipment
Entertainment & Hobby
Online Data Services
Building & Construction
Drugs & Pharmaceutics
Hospitality
Medical Equipment
Defense, Police & Safety
Packaging

💡CategoriesList does not include features for each category. This information is provided in CategoryFeaturesList.

<Category>

UNCATID — United Nations Standard Products and Services Code (UNSPSC)
Score — reflects the category usage statistic. The higher the number, the higher the usage level.
Searchable — whether you can search for the feature on icecat.biz and on Icecat Cloud.
LowPic — link to the 200×200 category main picture.
ThumbPic — link to the 75x75px category main picture
Visible — Deprecated attribute.
Updated — the last update time of the category in format YYYYMMDDHHMMSS. Note that descendant tag update, for instance, Description does NOT update the whole category.

<Description>

Description contains a short paragraph with clarification text about the category. Translation Language is provided in a separate <Description> tag.

Value — text of the description, a brief explanation of what the Category represents in the given language

<Keywords>

Keywords that may be used in SEO and are provided for every language. If the value for language is not present, the empty tag is added.

The attributes are the same as in <Description>.

<Name>

Category title name for a given language.

The attributes are the same as in <Description>.

<ParentCategory>

Inside, you will find the ID and the Names of the category that is one level above the current category. The <Names> tag inside follows the same structure as the <Name> tag above.

External Connections

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>

Represents the Features, technical characteristics of the products.

<Feature>

Class — represents feature optionality. If class equals 0, the feature is mandatory; if 1, optional.
DefaultDisplayUnit — Boolean value, if equals 1, the default measure is used throughout all countries, if 0, it may be transformed. For example, the screen resolution is measured in inches, even in countries with the Metric system. Therefore, if DefaultDisplayUnit=1 the inches will stay as a measure for all markets.
Type — see below.

Feature Types

numerical – represents any real number
y_n – Boolean, yes/no
text – represents one line of text
2d – represents two numerical values that relate to each other. For example, the width and length of a 2D object in the format # x #
contrast ratio – represents the relation between two numbers in a format # : #
range – represents two real numbers, in format # - #
multi_dropdown – dropdown, where many RestrictedValues could be selected.
dropdown – dropdown, where only one RestrictedValue could be selected
3d – represents three numerical values that relate to each other. For example, the width, length, and height of a 3D object in a format # x # x #.
textarea – represents multi-line text.
alphanumeric – represents a string that can include both letters and numbers. Used for International values only.
ratio – represents the relation between two numbers in a format ratio1/ratio2

<Description>

Inside this tag is the explanation of the feature.

<Measure>

Units which are used to measure the feature, for instance, Processor Frequency is measured in MHz (megahertz).

<Sign>

A sign is a common symbol for a measure, adapted for a current locale. For instance, cm will be replaced with Cyrillic letters for the Bulgarian locale.

<Name>

Name of the feature for a given language.

<RestrictedValues>

Dropdown and Multidropdown features have a limited set of values that are applied to them. These values are shown inside this tag as RestrictedValues.

ValueSorting — deprecated attribute.

External Connections

FeatureGroupsList

<FeatureGroupsList>
  <FeatureGroup ID="0" sid="2537" Updated="2018-05-02 13:49:47">
   <Name ID="5073" Value="Technical details" langid="1" Updated="2020-12-15 14:27:37"/>
   <Name ID="478422" Value="Technische details" langid="2" Updated="2020-12-15 14:27:37"/>
  </FeatureGroup>
  <FeatureGroup ID="1" sid="2430" Updated="2018-05-02 13:49:47">
   <Name ID="1222500" Value="Processor" langid="1" Updated="2013-12-03 10:08:31"/>
   <Name ID="478395" Value="Processor" langid="2" Updated="2020-12-15 14:27:37"/>
  </FeatureGroup>
</FeatureGroupsList>

For users’ convenience, the features are separated into groups for responsiveness reasons. For instance, Input voltage and AC input frequency specs are often shown in the Power Feature Group.

<FeatureGroup>

sid — deprecated value.

<Name>

Value — The translation of the FeatureGroup for a given language.

External Connections

FeatureValuesVocabularyList

<FeatureValuesVocabularyList>
  <FeatureValuesVocabulary Group_ID="0" Key_Value="(2-in-1) Carpet cleaner &amp; deodorizer" Updated="2021-06-17 15:54:14">
   <FeatureValue ID="752671" langid="2" Updated="2018-09-20 12:13:25">
      (2-in-1) Tapijtreiniger en geurverfrisser
   </FeatureValue>
   <FeatureValue ID="730933" langid="3" Updated="2018-09-20 12:13:25">
     Nettoyant pour tapis et désodorisant (2 en 1)
   </FeatureValue>
  </FeatureValuesVocabulary>
  <FeatureValuesVocabulary Group_ID="0" Key_Value="(2-in-1) Paint &amp; primer" Updated="2021-06-14 17:32:24">
  <FeatureValue ID="607483" langid="2" Updated="2016-10-28 11:51:43">
   (2-in-1) Verf &amp; lak
  </FeatureValue>
  <FeatureValue ID="612063" langid="3" Updated="2016-10-31 13:20:21">
   Peinture et apprêt (2-en-1)
  </FeatureValue>
  </FeatureValuesVocabulary>
</FeatureValuesVocabularyList>

The reference file provides the translations for RestrictedValues for dropdown and multidropdown type Features.

<FeatureValuesVocabulary>

Group_ID – deprecated value.
Key_Value – the English text serves as a key for all translations locatedside in <FeatureValue>

<FeatureValue>

Inside the tag, the translation for a given language is provided.

External Connections

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>

This reference file is used for Measures for numerical features. For example, if the feature describes product width, the possible measures will be centimeters for the metric system or inches for the imperial system.

<Description>

Explanation for a Measure.

<Name>

The name for a Measure in a given language.

<Sign>

The character that is used to describe the Measure. For example, cm for centimeters.

💡Signs are HTML-encoded. As in the example above, the Sign for ‘ (inch) is encoded as "

External Connections

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>
  ...
  
     <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 massive file contains information on connections between Features and Categories.

For each Category, there is a certain number of FeatureGroups, Features, and RestrictedValues used to make the information more convenient. For instance, Laptops have entirely different specifications from Office Furniture.

The Feature that is inside the Category is called CategoryFeature in this file. Any time you see the CategoryFeature, think of it as about Feature, but adapted to the needs of the Category.

💡This file cannot be opened in the browser or any standard text editor due to its size (>10GB). You have to use scripts or special software and stream its content to work with it.

<Category>

The structure mimics the <Category> from CategoriesList.xml. The <Names> tag has the same structure.

<CategoryFeatureGroup>

As with the CategoryFeature, the CategoryFeatureGroup is a FeatureGroup that exists inside the Category.

No — the priority of the FeatureGroup. Use this attribute to sort FeatureGroups in the most optimized way.

<FeatureGroup>

Actual FeatureGroup data. The tag mimics the structure of the same tag in the FeatureGroups.xml.

<Feature>

The tag includes information about the CategoryFeature. It’s an adapted Feature to be used within a Category and has additional data compared to <Feature> in FeaturesList.xml.

Inside Feature, you can find <Measures>, <Names>, and <RestrictedValue> tags. <Measure> structure duplicates the same tag from MeasuresList.xml. <Names> and <RestrictedValue> tags are the same as in the FeatureList.xml, though CategoryFeature might have different Names or RestrictedValues depending on the Category.

CategoryFeatureGroup_ID — the ID from the <CategoryFeatureGroup>, use it to place the feature in the correct FeatureGroup.
CategoryFeature_ID — Unique ID of the Feature within a Category. The same Feature in two categories will have different CategoryFeature_ID.
Class — the same as Class in FeaturesList. The same Feature might have different classes in different Categories.
ID — Feature ID from the FeaturesList.xml.
LimitDirection — Deprecated attribute.
Mandatory — Whether the feature must be fulfilled within the category.
No — Priority of the feature, the lower the No, the higher the priority of the feature.
Searchable — Indicates whether the feature is good for searching and filtering. You can use Searchable features to make filters by feature on your webshop!
Type — the same as Type in FeaturesList.xml.
Use_Dropdown_Input — some non-dropdown features may be converted to a dropdown. For instance, it is hard to keep all possible screen sizes for all possible devices, but for a Smart Watch, there are only a few possible screen sizes; therefore non-dropdown feature is transformed into a dropdown.
ValueSorting — deprecated attribute.

External Connections

CategoryFeatureIntervals

<CategoryFeatureIntervals 
  category_feature_id='5' 
  valid='4624' 
  invalid='748' 
  ratio='0.860759493670886' 
  updated='2024-08-13 02:03:43'>
   <Interval amount='43' order='1'>
     <Min>0</Min>
     <Max>2</Max>
   </Interval>
</CategoryFeatureIntervals>
<CategoryFeatureIntervals category_feature_id='' valid='' invalid='' ratio='' updated=''>
 ...
</CategoryFeatureIntervals>

The reference file contains Intervals for numerical Features – minimum and maximum values fora certain Feature.

category_feature_id — the ID of the CategoryFeature, can be used to map with CategoryFeature_ID from <Feature> in CategoryFeaturesList.xml.
valid — the number of valid feature values.
invalid — the amount of invalid feature values. Invalid values might have resulted from an automatic import or outdated records.
ratio — percentage of valid feature values of all.

<Interval>

Inside <Min> and <Max> tags, you can find the corresponding minimum and maximum value for a certain Feature. For instance, if we talk about percent, the Min is 0 and the Max is 100.

amount — amount of values within the current interval.
order — ordinal number of the Interval in the Reference file.

External Connections

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>

<Language>

Code — full name of the language
ShortCode — Language code from Table
Sid – deprecated value.

<Country>

Countries where the given language is common.

Code — Short code for the Country
System_Of_Measurement — either metric or imperial.

<Name>

Translations for each name into different languages.

Value — full name of the language.

External Connections

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>

<Supplier>

Sponsor — boolean value, indicates whether the brand is Open (1) or Full (0)
Name — English name for a Brand
LogoOriginalSize — the size of the Brand Logo in bytes.
LogoOriginal — link to the Brand Logo in original size.
LogoHighPicSize — the size of the original Brand Logo in .jpeg in bytes.
LogoHighPicWidth — width of the original Brand Logo in .jpeg in pixels
LogoHighPicHeight — height of the original Brand Logo in .jpeg in pixels
LogoHighPic — link to the Brand Logo in .jpeg in original size.
LogoMediumPicSize — the size of the 500×500 Brand logo in bytes.
LogoMediumPicWidth — width of the 500×500 Brand logo in pixels.
LogoMediumPicHeight — height of the 500×500 Brand logo in pixels.
LogoMediumPic — link to the 500×500 Brand logo.
LogoLowSize — the size of the 200×200 Brand Logo in bytes.
LogoLowPicWidth — width of the 200×200 Brand Logo in bytes.
LogoLowPicHeight — height of the 200×200 Brand Logo in bytes.
LogoLowPic — link to the 200×200 Brand Logo in pixels.
LogoPicSize — the size of the 75×75 Brand Logo in bytes.
LogoPicWidth — width of the 75×75 Brand Logo in pixels.
LogoPicHeight — height of the 75×75 Brand Logo in pixels.
LogoPic — link to the 75×75 Brand Logo.

<Name>

Name – the translation of the feature name for a given locale.

External Connections

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>

The reference file includes information on the Brand Product Families. For instance, Acer has the TravelMate series of its products.

<ProductFamily>

Category_ID — the bottom-level category to which the product family belongs.

<Description>

A short commercial description for the given language.

<Name>

English Product Family name, for example, (Acer) TravelMate, (Apple) iPod, etc.

<ParentProductFamily>

Indicates if the Product has a parent product family.

ID — Points to the ProductFamily ID of the parent product family if it exists. If ID = 1 it is a top-level ProductFamily.

<Series>

Inside this tag, you will find the name of the series, for example, (Acer TravelMate) TimelineX; (Apple iPod) Touch.

<Name>

The English name for the Product Family Series.

<Supplier>

ID — the ID from SupplierList.xml
Name — English name for the Brand

External Connections

DistributorList

<DistributorList>
  <Distributor 
    Code="IM" 
    ID="2" 
    Name="Ingram Micro - Netherlands (Iceimport)" 
    Updated="2025-03-22 09:10:09"
   />
 ...
</DistributorList>

Icecat Distributors are partners who synchronize their catalogs with Icecat; therefore, we can be sure that a certain product is distributed within a certain country.

<Distributor>

Code – short code of the Distributor name.

💡This file does not have external connections.

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="7" />
  <Category ID="222" />
  <Start_date value="2018-01-01" />
      </Rule>
      <Rule ID="5299">
  <Supplier ID="30558" />
  <Prod_id value="PYS20E-005005EN" />
  <SupplierFamily ID="66819" />
      </Rule>
    </DestinationIncludeRules>
   
   </Relation>
  
 <Relation ID="807" name="notebooks (Satellite Pro L50-G)">
   ...
 </Relation>
</RelationGroup>

RelationList contains the information about cross-sell and up-sell products. The Relation is a set of rules, where the Source products are matched to the Destination products. The Rules are separated into RelationGroups for convenience.

<RelationGroup>

description — short description of the RelationGroup’s purpose.

<SourceIncludeRules>

Information about the Source products. For these products, the Destination products will be shown as recommended.

<DestinationIncludeRules>

Information about the Destination products. Actual recommended products for the Source.

<Supplier>

The brand of a certain product. Its ID matches the <Supplier> ID attribute from SuppliersList.xml

<Prod_id>

The product code, its Value matches the <Product> Prod_id attribute from *.index.xml files.

<Category>

The bottom-level category of the product, ID matches the <Category> ID from the CategoriesList.xml.

<Start_date>

The timestamp of the Date when the product becomes recommended (usually, the release date).

<SupplierFamily>

If the product belongs to a certain brand family, the ID of it appears in this tag and matches the <ProductFamily> ID from SupplierProductFamiliesListRequest.xml.

External Connections

FeatureLogosList

<FeaturesList>
  <FeatureLogo 
    Feature_ID="2183" 
    Height="200" 
    ID="1" 
    LogoPic="<http://images.icecat.biz/img/feature_logo/1-3750.png>" 
    Size="27992" 
    Width="200" 
    SupplierId="0">
    
     <Descriptions>
       <Description ID="1" langid="1">text</Description>
       <Description ID="72" langid="25">текст</Description>
     </Descriptions>
  
     <FeatureLogoCategories>
 <FeatureLogoCategory catid="1170"/>
 </FeatureLogoCategories>
     <FeatureLogoCategories>
 <FeatureLogoCategory catid="1170"/>
 </FeatureLogoCategories>
  
     <FeatureLogoFeatures>
 <FeatureLogoFeature ID="184" Feature_ID="111">
   <FeatureLogoValues>
     <FeatureLogoValue ID="1">Y</FeatureLogoValue>
   </FeatureLogoValues>
        </FeatureLogoFeature>
     </FeatureLogoFeatures>
   </FeatureLogo>
 ...
</FeaturesList>

The reference file contains a special type of Features in Icecat, represented by textual descriptions and images. Think of a patent or a certificate, where an image is required for validation.

<FeatureLogo>

Feature_ID — the main Feature from FeaturesList assigned to the FeatureLogo. Note that one logo could be assigned to many Features.
Height — width of the Log in pixels.
LogoPic — link to the log, with FeatureLogoID as its key. For example, the http://images.icecat.biz/img/feature_logo/1-3750.png is for FeatureLogo with ID=1.
Size — size of the Feature Logo image in bytes.
Width — width of the Log in pixels.
SupplierId — Brand ID from the SuppliersList Reference file.

<Descriptions>

A brief explanation for the FeatureLogo.

<FeatureLogoCategories>

Every category for which the FeatureLogo is applicable.

<FeatureLogoFeatures>

The entire list of Features that use this FeatureLogo.

Feature_ID corresponds to the Feature ID from FeaturesList.

<FeatureLogoValues>

It’s important to note that FeatureLogos are not physical images, but rather a script that generates an image depending on the feature value. Therefore, this tag describes the possible values for the feature for which the Logo is applicable.

External Connections

BrandOrganizations

<BrandOrganizations>
    <Brand ID="1" Updated="2025-01-01 00:00:00">
        <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="123456789">
                <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>
                <Scopes>
                    <Categories>
                        <Category ID="101"/>
                        <Category ID="102"/>
                    </Categories>
                </Scopes>
            </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>
                <Scopes>
                    <Categories>
                        <Category ID="201"/>
                    </Categories>
                </Scopes>
            </Representative>
        </Representatives>
    </Brand>
</BrandOrganizations>

Contains brand and organization relations as well as contact details and physical address.

<Brand>

Represents a brand and its associated organizations.

ID — Brand identifier (found in REFs file SuppliersList.xml.gz).
Updated — Timestamp in *YYYY-MM-DD HH:MM:SS* format indicating the last update.

<Organization>

ID — Unique UUID identifier of the organization.
Name — Organization’s official name.
CountryCode — Alpha-2 country code.
State — Applicable only for certain countries (e.g., US).
City, Street, HouseNumber, ZIP — Physical address details.
URLs — Collection of organization websites.
Emails — Collection of contact emails (optional).

Scopes (for <Licensees> & <Representatives>):

Categories — Defines the scope of product categories for an organization.
Category ID — Corresponds to a product category from REFs file CategoriesList.xml.gz.