Manual: Icecat Product XMLs batch processing
June 6, 2017
This document describes how to download a batch of products from Icecat in XML format.
Icecat provides customers with the ability to download XML product data. Other available interfaces are:
- Quick Guide for real-time data (xml, csv)
- Icecat URL Interface
- Manual for Icecat CSV Interface
- Manual: downloading individual Product XMLs
Access to Icecat
To obtain access to Open Icecat, you will need a login/password, provided to you by Icecat. If you don’t have these, please register online for Open Icecat. Open Icecat is free and contains millions of products.
NOTE: During the registration you need to choose for the URL or Data (XML) version. If you want to make use of XML, make sure that you choose the Open Icecat Data subscription. You can always change this afterwards, or create a second subscription for the URL (links to hosted data-sheets) method.
For Full Icecat, you need a separate contract. You can request this contract via the contact page.
Access to the product information of Full Icecat is protected. If you want to access the product information we need to unblock your IP address. Fill in the IP-address(es) of your server(s) and office in the “Allowed IP addresses” field. If you don’t know your office IP addresses, visit What is my IP to find your (office) IP. For you server IP address, please ask your system operator or provider.
You can fill in several IP addresses, separated by a space.
Popular web shop software Add-ons
If you are looking for to connect your web shop look at several of the most popular Icecat Add-ons.
Downloading product XMLs in a batch
Batch processing is handy when you want to download the product sheets directly. In this case you can use the index files to retrieve the product information you need.
- Download the relevant index.
- files.index.xml.gz (.csv.gz) for all products in Icecat. Use this index once at the start of setting up the onboarding for Icecat.
- daily.index.xml.gz (.csv.gz) for the daily new and updated products. Use this index daily to select new and updated products.
- Sort and select the products you need.
- You can select on
- Manufacturer product code(s)
- GTINs (EANs, UPCs)
- On market
- You can select on
- Download the relevant product XMLs you need.
For efficiency we advise not to download all products sheets Icecat can supply, but only select those you need.
Pre-sorting means less sheets to download, so less network activity and less storage needed on your servers.
If you do not have the GTIN and/or “Brand + Product Code”information then use the index file, to look for the product information you want and need.
Replace the XX for your specific locales and language code.
The following links are essential for this method.
Index: Initial download
https://data.icecat.biz/export/freexml/nl/files.index.xml.gz (.csv.gz) | Open Icecat, Dutch
https://data.icecat.biz/export/level4/nl/files.index.xml.gz (.csv.gz) | Full Icecat, Dutch
This file contains all products in the database of Icecat. Please, don’t download all product sheets in this index file, but only those you need and use. Sort the products from the index file and then download those you need.
Index: Update download
https://data.icecat.biz/export/freexml/nl/daily.index.xml.gz (.csv.gz) | Open Icecat, Dutch
https://data.icecat.biz/export/level4/nl/daily.index.xml.gz (.csv.gz) | Full Icecat, Dutch
A much smaller file with all recent new and updated products.
Index: On market
https://data.icecat.biz/export/freexml/nl/on_market.index.xml.gz (.csv.gz) | Open Icecat, Dutch
https://data.icecat.biz/export/level4/nl/on_market.index.xml.gz (.csv.gz) | Full Icecat, Dutch
A smaller index with all currently available products. We have access to hundreds of wholesalers who daily submit what products they sell.
Explaining the index
|file path||Path to the product XML.|
|Updated||The date and time when the product was updated.|
|Quality||Where QUALITY = Supplier only the original product data as imported from a manufacturer’s CMS is available, the respective data-sheet is not yet standardized by our editors. When it is standardized the parameter is changed to QUALITY = Icecat|
|Supplier_id||ID of the brand. You can find the brand names in the SuppliersList.xml.gz|
|Prod_ID||The manufacturer product code of the requested product|
|M_Prod_ID||Other (mapped) manufacturer product codes of the requested product|
|EAN_UPC Value||The GTIN (EAN or UPC) bar code of the requested product|
|Country_Market Value||In which country the product is available.|
Please, note that this language-specific content is the standardized content, which is entered by our editors, or – in case of no standardized values – the original data imported from the CMS of a manufacturer like HP, Toshiba, Philips etc.