Manual: downloading individual Product XMLs

icecat
By

This document describes how to download individual products from Icecat in XML format.

Icecat provides customers with the ability to download XML product data. Other available interfaces are:

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.

Building your own XML-download

Access

For access to the product information you need to setup server access. If you have no or little experience in setting this up, we advise you to make use of the URL (links to pictures and datasheets) or Icecat LIVE versions.  You can always contact us for assistance.

XML access works via basic HTTP authorization, also used for other HTTP requests.

In short:  requesting access in advance and then downloading the data.

Downloading individual Product XMLs

For smaller catalogs,  for testing XML or updating, in other words for small data-sets, it is handy to use of our realtime interface (URL2XML) for retrieving product XML from the Icecat.

The general format of the call is:

Requesting a product XML by Brand and Product_ID:

https://data.Icecat.biz/xml_s3/xml_server3.cgi?prod_id=<prod_id>;vendor=<vendor_name>;lang=<lang>;output=<output>

or

Requesting a product XML by GTIN (EAN or UPC):

https://data.Icecat.biz/xml_s3/xml_server3.cgi?ean_upc=<EAN or UPC>;lang=<lang>;output=<output>

Where:

prod_idthe manufacturer part number of the requested product
vendor_namename of the manufacturer of the requested product
ean_upcthe GTIN, EAN or UPC code to identify a product
langthe language code (INT – for the international/standardized repository, EN, NL, FR, … for local repository)
outputthe type of the response. It can be productxml (the product xml file) and metaxml (the index or meta information on the Brand + ProdID/M_Prod_ID or EAN/UPC)

For example, if you need to get an xml file of product ‘Compaq 6710b Base Model Notebook PC’, manufactured by HP, with product code RJ459AV and EAN 4960999358246 in English, the call will be as given below.

By brand and manufacturer part number:

https://data.Icecat.biz/xml_s3/xml_server3.cgi?prod_id=RJ459AV;vendor=hp;lang=en;output=productxml
prod_idRJ459AV
vendorhp
langen
outputproductxml

By GTIN (EAN or UPC):

https://data.Icecat.biz/xml_s3/xml_server3.cgi?ean_upc=4960999358246;lang=en;output=productxml
ean_upc4960999358246
langen
outputproductxml

Explaining the product XML

Understanding the information in the XML is important before importing the data in your shop. It’s essential to match the product information in Icecat to your PIM (Product Information Management system) in the right way.

General

Product
 QualityWhere 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

 

ProductFeature

Icecat: ProductFeature

ProductFeature
 Value This is the international value. It is always in English and it is the bases of the other values.
 Presentation_ValueThis value is used to show the information on the website of icecat or your website. We do not recommend you use it for import in your PIM or backend.
 LocalValueThis value is the local language value for your country/language (locale).
 Sign You can find the measurement sign in the CDATA.
 TranslatedIf the feature is translated in your local language or not.
 MandatoryIf the feature is mandatory, it will always be filled.
 SearchableUsed by Icecat

 

Likethumbsup(1)Dislikesthumbsdown(0)

Leave a Reply

Your email address will not be published. Required fields are marked *

open-live-optimized

Manual for Icecat Live: Real-Time Product Data in Your App

Icecat Live is a (free) service that enables you to insert real-time product content from some 300 m...
 June 1, 2016
World map

Iceclog Launch and Improved Icecat LIVE Documentation

“Iceclog” (Icecat content-log) is our new blog, where you will find...
 August 26, 2016
http url

Manual for Icecat URL: Links to Product Data-sheets and Images

Version: 1.20, October 4, 2016.The purpose of this post is to explain the Icecat URL method to ...
 October 4, 2015
open-csv-optimized

Manual for Icecat CSV Interface

This document describes the CSV (Comma-Separated Values) variant of Icecat's Open Catalog Interface...
 September 28, 2016
wall-writer-in-action

Iceclog Editor Guidelines: Writing Compelling Posts

The Iceclog Editor Guidelines are a quick guide for contributors to the Iceclog blog or "cl...
 August 17, 2016
open-personalized-csv-optimized

Manual for Personalized Interface File and Catalog

Via the Icecat website and login area, a user can generate personalized or customized CSV or Excel f...
 October 5, 2016
apple_watch_series1

Apple Watch: a Useful Tool or a Smart Toy?

After six months spent with my Apple Watch, I am still not sure if I consider it a useful tool or "j...
 September 30, 2016

Manual for Testseek Product Reviews Integration via Icecat

Icecat provides aggregated expert reviews from our partner Testseek, as an add-on service for both O...
 October 19, 2015

Manual for Open Icecat JSON Product Requests

JSON (JavaScript Object Notation) is an increasingly popular means of transferring to data, comparab...
 February 17, 2017
ball-752070_960_720

FAQ for Brand Owners

Icecat is an independent global syndicator of rich product content. In...
 October 19, 2016