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.
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:
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.
Example of feed:
🔍 Read more:📖 Coverage Analysis of Your Catalog📖 Manual Personalized Interface File and Catalog from Icecat
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.
https://data.icecat.biz/export/freexml/EN/files.index.xml.gz
https://data.icecat.biz/export/freexml/EN/files.index.csv.gz
https://data.icecat.biz/export/level4/EN/files.index.xml.gz
https://data.icecat.biz/export/level4/EN/files.index.csv.gz
💡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.
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.
There are two types of XML Links endpoints, though the output is the same.
https://data.icecat.biz/export/<AccessLevel>/<Lang>/<Icecat_ID>.xml
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.
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.
16.0.0.5
152.168.1.0/24
152.168.1.1-152.168.1.100
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.
<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=EN&prod_id=75252&vendor=LEGO&output=productxml>
<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=EN&ean_upc=5702016371116&output=productxml>
<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=EN&icecat_id=74951614&output=productxml>
<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=NL&icecat_id=35443992&output=productxml&relations_limit=400>
<https://data.icecat.biz/xml_s3/xml_server3.cgi?lang=EN&prod_id=75252&vendor=LEGO&output=metaxml>
<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>'
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.
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.
💡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. 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:
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 product ID, unique within Icecat Repository, and product can only have one ID. Useful for testing.
productxml
metaxml
ping
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 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.
💡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.
<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>
YYYYMMDDHHMMSS
0
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
<?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>
<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
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.
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. Reason to Buy, created from FeatureLogo. In this case, Certificate.
bytes
RTB
FeatureLogo
Name 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 Series name for different locales.
<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>
💡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 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
You can check the Measures using the MeasuresList export file.
Visual representation of a measure (″ for inches).
Contains only FeatureID. Can be matched with 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 .
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 the following resolutions:
image/jpeg
image/png
image/tiff
image/bmp
image/x-windows-bmp
image/x-ms-bmp
image/webp
.jpg
💡For users convenience, pictures from FeatureLogos are duplicated in <ProductGallery>.
🔍Read More: How to Make the Product Gallery Great Again
200px
500x500
500px
75x75px
YYYY-MM-DD hh:mm:ss
Icecat provides a variety of multimedia objects. Please note that depending on the MMO type, the attributes can be different!
.pdf
.jpeg
.mp4
.html
.zip
.txt
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>
object.icezat.biz
KeepAsURL=1
EU Product Fiche
Repairability index overview
Leaflet
Manual PDF
Other PDF
Safety Data Sheet
Size Chart
ProductStory
ProductStory2.0
Generated PDF
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>
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 Label
rescaled
non-rescaled
.PDF
.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
360
<ImageList360> contains a set of images clockwise that show the product from every angle.
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>
<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 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
<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>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.
Link to the website where the review is published. For instance, https://monitornerds.com/.
Comment to the product. If long, not published fully. Please check the original review.
Positive sides of the product mentioned in the review. If long, not published fully.
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>
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>
📖 Which JSON and XML Error Messages can I get using Icecat?
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> <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 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> <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> <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>
<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>"</Sign> <Signs> <Sign ID="11" langid="1" Updated="2011-05-04 11:27:54">"</Sign> <Sign ID="13408" langid="2" Updated="2013-02-05 09:44:14">"</Sign> </Signs> </Measure> </MeasuresList>
<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.
<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.
<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.
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
Read further: Manuals, oci, PDS, PIM, XML
Chief Operating Officer at Icecat
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?
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?
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.
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
Hello,
Is it possible to filter products based solely on the brand?
Thanks, Milan
Hello Milan, thanks for your questions. You can filter on requesting a product XML by Brand and Product Code or by GTIN (EAN or UPC). See paragraph 2.2 in the manual. Regards, Wouter
Hello, is there a restriction on the number of queries I can send to the server simultaneously? I’m currently receiving a “GO AWAY” response from the server while my program is downloading XML data sheets.
Thank you.
Hello, the max number of queries is 100 connections per second per IP. Regards, Wouter
it would be really great if there was a middle ground image to download between the original and 500 x 500. Some of the images from some manufacturers are 8k resolution or higher, which can take quite a while to download on slower connections. 500 x 500 is pretty small in contrast. Any possibility of getting something in between like 1920 x 1080 into the spec?
Has the Compac Presario model SG2-110NL (XH613EA#ABH) blue tooth capability for file and image transfer to other blue tooth devices
Asked to the editor team via icecat.biz
Great insights on the Open Catalog Interface (OCI) and Icecat’s XML repositories! OCI’s streamlined product data integration is a game-changer for eCommerce, offering both flexibility and consistency. Accurate product data, like what barnshenn UK uses for its wooden toys, greatly enhances the customer experience and SEO. Thanks for sharing—looking forward to more posts!
Thanks for sharing this great article. Regards: https://minecraftapkdl.com
Great info here! Can I ask about the Model_Name value in the index file? I’ve been reading the pdf manual, where there are UML diagrams and MySQL column definitions (also very useful!), but one thing it doesn’t describe is the Index file.
Does `Model_Name` show the same value as `name`, on the `product` table? I’m mostly interested in the maximum length and type definition, where `name` is defined as `VARCHAR(255)`. Does `Model_Name` have the same type constraint as `product.name`?
Dear Alex
Yes, `Model_Name` shows the same value as `name` There is no restriction in the number of symbols for `Model_Name`
Your email address will not be published. Required fields are marked *
Comment *
Name *
Email *
Website
Δ