This document describes the CSV (Comma-Separated Values) variant of Icecat’s Open Catalog Interface: a set of standards, data structures, files and functionalities for the exchange of product data.
Icecat provides customers with the ability to download CSV product data by
In this post, we describe only (1) the real-time calls to CSV data-sheets. Generating personalized files is discussed separately. In case of 3, check out the documentation for the Icecat XML Data Interface, as the same directories also contain CSV variants of index files, which can be used to retrieve product data-sheets in CSV format.
Other available interfaces are:
In general, we advise to use the XML (or JSON) interfaces for downloading Icecat data-sheets. Interfaces based on these data formats are most robust, provide you with most flexibility and provide you with the most complete data set per product. However, sometimes the use of a CSV format is easier and more pragmatic, depending on the capabilities of the e-business infrastructure of your company.
In case that you need more information or have questions, don’t hesitate to contact us.
Icecat’s global mission is to provide e-commerce partners with high-quality product information that helps their buyers make better purchase decisions, in any world language, in any country and on any device or media.
The CSV interface may be accessed by all Icecat Data (XML) users using at least an Open Icecat account. Open Icecat users can access the data of the sponsoring brands. Full Icecat users can access the data of all brands in the Icecat database.
However attractive the free Open Icecat database is, the Full-Icecat database still contains many, many more brands: 10,000s (see https://icecat.biz/menu/vendors/index.htm). If you want specific brands to be included into free Open Icecat, please, recommend Icecat to your manufacturer contacts.
Read more about the main advantages of Full Icecat over free Open Icecat. In case you need higher catalog coverage, you will need Full Icecat. For more information, see the Icecat Susbcription Plans.
If you want to upgrade to Full Icecat, please contact us via the contact form, or click on the “request Full Icecat access” link after the User Login.
Apart from JSON, Icecat is compliant with an increasing number of international standards. See, here a quick overview of such supported standards.
The user of Open Icecat product data (in a free Open Icecat subscription or as part of the Full Icecat data) is required to respect the Open Icecat Fair Use Policy.
Explicitly relevant for website development is:
The Icecat CSV product data-sheet consists of following columns:
Columns with product specifications are included and have column headers such as “Spec #”, so that each new specification (feature) is included in a new column in the output CSV file. The number of specifications depends on the number of spec values in the respective product data-sheet. A cell with a specification value consists of a spec name, spec value and a measure unit (if present). Those columns also contain spec group names. Spec groups consist of multiple specs, which are grouped under its respective spec group, to make reading a spec table more easy for a buyer.
Example: Column header – Spec 1 Value – Processor
Column header – Spec 2 Value – Processor clock speed: 3.2 GHz
Column header – Spec N (where N is any spec number) Value – Display
Column header – Spec N+1 Value – Display diagonal: 17” Where: Processor, Display – spec groups Processor clock speed, Display diagonal – feature names 3.2, 17 – feature values GHz, “ – units
Example string from CSV, where the spec groups “Design” , “Processor” and “Memory” are marked red:
"Design","Product type: Notebook","Colour of product: Black, Silver","Form factor: Clamshell","Processor","Processor clock speed: 1.3 GHz","Processor family: AMD E","Processor model: E2-3800","Processor cores: 4","Processor threads: 4","Processor cache: 2 MB","Memory","Internal memory: 8 GB","Internal memory type: DDR3-SDRAM","Maximum internal memory: 16 GB","Memory form factor: SO-DIMM",……..
See also Digital Asset Types as Represented in Icecat’s Open Catalog Interfaces.
The Icecat real-time CSV interface, supports URL requests by:
Please, find a more detailed description of each parameter below:
Important: Red marked parameters are mandatory. A request only with ean_upc or icecat_id (product_id) without vendor and brand name is recognizable by the system and will return a datasheet.
Below you may find examples of URL calls: https://data.icecat.biz/xml_s3/xml_server3.cgi?prod_id=;brand=Philips;lang=;output=productcsv https://data.icecat.biz/xml_s3/xml_server3.cgi?ean_upc=8711500354532,8711500354501;lang=EN;output=productcsv https://data.icecat.biz/xml_s3/xml_server3.cgi?prod_id=4347B007,8576B064;brand=canon;lang=IT;output=productcsv
Icecat provides access to special type of content – rich media – via XML, xml_s3 and real-time CSV interfaces. Rich media content can be requested by the special output parameter: output=richproductcsv
Examples: https://data.icecat.biz/xml_s3/xml_server3.cgi?product_id=17727188;lang=NL;output=richproductcsv https://data.icecat.biz/xml_s3/xml_server3.cgi?ean_upc=8710103608011;lang=NL;output=richproductcsv
Note: for certain brands rich media can be restricted to their Authorized Resellers. Contact Icecat, if you think that you miss certain rich media assets that you expected to receive.
Since some manufacturer product codes may consist of special symbols like +, #, !, %, _ or space Icecat may process these only if URL encoding of such symbols is included in the URL request.
Examples: WBE3321A+NFSM = WBE3321A%2BNFSM 3580S4X BNDL = 3580S4X%20BNDL
Icecat sets up a limit on the number of simultaneous requests from each IP to ensure the stability of the service. Icecat users cannot send more than 25 simultaneous CSV URL requests. Full Icecat users can request CSV URL data only from IP addresses listed in their Icecat account profile. Requests from unregistered IPs are not processed. In such cases system returns an error message.
Read further: Manuals
Your email address will not be published. Required fields are marked *
This site uses Akismet to reduce spam. Learn how your comment data is processed.