Manual for Open Icecat JSON Product Requests

Alexandr Kravtsov
February 17, 2017

JSON (JavaScript Object Notation) is an increasingly popular means of transferring to data, comparable to XML. Under the hood, it’s used by Icecat Live‘s JavaScript applications. Main advantages of JSON are that it’s more efficient in terms of data transfer, and that it’s compatible with JavaScript applications requiring JSON.

This manual explains the Open Icecat JSON call formats and the output. For Full Icecat JSON, we refer to the general Icecat JSON manual, which will be reworked for the blog as well.

Important Notes about Icecat JSON

  1. Our JSON interface is relatively new, and certain aspects of our JSON interfaces might be subject to upgrades.
  2. The current use of JSON is limited to the retrieval of individual product data-sheets. For the use of indexes and repositories, and a more in-depth insight in the Icecat data model, we refer to the XML documentation.
  3. In case of Full Icecat data access or retrieval of private brand assets, authorization may be required, and a proper server certificate is to be used. We’re working on simplifying the authorization process in case of JSON data, making it comparable with the Full Icecat XML data access.
  4. The links and files in the download directories are to be downloaded with scripts (from server to server). If you try to download them via your browser, you may sometimes experience memory problems. This does not mean that on our side the data is not accessible or correctly available. In case you experience any problems, contact us via the contact form.

Our Global Mission

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.

Advantages of upgrading to Full Icecat

The JSON interface may be accessed by all Icecat Data (XML, CSV  or JSON) users, with 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 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.

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.

Open Icecat Fair Use Policy

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:

  • to mention explicitly the “Specs Icecat” on all product datasheets, with a link to the web site
  • to include explicitly an “AS IS” disclaimer, an example of which can be found at (available in several languages).

International Standards Supported

Apart from JSON, Icecat is compliant with an increasing number of international standards. See, here a quick overview of such supported standards.

1. JSON Examples for Instant Use

Before elaborating the generic JSON structures, it’s good to look into examples. Below some examples of real-time Icecat JSON product requests based on different product identifiers. You can dynamically construct such links for your applications using your Icecat user name and the product identifiers known by your system.

1. ProductCode & Brand = Brand product code + the brand name:

2. GTIN = the GTIN (EAN, UPC or JAN) bar code:

The third method, will require a bit more complex integration, as you have to read first the Icecat index files to obtain the Icecat product IDs. Recommended in case of large-scale integrations in which you want to predict for which products Icecat has product data or not.

3. icecat_id = Numerical product identifier in Icecat catalog (to be taken from Icecat index files):

The general URI structure is:
With product code & the brand’s name:


With GTIN (EAN, UPC or JAN code):


With Icecat ID:


Query parameters:

Query Parameter Description
ProductCode + Brand or GTIN The unique product identifier: Brand + Manufacturer Part Code or GTIN (EAN, UPC or JAN)
Language the language code or locale code (in case of ambiguity) that is used
Content Content parameter. If the Content parameter is absent in the URL request, the system will return all products content that is available.
UserName the Icecat user name as registered and authorized for certain repositories

Generally, the JSON REST service operates with the following Content parameters:

Content parameter Description
All All content of the product
GeneralInfo The general info of a product, which includes: Product title, Brand, Product name, Brand product code, category, virtual category, product family, product series, GTIN
Image The main image of a product (IsMain)
Multimedia all multimedia files related to a product: videos, PDFs, 360o/3D demos, and etc.
Gallery all gallery images of product
FeatureLogos feature is enriched with a feature logo, and this logo is provided.
Descriptions The marketing text and long summary description
ReasonsToBuy The main arguments to buy products, formatted as reasons to buy (RTB): RTB image + RTB title + RTB description
Reviews The expert or user reviews of a product, which are mainly provided by Testseek.
Related The related products (this data is not used now)
Dictionary (Imports for dictionary: Brand, Сategory, Product_Family, Product_Series, ReasonsToBuy, UserManual, ProductName, Product code) The translation of content elements into the local language

Here is the request structure:

http(s)://{content parameter}*

* you should enter the content parameter you need


  • With ‘all’ content parameter
    The method GET is to be used. For all content parameter the following is to be entered:
  • With ‘multimedia’ content parameter
    The method GET is to be used. For multimedia content parameter the following is to be entered:

2. Working with JSON Output

Once you enter any request, for example,
you can get two results:

  1. the request succeeds
  2. the request fails.

If the request succeeds, the server responds with a 200 OK HTTP status code and the data properties:

 200 OK
 message: ‘OK’,
 ‘data’ :
 ‘ID’: , // product identifier
 ‘URL’: ,
 ‘Type’: ,
 ‘ContentType’: ,
 ‘KeepAsUrl’: ,
 'Description': ,
 ‘Size’: , (optional) // in bytes
 ‘IsPrivate’: , (optional) // 0/1 or true/false
 ‘Updated’ : , (optional)
 ‘Language’: , // language code or locale code (if ambiguous)
 `isVideo`: // 0/1 or true/false

If mandatory fields weren’t filled in, the server responds with 404 HTTP status and the corresponding error message:

 404 Not Found
 Status code:1
 Message: "Error: UserName, lang are mandatory fields"

When content, for example, multimedia object (MMO), is absent and product is sponsored
(Open catalog), the server responds with a 200 OK HTTP status code:

 200 OK
 message: ‘OK’,
 ‘data’ :
 'Multimedia': []

If the request is failed due to any reason mentioned above (see ‘Data retrieving algorithm’),
the server responds with 404 HTTP status and with the corresponding error message:

 404 Not Found
 message : “Shop The Icecat user is unknown”

This is a live example from our database:

 • data:
 • Multimedia:
 • {
 • IcecatID:"1978657",
 • URL:"",
 • Type:"video/mp4",
 • ContentType:"video/mp4",
 • KeepAsUrl:0,
 • Description:"Video",
 • Size:"14623468",
 • IsPrivate:0*,
 • Updated:1426261310,
 • Language:"EN",
 • isVideo:1
 • {
 • IcecatID:"1978658",
 • URL:"",
 • Type:"video/mp4",
 • ContentType:"video/mp4",
 • KeepAsUrl:0,
 • Description:"Video",
 • Size:"22487335",
 • IsPrivate:0,
 • Updated:1426261310,
 • Language:"EN",
 • isVideo:1
 • {
 • IcecatID:"1978659",
 • URL:"",
 • Type:"video/mp4",
 • ContentType:"video/mp4",
 • KeepAsUrl:0,
 • Description:"Video",
 • Size:"20575036",
 • IsPrivate:0,
 • Updated:1426261310,
 • Language:"EN",
 • isVideo:1
 • {
 • IcecatID:"2142148",
 • URL:"",
 • Type:"360",
 • ContentType:"application/x-shockwave-flash",
 • KeepAsUrl:0,
 • Description:"360",
 • Size:"776006",
 • IsPrivate:0,
 • Updated:1426261310,
 • Language:"EN",
 • isVideo:0
 • demoAccount:false

Note!:  ‘IsPrivate:1′ means that this (asset) belongs to our private database, which is
accessible for authorized resellers only. ‘IsPrivate:0’ means that no further authorization is required to access the asset(s) involved.


Leave a Reply

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

Open Icecat Live

Manual for Icecat Li...

Icecat Live is a (free) service that enables you to insert real-time product content from some 300 m...
 November 8, 2016
http url

Manual for Icecat UR...

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

Manual for Icecat CS...

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

Iceclog Launch and I...

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

Manual for Personali...

Via the Icecat website and login area, a user can generate personalized or customized CSV or Excel f...
 October 5, 2016
Interview radio Lets talk business

Interview Icecat CEO...

Ron Lemmens of's Talk Business interviewed Icecat CEO Martijn Hoogeveen abou...
 November 23, 2016

Manual for Testseek ...

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

Manual for Full Icec...

If you use the html variant of Full Icecat Live, you don't need to read this manual. But, in case th...
 August 26, 2016

Apple Watch: a Usefu...

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

FAQ for Brand Owners

Icecat is an independent global syndicator of rich product content. In...
 October 19, 2016
Field notes by Beth Kinder

10 Tips for Successf...

Based on the experience of thousands of Icecat and PIM implementations, I distilled the ten most cr...
 August 29, 2016
Smartwatches with searchables

What Etailers Want a...

Etailers and brands have their own view on their products and they subsequently live in their own wo...
 August 10, 2016
Icecat is National Champion in European Biz Awards

Icecat Nominated as ...

Icecat NV has been nominated by the European Business Awards (EBA), within the category of busines...
 September 6, 2016

TradeMag Taiwan: The...

TradeMag in Taiwan interviewed Icecat CEO Hoogeveen and APAC director JJ Jan in its August 17, 2016 ...
 August 19, 2016
Fun's baby doll and Fun work...

Content Supplier Icecat develops a standard for product information for toy brands. The standard for...
 September 6, 2016
Product video in Icecat

PIM for rich media a...

There's a whole lot of confusion around the term PIM - Product Information Management system. A lot ...
 August 9, 2016

Open Icecat Fair Use...

A user of Open Icecat will conform to this Open Icecat Fair Use Policy and do its best to avoid to h...
 October 2, 2015
Putting things together

How a good PIM can u...

Spreadsheets, tons of spreadsheets for a new series launch. For marketeers their recurring nightmar...
 September 1, 2016

Quick Guide for Real...

Because of the size of index files, it is in many cases advised to use real-time data requests. Thi...
 October 20, 2016
Bitcoin blockchain

What Should Etailers...

Bitcoin's hype in 2014, leading to its all-time-high of close to 1200 USD or 900 EUR, has marked t...
 September 19, 2016

Icecat Locales and L...

Within Icecat a large number of languages or locales (language and country combinations) are support...
 August 19, 2016
checklist manufacturer xml

Checklist for Great ...

Brands like Philips, HP, 3M, Whirlpool and Tefal, start to understand the need for investing in the...
 September 14, 2016
Also holding ag

ALSO acquires Apple ...

ALSO Holding AG (SIX:ALSN) announces that it is in exclusive talks to acquire Dutch Apple and suppli...
 September 2, 2016
FireShot Screen Capture #010 - 'Product data-sheet Cooler Master NotePal Erg_' - uk_icecat_biz_en_p_cooler-master_r9-nbs-e32k-gp_notebook-cooling-pad

Cooler Master offers...

Cooler Master is now providing its Benelux and Nordics c...
 August 12, 2016

Iceclog Editor Guide...

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

TomTom re-entered Ic...

TomTom is a brand in change, which re-entered the Icecat Top 100, as all its fast-growth categories,...
 August 2, 2016

Gigabyte adds Where ...

Gigabyte, the Taiwanese PC components and notebook brand, adds Where-To-Buy (WTB) to its UK websit...
 September 23, 2016

Icecat API Manual Gu...

This Icecat API Manual Guidelines is written to help to increase the usability and consistency of t...
 August 16, 2016

10 Dos and Don’...

How to successfully manage your new webshop? From social content marketing to check out and shipping...
 October 12, 2016

Icecat’s Globa...

Icecat's global mission is to provide e-commerce partners with high-quality product information that...
 September 8, 2015
Japan shopping street

Online Shopping Mark...

If you have never visited Japan, I’m pretty sure you will picture a lot of common stereotypes. For...
 October 31, 2016
NPEX SME Stock Exchange

E-commerce syndicato...

 November 3, 2016
Macy's webstore

Macy’s got it:...

Macy's Inc. announces to close 100 of its US stores, 14% of its footprint, to start with locations ...
 August 12, 2016

Reviewing WordPress,...

We selected WordPress as we got positive references, and as it's the most popular open source
 August 31, 2016
Icecat Top 10 Brands Q2 2016

Icecat Top 10 brands...

The leading Icecat Top 1000 brands in Q2-2016 are respectively HP (+15%), Lenovo (+92%) and Philips ...
 August 2, 2016
FD Icecat naar beurs

Icecat’s IPO A...

Last week there was abundant response to Icecat's IPO announcement of November 3, 2016. Mainly in th...
 November 6, 2016
Redcoon webshop closed

Is Redcoon closing s...

According to an unconfirmed internal email seen by 
 October 3, 2016
website hamburger menu

Changes in the Iceca...

To make Icecat’s website more user friendly, a few changes have be...
 October 8, 2016

All-In-One PCs and N...

All-In-One-PCs and desktop-PCs continue to expand explosively in Q2-2016. Also leading category Note...
 August 3, 2016

Electronic toys boom...

The Fast-Growth Categories in Icecat in Q2-2016, are led by electrical, toys, beauty categories and ...
 August 3, 2016

Content License Icec...

Version: 1.24 June 30, 2015 THIS CONTENT LICENSE (“License”) is applicable to any content ser...
 June 30, 2015
Iceimport by Iceshop

Connecting to 300 un...

If you want to see stock and prices integrated in your webshop or ERP, Iceimport is a great service....
 October 18, 2016

Icecat is hiring: Fr...

Published on: October 17, 2016 Location: Amsterdam Operating schedule: ...
 January 1, 2015
Icecat top 10 Fast Growth Brands Q2 2016

Weidmüller and Stud...

The fastest developing E-channel brands in Q2-2016 are connectivity brands Weidmüller and Alcasa, w...
 August 2, 2016
Apple down the stairs

Apple versus Verstag...

Verstager, the European Commission's (EC) competition chief, ruled that Apple has to pay it's reason...
 September 4, 2016
Ecom Pro PIM solutions

Ecom Pro: managing p...

Ecom Pro is helping retailers in The Netherlands to enrich their product data from several sources, ...
 October 19, 2016
Top 10 Brands Icecat Q3-2016

Philips Number 1 Bra...

In Q3, 2016, Philips overtook HP as the number one brand in the Icecat channel monitor. This is the ...
 October 20, 2016
takeaway-thuisbezorgd-ipo eyes 1 ..., the Amsterdam based meal delivery service, plans its IPO on September 30, at Euronext...
 September 20, 2016
escape room game

Dutch “Identit...

Identity Games, a Rotterdam toys company, offers standardized product information to its e-tailers v...
 October 27, 2016

Icecat Add-ons for P...

Icecat has a huge list of integration partners, that make it easy for clients and free users, to mak...
 February 4, 2017
Sales Manager Position

Icecat is hiring: Sa...

Location: Icecat office Amsterdam Time: Full time Education: Completed Bachelor/University level e...
 September 17, 2016
Sales Manager Position

Icecat is hiring: Sa...

Location: Amsterdam/Nieuwegein Operating schedule: Full time Education:...
 September 17, 2016
Top 10 Brands 2016 e-channel

E-channel Top 10 in ...

HP, Philips and Lenovo are leading the ecommerce channel in 2016, based on a measurement of 8.4 bill...
 January 31, 2017

E-commerce syndicato...

After just 60 days since its IPO announcement, Icecat has reached the minimum subscription level of ...
 January 10, 2017

Icecat Reaches the F...

Icecat has been selected as finalist in the 2016/17
 February 7, 2017

JumboDiset uses Icec...

JumboDiset, manufacturer of games, toys and puzzles, will offer its European Partners product inform...
 January 17, 2017

Open Content License

This document outlines the principles underlying the Open Content (OC) movement and may be redistri...
 October 2, 2015
Sales Manager Position

Icecat is hiring: Re...

Location: Amsterdam Operating schedule: Full time Education: Master deg...
 August 17, 2016

Icecat acquires e-co...

Icecat acquires e-commerce integrator Iceshop for 3.1 million euro Amsterdam, Th...
 December 28, 2016

General Terms &...

Version: January 24, 2014
 January 24, 2014


Location: Manila, Philippines Operating schedule: Full time Education: ...
 August 17, 2016
a guide to reviews in ecommerce

A guide to using rev...

The positive impact of reviews in e-commerce is already a well-established concept in the industry a...
 November 1, 2016
RTL7 interview at Business Class

RTL TV interview of ...

Today, was the broadcast in the RTL7 Business Class program of an interview of Martijn Hoogeveen by ...
 November 27, 2016

Marketing & Sal...

Icecat is looking for an enthusiastic trainee, fluent in one of the Scandinavian languages, to expan...
 August 28, 2016
Top 19 categories 2016

Do It Yourself, Beau...

In 2016, the most popular online categories, according to Icecat, were notebooks, PCs and warranty &...
 February 4, 2017

Manual for Open Icec...

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

Akeneo announces the...

Open source Product Information Management (PIM) system provider
 February 14, 2017

IPO of Icecat succes...

 March 2, 2017
Sales Manager Position

Icecat is hiring: Co...

Location: Amsterdam/Nieuwegein Operating schedule: Full time Education:...
 September 23, 2016

Why choose to upgrad...

We advise users to start their implementations with free Open Icecat. Next, if the technical interfa...
 February 17, 2017

International Standa...

Without being complete, here follows a list of international standards supported by Icecat. ...
 February 17, 2017
Tech Data ceo Bob Dutkowsky

Tech Data closes $2....

Tech Data, the global tech distribution giant, closes its $2.6 billion acquisition of the Technology...
 March 3, 2017

Coverage Analysis of...

All shops want good product information, for as many of their products as possible. Therefore, befo...
 January 25, 2017

Snap raised $2.3 bil...

Snap Inc's IPO valuation at $22 billion invokes speculation and debate. After a day of trading the v...
 March 4, 2017