Version 2.6 (Updated on July 7th, 2026)
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.
The basic setup, Icecat product identifiers and API comparison is described in 🔍 Manual: How to Import Free Product Content Into Your E-commerce System via Icecat API
In order view a full overview of Icecat Data Sheet, please check 🔍 What is a Product Data Sheet and Why is It Important?
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:
There are two types of XML Links endpoints, though the output is the same.
https://data.icecat.biz/export/<AccessLevel>/<Lang>/<Icecat_ID>.xmlhttps://data.icecat.biz/xml_s3/xml_server3.cgi?lang=<Lang>&prod_id=<Product Code>&vendor=<Brand>&output=productxmlEvery 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.
https://data.icecat.biz/export/freexml/EN/74951614.xml
https://data.icecat.biz/export/level4/EN/74951614.xml
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'
| Error code | Error message | Explanation |
|---|---|---|
| 200 | You are not allowed to have Full Icecat access | An Open Icecat user requested a Full Icecat product data-sheet. Please, request a Full Icecat upgrade. |
| 404 | You are not allowed to access a Full Icecat repository with a free Open Icecat account. Please, check the manual or upgrade your account. | The folder at level4 (Full Icecat) is accessed with a free Open Icecat account. For example, the /refs folder. |
| 404 | You are assigned to URL Icecat, please request the file using prf.icecat.biz. | A user with an URL subscription is trying to reach an XML repository. Please, reset your subscription via your Profile. |
| 404 | Invalid group level. | A file is requested by a user with the wrong (not channel partner type) account type. |
| 404 | Please, add this IP address %%ip%% to the \’ Allowed IP addresses\’ setting of your account. | A request is made from a non-whitelisted IP address. Please, add the IP address to your Profile or use Dynamic Tokens. |
| 404 | File does not exist. | An incorrect request for a file is made. |
| 200 | Language does not exist. | A non-existing locale is provided in lang parameter. Please check the Locale Table. |
| 404 For data.icecat.biz/export/ {repo}/{lang}/{code} | 200 for XML_S3 | The requested XML data-sheet is not present in the Icecat database. | A wrong product identifier is used. |
| 404 For data.icecat.biz/export/ {repo}/{lang}/{code} | 200 for XML_S3 | Your registration was not confirmed. | An inactive user is making a request. Please, first activate the user account. |
| 401 For data | 200 for XML S3 | Login or password is invalid. | The wrong password is used. |
| 404 For data.icecat.biz/export/ {repo}/{lang}/{code} | 200 for XML_S3 | You don\’t have access to this language folder. | Your user didn’t subscribe to the requested locale. |
| 200 | The requested XML data-sheet is not described in the Icecat database. | The requested product data-sheet is currently undescribed. |
| 200 | Product was replaced with . | The requested product data-sheet was mapped to another one. |
| 404 | The products datasheet is not public. | User tries to download product with Publish=Limited. To access such product you have to be an authorized reseller of selected Brand. |
| 200 | The products datasheet is not yet released. | The Release Date is in the future. Please wait or request to become an authorized reseller of the selected Brand to gain access to such products. |
| 404 | Access to this product and language is restricted. | A brand restriction policy is applied. Only authorized resellers can access the brand’s content. Please, request brand permission via the website. |
| 404 | This data-sheet is not accessible via Open Icecat repository. | A Full Icecat user is trying to get a Full Icecat product data-sheet from the Open Icecat (Freexml) Repository. |
| 200 | This product belongs to a Vertical, you didn\’t subscribe to. | Your Full Icecat account has not susbcribed to this Vertical or main category. Please, request an upgrade. |
Language (Locale) short identifier. The explanation could be found in the manual 🔍 Language Table
To get the full taxonomy, refer to LanguageList.xml, explained in 🔍 Manual for Reference Files XML
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.
lang=INT). Product Code – described in API Overview, Icecat Identifiers section.
💡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.
Name of the Brand of the requested product – – described in API Overview, Icecat Identifiers section.
GTIN, EAN, or UPC code to identify a product – described in API Overview, Icecat Identifiers section.
Icecat product ID, unique within the Icecat Repository – described in API Overview, Icecat Identifiers section.
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.The number of Related products for the requested product per RelationType. Optional attribute: if not provided, you will see a default number of 500 related products total.
There are several types of supported Relations:
Using the relations_limit parameter, you can control how much relations per type are shown, for example, the limit of 50 will provide 50 Compatibles + 50 Alternatives, etc.
🔍Read more: Related Products in Icecat XML and JSON Data Channels
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:
After receiving ✅ 200, you can send a GET request to check whether the datasheet is available for your account.
server: nginx
date: Fri, 20 Feb 2026 13:19:43 GMT
content-type: application/xml; charset=UTF-8
icecat-repository: realtime
last-modified: Fri, 19 Sep 2025 16:08:51 GMT
strict-transport-security: max-age=15768000 Header Last_Modified is very useful as it represents the time stamp of the last update in the product. This might be used to filter out recently updated products.
The time-stamp is provided for your local timezone. In order to view the unified timestamp, refer to MetaXML request or index files.
Compare the timestamps in the Index file and in the HEAD response.
<file path="/export/level4/EN/93840431.xml" Product_ID="93840431" Updated="20250919180851" 20250919180851 means 2025-09-19; 18:08:51
server: nginx
date: Fri, 20 Feb 2026 14:00:43 GMT
content-type: application/xml; charset=UTF-8
icecat-repository: realtime
last-modified: Fri, 19 Sep 2025 16:08:51 GMT
strict-transport-security: max-age=15768000 Note that there is a two-hour difference between the timestamp in the index files and Headers.
Example of workflow that utilizes HEAD requests to build the Index file for a retailer.
<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"
Currency="EUR"
Price=""/>
</Distributors>
</file>
</files.index>
YYYYMMDDHHMMSShttps://data.icecat.biz/export/<AccessLevel>/<Lang>/<Icecat_ID>.xmlYYYYMMDDHHMMSS0 if there is no main picture.0 if there is no main picture.0 if there is no main picture.Other mapped Product Code for the same product.
Active markets for the product. The product is considered on a country market if it has at leat one distributor in the country.
❗Exists only in MetaXML response.
💡All Distributors are available in DistributorsList.xml
YYYYMMDDHHMMSS<?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/>
<Packages>
</Product>
</ICECAT-interface>
Brand (+ Family + Series) + ProductNameBrand (+ Family + Series) + Selected Features.YYYY-MM-DD. If the international release date is absent, an empty string is used. ReleaseDate is not the same as LastModified header.<CategoryFeatureGroup ID="" No="">
<FeatureGroup ID="">
<Name ID="" langid="" Value=""/>
</FeatureGroup>
</CategoryFeatureGroup>
<Category ID="">
<Name ID="" langid="" Value=""/>
<VirtualCategories>
<VirtualCategory ID="195" UNCATID="43171895">
<Name ID="1131406" langid="1" Value="PCs"/>
</VirtualCategory>
</VirtualCategories>
</Category>
For Category and 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.
<EANCode EAN="" VariantID="" Format="" IsApproved=""/> 'GTIN-14','GTIN-13','GTIN-12','GTIN-8')1 (Yes) or 0(No).GTIN is considered approved if either:
By default, you will only see approved GTINs. In case you wish to access Non-Approved, please contact support.
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>
Includes all features associated with the current FeatureLogo. It ID may be Feature_ID.
💡 FeatureLogoValue is always a single value in FeatureValueLogos
<ReleaseDate>
<Date Value="" langid=""/>
</ReleaseDate> 💡 Each product has only one release date for each locale.
YYYY-MM-DD.<EndOfLifeDate>
<Date Value="" langid=""/>
</EndOfLifeDate>
The same as <ReleaseDate>.
<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.
bytes.RTB or FeatureLogoName of the Feature.
Value of the Feature.
<BulletPoints>
<BulletPoint TaxonomyName="" Value="" langid="" No=""/>
</BulletPoints>
Manually added bullet points.
<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.
<ProductBundled/>
Technical value. Deprecated tag, always empty.
<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>.
<Disclaimers>
<Disclaimer TaxonomyName="" langid="" value=""/>
</Disclaimers>
The footnotes ¹ from the <ProductDescription> will be displayed here.
<ProductFamily ID="" LowPic="" ThumbPic="">
<Name ID="" langid="" Value=""/>
<Series ID="">
<Name ID="" langid="" Value=""/>
</Series>
</ProductFamily>
The Name tag is a translation of ProductFamily for a certain locale.
If ProductFamily has Series, the corresponding tag is added. <Series> serves as a container for translations, and its only attribute is ID.
The same as ProductFamily, translations for the Series name for different locales.
<ProductFeature
Localized=""
ID=""
Local_ID=""
Value=""
CategoryFeature_ID=""
CategoryFeatureGroup_ID=""
No=""
Presentation_Value=""
Translated=""
Mandatory=""
Searchable=""
Optional=""
>
<PresentationValues>
<PresentationValue langid="1" Value="Standard"/>
</PresentationValues>
<LocalValues>
<LocalValue Value="">
<Measure ID="">
<Signs>
<Sign ID="" langid="">"</Sign>
</Signs>
</Measure>
</LocalValue>
</LocalValues>
<Feature ID="">
<Measure ID="" Sign="">
<Signs>
<Sign ID="" langid="">"</Sign>
</Signs>
</Measure>
<Name ID="" langid="" Value=""/>
</Feature>
</ProductFeature>
FALSE), otherwise, it is 1 (TRUE).💡Use the Presentation_Value parameter in localized data-sheets for display of a data-sheet, and use the Value parameter for search and compare.
🌐 Exists only in International XML and only inside <PresentationValues> tag.
Fancy-looking values to show for UX purposes for all locales you are assigned to.
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 comparison functionalities.
⚠️ International XML will have a special tag <LocalValues> which will have all Local values.
You can check the Measures using the MeasuresList export file.
Visual representation of a measure (″ for inches).
Contains only FeatureID. Can be matched with the FeaturesList export file. Measure and Signs are the same.
Represents a feature name. ID, Value, and LangID. An example of a value is Display resolution .
<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 into the following resolutions:
| Name | Height / Width | Formats |
|---|---|---|
| Original | original | image/jpeg, image/png, image/tiff, image/bmp, image/x-windows-bmp, image/x-ms-bmp, image/webp |
| LowPic | 200px/200px | .jpg |
| Pic500x500 | 500px/500px | .jpg |
| Pic | original | .jpg |
| Thumb | 75px/75px | .jpg |
💡For users convenience, pictures from FeatureLogos are duplicated in <ProductGallery>.
🔍Read More: How to Make the Product Gallery Great Again
YYYY-MM-DD. If the image has no expiration date, the attribute is not present.200px.200px.image/jpeg, image/png, image/tiff, image/bmp, image/x-windows-bmp, image/x-ms-bmp, image/webp..jpg.500x500 picture.500px.500x500 picture size in bytes.500px..jpg.75x75px).YYYY-MM-DD hh:mm:ss.Icecat provides a variety of multimedia objects. Please note that depending on the Multimedia type, the attributes can be different!
The types are explained here: 🔍 Multimedia Assets and Documents Overview
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>
YYYY-MM-DD hh:mm:ss.YYYY-MM-DD. If attribute is not present, the MMO never expires.0.0, MMO object is stored on object.icezat.biz.0.0.0.KeepAsURL=1, the size is always 0.EU Product Fiche, Repairability index overview, Leaflet, Manual PDF, Other PDF, Safety Data Sheet, Size Chart, ProductStory, ProductStory2.0, Generated PDF.0.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>
KeepAsURL=1 do not appear.video/mp4.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>
EU Energy Label / UK Energy Labelrescaled or non-rescaled ..jpg and .pdf . If the original URL has .pdf document, the ConvertedURL will contain the link to .jpg and vice versa.bytes..PDF or .JPG<ProductMultimediaObject>
<MultimediaObject
ContentType=""
Date=""
Description=""
ExpirationDate=""
Height=""
IsRich=""
KeepAsURL=""
MultimediaObject_ID=""
Type="360"
UUID=""
Width=""
langid="">
<ImagesList360>
<Image Link="" No=""/>
</ImagesList360>
</MultimediaObject>
</ProductMultimediaObject>
px.0.360.px.<ImageList360> contains a set of images clockwise that show the product from every angle.
Related products, which might be Recommended and Alternative. 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.
Recommended product – is a product recommended for your current product. For instance, a Keyboard is recommended for a PC. Always has a different category from the main product.
Alternative product – is a product within the same category as the main product. So, one laptop is an alternative to another laptop.
<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>
<RelationType Code=""/>
</ProductRelated>
0, the relation is added automatically.Defines the nature of the relationship. The reseller can clearly distinguish whether a product is an accessory, an alternative, or serves another purpose.
<SEOs>
<SEO TaxonomyName="" Description="" Keywords="" Title="" langid=""/>
</SEOs>
<SummaryDescription>
<ShortSummaryDescription langid="">SOME_VALUE</ShortSummaryDescription>
<LongSummaryDescription langid="">SOME_VALUE</LongSummaryDescription>
</SummaryDescription>
This tag provides a SummaryDescription for the requested language.
<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 ID="" Name="">
<Names>
<Name ID="" langid="" Value=""/>
</Names>
</Supplier>
<Names> tag contains translations of a brand name to other languages. For instance, Japanese XML might have the Brand’s name written in Katakana.
<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>
<CatalogObjectCloud>
<ProductPage QRCodeURL="" URL=""/>
</CatalogObjectCloud>
Contains a QR code and a link to https://coc.icecat.biz, permalink to product information.
https://coc.icecat.biz represented as a QR codehttps://coc.icecat.biz represented as a link<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.
The same as <ProductPicture> in <Product Gallery>
The same as <ProductMultimediaObject>
<Reviews>
<Review ID="" langid="" Score="" Published="" Author="">
<URL IsActive="1">SOME_VALUE</URL>
<Comment>SOME_VALUE</Comment>
<Good>SOME_VALUE</Good>
<Bad>SOME_VALUE</Bad>
<Bottomline>SOME_VALUE</Bottomline>
</Review>
</Reviews>
🔍 Read more: Reviews Manual.
YYYY-MM-DDLink to the website where the review is published. For instance, https://monitornerds.com/.
IsActive=0 (false). For available links, IsActive=1 (true).Comment to the product. If long, not published fully. Please check the original review.
The positive sides of the product mentioned in the review. If long, not published fully.
The negative sides of the product mentioned in the review. If long, not published fully.
Summary of the review. If long, not published fully.
<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.
<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.
The same as the Title attribute from <Product>
The same as the GeneratedLocalTitle attribute from <Product>
The same as BrandLocalTitle attribute from <Product>
<Packages>
<Package>
<Product ID="12345678" Prod_id="123456#MPN" Name="I am model description">
<Category ID="9563"/>
<Supplier ID="1"/>
<GTINs>
<GTIN Type="GTIN12" Value="123456789012" Approved="1"/>
<GTIN Type="GTIN13" Value="0123456789012" Approved="1"/>
</GTINs>
<Names>
<Name langid="1" Value="I am model description"/>
</Names>
</Product>
<PackageLocales>
<PackageLocale ID="0" langid="0"/>
</PackageLocales>
</Package>
</Packages> The Package uses the same tags and attributes as ProductRelated.
The tag <Product> is Identical to the same tag in the ProductRelated section.
Inside the <PackageLocale>, you can see the Locales for which the packaging is available.
For 🌐 International requests, you will see all locales for which the package is available.
For local requests, you will see only 🌐 International and requested values. For example, for French, you will see International and French values.
0.Files with Icecat taxonomy. Please check the 🔍 Manual for Reference Files XML
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 from your server scripts from gzip, you must use in any HTTP request this additional parameter:
Accept-Encoding: gzip
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.
The Experience Assistant is an AI assistant built directly into Icecat PIM, designed to answer…
As retailers invest more heavily in AI, many are looking beyond individual tools toward connected…
AI chatbots are becoming a familiar part of online shopping. They answer customer questions, recommend…
For years, retailers have invested heavily in customer service chatbots. The goal was simple: answer…
Release 254 introduces a collection of enhancements designed to make integrating with and managing data…
AI shopping agents are beginning to move beyond product recommendations and controlled demonstrations. Visa has…
View Comments
None of the above dtd links returns a full dtd file.
Do I assume are unique to each product?
Can you explain how is related to products.
Thanks
Dear Alan
We have different DTD links for different export file types. They are mentioned in the manual.
For the product data sheets we have thus only one DTD: https://data.icecat.biz/dtd/ICECAT-interface_response.dtd. It is valid for all products in the Icecat database.
Please, let us know if you have further questions.
Is there any way of getting an index file per vertical, i.e. 2833 for Computers and Peripherals on it's own, rather than the complete list?
Thanks
Yes, the most efficient and tailored way is to generate a personalized index based on your own catalog/price list
https://iceclog.com/manuals-personalized-interface-files-and-catalogs/
Is there a notification process for any changes in the categories, if they ever change?
Thanks
Yes, read https://iceclog.com/icecat-release-notes-111/
We're busy with rolling out timestamps in Reference files (per Taxonomy item).
Hi there, I would to ask for a Sony STR-DN610 SERVICE MANUAL, your help will be much appreciated thank you.
Thx. Will ask SONY to provide it.
Thanks for this.
I'm still struggling to see how I would provide a category id and in what format to get the relevant products.
Can you please provide and example for me?
Thanks
Martin...
I ask a colleague to contact you directly
How can we have the name and id of all the categories for a given vertical? Where are verticals in the .xml files that you provided here? Thank you
Dear Max
We store detailed information per category in the CategoriesList.xml.gz that you can find via the following link: https://data.Icecat.biz/export/freexml/refs/
By tag "ParentCategory ID" You can identify the hierarchical connection between categories.
Hi, is there a limit to how many queries I can make to the server at any one time? I'm getting a "GO AWAY" from the server when my program is downloading XML data sheets now.
Thanks
Martin...
Dear Martin
For XML the limit is 100 connections from one IP, however, I suggest sticking to the number of 50-75.
Kind regards
Vazha Abramishvili
Hi,
can I filter products only on BRAND ?
Thanks
Milan
Hi Milan,
Thanks, our country manager will contact you.
Regards,
Wouter
Hi icecat,
How to get data in multiple languages in a single call?
Thanks & Regards,
Nikita
Hi Dev, thanks for reaching out. Your country manager Gio Abramishvilli will contact you asap. Or in the meantime you can send a request to gio at icecat dot com. Thanks, Wouter
How can I filter CategoriesList by an specific Language like English?
Hi apiazyro, the category list is multilingual. You can filter on "langid=XX". Regards, Wouter