Version: 1.21, August 28, 2019.
The purpose of this post is to explain the Icecat URL method to get product data-sheets. It’s the easiest way to integrate product data in your website. But, not the most sophisticated one as URLs require frames or iframes. If you want to integrate product data without frames, conforming your CSS, then use Icecat Live. If you want to have full control over the data, then make use of the XML, JSON or CSV download methods. See the overview of methods and manuals.
Further, check out the Add-On page for popular platforms already integrating Icecat data.
Are you interested in adding product reviews? Then check out the reviews manual.
Join the Icecat User Group to participate in discussions about the Open Catalog Interfaces.
It is our mission to provide channel partners and buyer orientation websites with high-quality product information that helps buyers decide.
This service works both for free Open Icecat, and paid Full Icecat subscriptions.
However attractive the free Open Icecat database is, the Full Icecat database still contains many, many more brands: 14,000+. If you are interested in subscribing to the Full Icecat database, please contact us via the website.
For more information, see the Icecat Subscription Plans.
There are two methods of getting URL links. By creating direct links, or by downloading the pre-defined links from our server.
In response to client requests, and to make it more easy to integrate the URL versions of Open Icecat and Full Icecat, we allow since today also direct linking without Icecat ID. Of course, the old method is also still supported, which has the advantage that the webshop knows in advance for which products product data-sheets are available.
General format I:
Example Open Icecat user:
General format II:
The disadvantage of direct URL links is that you don’t know in advance if Icecat has a data-sheet for the respective product or not. By downloading the full list of pre-defined URLs, before deciding to show these to the user, covers this issue. Another advantage is that a few extra attributes are already provided, like category and image links, that help to populate your system.
TIP: if you only need image links, the URL service is an efficient solution
The URL data are supplied in two formats: CSV and XML. The export file already contains all data, required to import URLs. It contains: the Icecat product id, the vendor product id and the vendor brand name, plus the URL to a rich content product page. The explanation of supplier codes can also be found in the same data export file in case of the XML format, and in a separate file in case of the CSV export.
Open Icecat users should make use of the following server folder: https://data.icecat.biz/export/freeurls/ If you don’t have login credentials yet, please, register for free for Open Icecat.
If you have upgraded to a Full Icecat account, you can download XML data from the location below: https://data.icecat.biz/export/export_urls.xml.gz
You can download CSV data from the locations below: https://data.icecat.biz/export/export_urls.txt.gz https://data.icecat.biz/export/export_suppliers.txt.gz
Information about the categories we use, can be found here: https://data.icecat.biz/export/categories.xml.gz
TIP: use the gzipped files for more efficient data transfer
Sometimes distributors give their own interpretation of brand product codes, instead of using the original ones. And thus, one product can be mentioned a few times, e.g., as Z891-091 and Z89/091.
If they refer to the same product Icecat will provide a product code mappings to avoid double products in your catalogue.
In the export_urls.xml (or .txt) file, you can find the attribute called m_prod_id. In this attribute Icecat stores the mapped product code, which (sometimes) differs from the one supplied in prod_id (conforming to distributor data).
You can use the following rule: when products have the same m_prod_id, they are treated as the same product in Icecat.
Using the m_prod_id attribute might help you to increase the match with Icecat product data-sheets.
GTIN (Global Trade Identification Number) is the umbrella term for bar code standards that include UPC codes (GTIN-12) as they are used in North America, EAN (GTIN-8, GTIN-13 or GTIN-14) that are used in Europe, and JAN (Japan Article Number).
Especially in some industries like consumer electronics, solely UPC or EAN are used to identify a product. We have added a separate attribute to match on EAN or UPC.
Note: there can be multiple EAN / UPC codes per product, because per packaging variation a new code is published. Further, dependent on logistic processing and import/export sometimes different codes are given out per region.
The Icecat quality parameter stands for the amount and standardization level of data, included in a product data-sheet. Quality=SUPPLIER implies that we got product data from a manufacturer directly, but that data might not be standardized conforming the Icecat data model. Quality=ICECAT is the highest level of quality, implying that product data conforms to Icecat data model. Quality=NOEDITOR means that the respective product is not yet enriched, and only logistic data is imported from a distributor or retailer.
When a visitor will follow an Icecat link, our product viewer will perform an on-line request. Data will be supplied real-time by the Icecat server. Please, note that obtained URLs should be appended with the parameter shopname.
So, e.g. if your login is “axio” you should append “shopname=axio”, e.g.:
In case of Open Icecat, please register online via the website: choose “Login”, and then “Register as new user”. Your username / password combination will be provided immediately. Please, note that also unregistered usage with shopname=openICEcat-url is supported. However, this will provide less freedom to customize and optimize your templates.
In case of Open Icecat, it is important to include the language/locale identifier:
More Open Icecat examples:
Category information can be obtained via https://data.icecat.biz/export/freeurls/categories.xml.gz
Please, contact us if you have any additional questions.
Featured image: wikipedia by Rock1997
Read further: Manuals, Icecat URL, product data-sheet
Applied service change: 1. Please add info about: this service can be used with Open Icecat URL or/and Full Icecat URL subscription. 2. Links provided in examples are outdated: we have get rid of the "index.cgi" in links 3. Please change ";" in provided links to "&" (without quotes)
e.g. as is: https://prf.icecat.biz/index.cgi?prod_id=brand_product_code;vendor=brand_name;shopname=your_Icecat_user_name;lang=language_code to be: https://prf.icecat.biz/?prod_id=brand_product_code&vendor=brand_name&shopname=your_Icecat_user_name&lang=language_code
Hello, I have one TV model: un40fh5303f and they have the LCD Display damage. You have the part number of this? where I find this part? How I looking for in the internet sites.
Many thanks or your help.
Hi Tony, Thanks for your message. You will find the data-sheet for your TV here. You will see your product information, which is our core business. To get support for your product, you can contact Samsung. Kind Regards, Gloria
Is there a manual available.
The post you refer to is a manual, and there are links to other manuals included. What are you looking for exactly?
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.