Icecat LIVE- Manual For Granular Call

icecat
By
Icecat live

Icecat LIVE is a (free) service that enables you to insert real-time product content from some 300 major brands or manufacturers into your web site, with just a few lines of JavaScript in your HTML template.

Icecat provides customers with the ability to insert product data into their website. Other available interfaces are:

Access to Icecat

In order to access Open Icecat, you will need a username and password, provided by Icecat. If you don’t have these, please register online for Open Icecat. The Open Icecat catalog is free and contains millions of product data-sheets.

Tip: During the registration you need to choose for the URL or Data (XML) version. If you want to make use of XML, make sure 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) download format.

If you need more product data coverage, you will need to upgrade to Full Icecat. You can make your request via our contact page.

Access to the product information of Full Icecat is protected. If you want to access Full Icecat product information, we will 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 searching for a way to connect your web shop and integrate Icecat product information, check the most popular Icecat Add-ons.

What is Icecat LIVE /html?

Icecat LIVE is a (free) service that enables you to insert real-time product content from some 300 major brands or manufacturers into your web site. With just a few lines of JavaScript in your HTML template.

In this manual, we provide a quick guide on how to easily embed product information into your website.

If you plan to integrate Icecat LIVE, we advise you first to integrate free Open Icecat Live and evaluate it for your purposes. And then, plan the next step by upgrading your interface to Full Icecat.

What is Icecat LIVE? Icecat LIVE is basically a JavaScript (JS) service, providing real-time inserts of product data into your websites. Icecat LIVE enables seamless insertion of a product data-sheet in individual content assets, without the need to use frames or iframes. The LIVE/HTML version is the easy integration where -in case of Full Icecat- all authorization and security is handled at the Icecat server side.

Type of content that will be available for granular call:

Type
Definition for call
Brand and Product nametitle
  • Essential information
    • Brand
    • Product family
    • Product series
    • Product name
    • Product code
    • EAN/UPC code
essentialinfo
Marketing textmarketingtext
Manuals (PDF’s, leaflets, etc)manuals
Reasons to buyreasonstobuy
Reviewsreviews
Specificationsfeaturegroups
Image gallerygallery
Feature logosfeaturelogos
3d tourstours3d
Videosvideos

Technically, the Icecat LIVE JS (JavaScript) interface calls product data in JSON (Java Script Object Notation) format and transforms that into html. The JS makes it very easy for channel partners to embed the product information into their websites with just a few lines of code in an HTML template or app. The JS itself can also be adapted to fit the specific purposes of the Partner’s app.

Please, note that some Open Icecat brands, such as Philips, make certain rich media assets (e.g., video) only available for their Authorized Resellers. Please, contact us in case you see on the Icecat website more assets than that you can access through Icecat LIVE.

3. Embedding Icecat LIVE JS into your website

Below you may find the data flow diagram of Icecat LIVE JS integration:

schema 1

Icecat LIVE JS API

Icecat LIVE refers to a program code written in JavaScript (JS) that is embedded in a web page, and executed by the browser of your site visitor when a page is downloaded by the respective visitor, or in response to an event triggered by you as a Partner.

JS allows to create a bridge between a webshop and the Icecat catalog, which makes it possible to incorporate product information (descriptions, leaflets, multimedia objects) into merchant webshops. Moreover, Icecat LIVE uses Document Object Model (DOM), which allows to update content dynamically.

Examples
Regular call of datasheet – Brand in combination with Partcode
<html>
    <head>
    </head>
<body>
<div id="Container"></div>
<script>
    window.addEventListener('liveload', function() {
        IcecatLive.getDatasheet('#Container', {
            Brand: 'Philips',
            PartCode: 'DS8900/10',
            UserName: 'openicecat-live'
        }, 'en')               
    });
</script>

<script src="https://live.icecat.biz/js/live-current.js"></script>
</body>
</html>
Regular call of datasheet – GTIN
<html>
    <head>
    </head>
<body>
<div id="Container"></div>
<script>
    window.addEventListener('liveload', function() {
        IcecatLive.getDatasheet('#Container', {
            'GTIN': '4002515758205',
            UserName: 'openicecat-live'
        }, 'en')               
    });
</script>

<script src="https://live.icecat.biz/js/live-current.js"></script>
</body>
</html>
Regular call of datasheet – IcecatProductId
<html>
    <head>
    </head>
<body>
<div id="Container"></div>
<script>
    window.addEventListener('liveload', function() {
        IcecatLive.getDatasheet('#Container', {
            'IcecatProductId': '18253015',
            UserName: 'openicecat-live'
        }, 'en')               
    });
</script>

<script src="https://live.icecat.biz/js/live-current.js"></script>
</body>
</html>
Granular call of Title and Essential Info
<html>
    <head>
    </head>

<body>
<div id="Container1"></div>
<div id="Container2"></div>

<script>
    window.addEventListener('liveload', function() {
        IcecatLive.getDatasheet(
			{
				'title':'#Container1',
				'essentialinfo': '#Container2'
			}, 
			{
            Brand: 'Philips',
            PartCode: 'DS8900/10',
            UserName: 'openicecat-live'
        }, 'en')               
    });
</script>

<script src="https://live.icecat.biz/js/live-current.js"></script>
</body>
</html>

 

Granular call of all info from datasheet in separate containers
<html>
    <head>
    </head>

<body>
<div id="Container1"></div>
<div id="Container2"></div>
<div id="Container3"></div>
<div id="Container4"></div>
<div id="Container5"></div>
<div id="Container6"></div>
<div id="Container7"></div>
<div id="Container8"></div>
<div id="Container9"></div>
<div id="Container10"></div>
<div id="Container11"></div>

<script>
    window.addEventListener('liveload', function() {
        IcecatLive.getDatasheet(
			{
				'title':'#Container1',
				'essentialinfo':'#Container2',
				'marketingtext':'#Container3',
				'manuals':'#Container4',
				'reasonstobuy':'#Container5',
				'reviews':'#Container6',
                'featuregroups':'#Container7',
                'gallery':'#Container8', 
                'featurelogos':'#Container9', 
                'tours3d':'#Container10',
                'videos':'#Container11'
			}, 
			{
            Brand: 'Philips',
            PartCode: 'DS8900/10',
            UserName: 'openicecat-live'
        }, 'en')               
    });
</script>

<script src="https://live.icecat.biz/js/live-current.js"></script>
</body>
</html>

Description of the parameters:

ValueExplanation
UserNameIcecat User Name
BrandThe brand name of the product
PartCodeThe brand’s part code or manufacturer part number, uniquely identifying the product in combination with brand name. Also called manufacturer part code.
GTINThe GTIN: EAN (European Article Number ), UPC (Universal Product Code) or JAN (Japan Article Number)
IcecatProductIdIcecat’s Internal numerical product identifier. Only to be used by advanced users that (already) make use of the Icecat index files.

Look & Feel customization

Open Icecat Live is responsive by design and adapts to your own CSS. You can apply your own css for example in: www.user.com/home/mystyle.css

Several examples:
Applying CSS for 1 container
<html>
    <head>
    </head>
 
<body>
 
<div id="Container"></div>
 
<script>
    window.addEventListener('liveload', function() {
        IcecatLive.applyCustomCSS(
            'www.user.com/home/mystyle.css';
            )
        })
</script>
 
</body>
</html>
Applying CSS to 1 container through URI
<html>
    <head>
 
    </head>
 
<body>
 
<div id="Container"></div>
 
<script>
    window.addEventListener('liveload', function() {
        IcecatLive.applyDefaultCSS()
        })
</script>
 
</body>
</html>
Using ApplyCSS with Granular Call
<html>
    <head>
 
    </head>
 
<body>
 
<div id="Container1"></div>
<div id="Container2"></div>
<div id="Container3"></div>
<div id="Container4"></div>
<div id="Container5"></div>
<div id="Container6"></div>
<div id="Container7"></div>
<div id="Container8"></div>
<div id="Container9"></div>
<div id="Container10"></div>
<div id="Container11"></div>
 
<script>
    window.addEventListener('liveload', function() {
        IcecatLive.getDatasheet(
            {
                'Title':'#Container1';
                'EssentialInfo':'#Container2';
                'MarketingText':'#Container3';
                'Manuals':'#Container4';
                'RTB':'#Container5';
                'Reviews':'#Container6';
                'Specifications':'#Container7';
                'ImageGallery':'#Container8';
                'FeatureLogos':'#Container9';
                '3dTours':'#Container10';
                'Videos':'#Container11'
            },
            {
            Brand: 'Philips',
            PartCode: 'DS8900/10',
            UserName: 'openicecat-live'
        }, 'en');
     IcecatLive.applyCustomCSS(
            'www.user.com/home/mystyle.css';
            )             
    });
</script>
 
</body>
</html>

Please, contact us in case of questions or comments via your Icecat account manager or via the website:  https://www.icecat.biz/en/menu/contacts/index.html

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