Manuals

Manual: How to Import Free Product Content Into Your E-commerce System via Icecat API

This guide is intended for developers working with Icecat via API. The document provides an overview of each Pull API, used by channel partners to download the Icecat Product Data Sheets.

If you have the brand account, which updates the product data on Brand Cloud, refer to Push API Manual instead.

Where to start?

Subscriptions

Icecat provides a Free Open Icecat subscription with access to the Open Icecat repository.

The Open Icecat repository is the part of the Icecat XML repository that is sponsored by Brands and is provided for free to the channel. The most recent list of Open Icecat brands is here.
Open Icecat is also useful for testing purposes before you upgrade to Full Icecat. The technical structures are 100% compatible with those of Full Icecat.

However attractive the free Open Icecat database is, the Full Icecat database still contains many, many more brands: tens of thousands. Datasheets are often provided with service levels and coverage guarantees.

In case you want to upgrade to Full Icecat, please contact us via the contact form or click on the Upgrade in your Settings.

 Read more:Main advantages of Full Icecat over Open Icecat

Open Icecat Fair use Policy

We require any user of Open Icecat product data – in a free Open Icecat subscription or as part of the Full Icecat data – 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 Icecat.biz.
  • to include explicitly an AS IS Disclaimer, an example of which is here: English Disclaimer.
  • to not use any Icecat data for AI training.

Access to Content

To access Open Icecat, you will need a username and password provided by Icecat. If you do not have these, please register online for Open Icecat. The Open Icecat catalog is free and contains millions of product datasheets.

If you need higher product content coverage, you will need to upgrade to Full Icecat. You can make a request via our contact page or through your account pages.

In short, access to the product content of Full Icecat is protected. If you want to access Full Icecat product content, you must unlock your IP address. Fill in the IP address(es) of your server(s) and office in the “Allowed IP addresses” field. If you do not know your office IP addresses, visit What is my IP to find your (office) IP. For your server IP address, please ask your system operator or provider.

You can fill in several IP addresses, separated by a space.

Popular Add-ons

If you are searching for a way to connect your app and integrate Icecat product content, check the most popular Icecat Add-ons.

API Overview

XML or JSON

Download product content, pictures, videos, marketing text. automatically, and add them to your webshop or app.

Also, see the complete Icecat XML manual. Please note that the data is also available in JSON format

CSV or Excel

Download product information, pictures, videos, etc., and automatically add them to your webshop or app.

Icecat Live pages and Product Stories

Show real-time product content, pictures, videos, specifications through JavaScript directly on your shop pages. The simple method shows complete PDSs or a few popular objects like Videos, Reasons-To-Buy, and 3D images. Check the advanced Live manual if you want to have complete control over what content assets to show where and how (CSS).

Icecat Live is the modern variant of the good-old URL integration method.

Access to Product Reviews

Are you interested in adding product reviews professional and user reviews to your webshop? Then check out our review manual.

Access our MCP server

Especially, for agentic AI, the Model Context Protocol (MCP) has become a de-facto standard. Icecat supports MCP to support your AI Agents.

Important information

Flow – importing relevant product data from Icecat

  • Download the relevant index.
    1. files.index.xml.gz (.csv.gz) for all products in Icecat. Use this index once at the start of setting up the onboarding for Icecat.
    2. daily.index.xml.gz (.csv.gz) for the daily new and updated products. Use this index daily to select new and updated products.
  • In order to import only certain products from the list, you can make your query based on:
    1. Brand
    2. Manufacturer product code(s)
    3. GTINs (EANs, UPCs)
    4. Category
    5. Quality
    6. On market
  • Download the relevant product XMLs you need.

Important Links

Icecat is a global leader in product content syndication, helping brands, manufacturers, distributors, and retailers deliver enriched and consistent product information across multiple platforms. Trusted by 40,000+ e-commerce brands, Icecat helps turn browsers into buyers.

icecat

Icecat is a global leader in product content syndication, helping brands, manufacturers, distributors, and retailers deliver enriched and consistent product information across multiple platforms. Trusted by 40,000+ e-commerce brands, Icecat helps turn browsers into buyers.

View Comments

    • Dear Philipp
      There is no specific time for this action. We would like to suggest to make HEAD requests to the file, updated timestamp will be returned in response

    • Can't be pinpointed exactly, given multiple daily batch processes. You could first query the file creation date before pulling the index.

  • Salut ,
    Mon lecteur affiche un message d'erreur : 5-PROTEC et s'arrête .comment puisse résoudre ce problème ?

    • Hi George, thanks for your comment. A country manager will contact you soon. Regards, Wouter

  • about the daily file: suppose we missed for whatever reasons some of the daily files. Then we do not know which products should be updated or not.
    Is there a way to download historical daily files?

    • Hi Edwin, thanks for your response. A country manager will contact you soon. Regards, Wouter

    • Hi Edwin, a general advice is to use the full index at regular intervals for a full sync to ensure you didn't miss certain updates in addition to using the daily indexes for efficiency.

  • Hello,
    We’re integrating Icecat and want to run a one-time full import, but the API process takes too long.
    Is there a faster way to get the full database?
    Also, can we get a full list of product categories to structure our API requests?

    Thank you!

    • Dear Yaryna

      You need to use index file to match your portfolio against the Icecat data base and download the products via XML or JSON calls. Of course it is possible to get the full list of the Icecat category tree.
      Icecat country manager for Switzerland, Lana Buschhoff will contact you to explain the details.

      Kind regards

      Vazha Abramishvili

  • Hi,
    Today we have talked to Koen Gerlach, and are into looking whether we can implement IceCat in our product information database. We have the same concerns as others mentioned above. Once we have processed our initial dataset we can receive/pull daily indexes, but wonder what to do whenever we miss one or more daily indexes. As you suggested, reprocessing a full dataset is one option. But how nice would it be if we could extend the query (as you explained on this page) with a last change date; include all records that were changed on or after that date.
    Kind regards,
    Guus

    • Agree, that would be neat. On itself, you can also use the timestamps of product datasheets in the full index, to limit oneself to updated datasheets. Use the attribute Updated="20250919180851" for filtering.

Recent Posts

AI-Referred Shoppers Are Spending More – Here’s What That Means for E-commerce

For years, search engines and social media have been the primary gateways to online shopping.…

20 hours ago

Alibaba Sues US Government Over Pentagon Blacklist

Global e-commerce has long depended on open markets, international supply chains, and cross-border technology partnerships.…

2 days ago

When AI Becomes a Geopolitical Issue: The Anthropic Export Controls Debate

Artificial intelligence is increasingly shaping international competition. Discussions about AI often focus on new models,…

3 days ago

Origin Storage Joins Icecat Commerce Distributor Partner Network

We are happy to announce that Origin Storage has officially joined the Icecat Commerce Partner…

6 days ago

White House Sets Faster Timeline for Post-Quantum Cryptography

Artificial intelligence dominates most technology headlines today, but another technology is quietly reshaping long-term cybersecurity…

6 days ago

Pinterest Wants AI to Understand Taste, Not Just Search Terms

People rarely visit Pinterest looking for a specific item. Instead, they come with ideas, inspiration,…

7 days ago