Manuals

Manual for Personal Index & Personal Catalog

Version 2.1 (Updated on June 12th, 2026)

This manual describes how to use and manage Personal Files, which are a collection of tools on the Icecat platform designed to help you handle product data efficiently. It provides instructions on key processes, such as uploading partner product feeds in various formats (Excel, CSV, and XML), understanding the statistics of your uploaded data matched with the Icecat database, generating Personal Index and Personal Catalog files, and downloading Images.

The document also explains how to automate the process by using hosted feeds and setting up daily updates to retrieve your product files via HTTP.

How to download PIF, PCF & Images

Follow icecat.biz and log in to your account. Choose the Import/Export tab.

❗PIF, PCF and Image Download are available for channel partners and brand contacts!

Personal Files are available after your complete Matching your feed,

Personal Files overview

Personal Index File

.csv spreadsheet file with XML links for each product in your feed for each language. Available only for the INT locale.

Personal Catalog File

.csv / .xlsx spreadsheet with full data for each product in your feed. The response is the same as for the batch CSV request.

Generate Personal Catalog File with Feature names as headers not checked.

Feature groups are provided, and feature names are provided inside cells.

Spec 1Spec 2Spec 3
FeaturesProduct type: Building setProduct colour: Multicolour

Generate Personal Catalog File with Feature names as headers checked

Feature groups are not provided, and the feature names are provided as column headers.

Battery operatedBattery typeContinuous audio playback time
YesBuilt-in battery12 h

Images

.zip archive with all images for your feed sorted by language, then resolution, then product.

Output

Once everything is set up, click on Generate and navigate to the Progress Bar.

On the screenshot above, there are three possible statuses for your Personal Files

  • Gray with yellow Progress Bar – the Personal File is being generated.
  • White – the Personal File is ready for the current Product Feed.
  • Yellow – the Personal File is ready, but belongs to your previous Product Feed.

Personal Index File

prod_idsupplier_nameean_upcpath(en)path(nl)path(fr)timestampYour product IDerror_message
CE516AHP88611288065140754563768135https://data.icecat.biz/export/level4/EN/15705572.xmlhttps://data.icecat.biz/export/level4/NL/15705572.xmlhttps://data.icecat.biz/export/level4/FR/15705572.xml18.07.2025 9:35HP_IN_MY_SHOP

Using the Personal Index might simplify your implementation process. You can immediately see all the product links for all locales you are subscribed to.

You can think of a Personal Index as about map that indicates how to access the product data.

Columns

prod_id – unique Product Code, set by the brand. Always unique within a brand.

supplier_name – the name of a product’s Brand, for example, Hasbro.

ean_upc – GTIN (EAN/UPC) numerical product code(s). ean_upc. They are unique within Icecat, but Brands may sometimes reuse them for different products.

For example, Icecat Editor’s team may reassign GTINs to different products according to instructions and information provided by the brand.

Path – for each of the locales you are assigned to, a separate column Path (locale short code) is provided

timestamp – last update date for the product in format DD.MM.YYYY HH:MM

Your product ID – if set during the matching process in the Your product ID column.

error_message – If the product exists in Icecat but you lack permissions to view it, the error message appears here. It is also useful to check the 🔎 Icecat Error Messages

Your product ID can simplify product identification when matched; it actually contains a different product identifier on our side, and the product was matched according to product mapping rules. It allows you to match an Icecat data sheet with your company’s internal product ID.

Personal Catalog

Personal Catalog is a convenient tool that allows you to get product data in convenient CSV or Excel spreadsheets. Essentially, it utilizes the CSV API for each of your products and packs product information into tables.

Because of its reliance on Icecat CSV API and complex structure, the Personal Catalog is described in 🔍 Icecat CSV Manual.

How to automate the retrieval of Personal Files using HTTP

Upload your document via HTTP/FTP

For regular updates to work, this option must be chosen:

Request Daily Updates

💡 Personalized Index File and Personalized Catalog are updated automatically at 8:00 pm CET.

Once the file is uploaded and matched, click on the Request Daily Updates button. ⚠️ It won’t appear if the feed is uploaded from a PC.

Our manager will contact you and assign you to regular updates. Essentially, it will unlock for you certain endpoints, which you can access to fetch PIF and PCF regularly.

Get your Access Token

To retrieve them, follow MyIcecat → Access Tokens:

api-token – token that grants you access to the product or Personal File. With this token anyone could access everything you could so keep them secret.

Personal Index Endpoint

Locale is always 🌐 International and outputs is always CSV.

https://icecat.biz/index.cgi?login_form=user_import_report;type=match;layout=csv;api_token=<TOKEN>

Personal Catalog Endpoint

You can choose the locale and the output format — CSV or Excel.

https://icecat.biz/index.cgi?
   login_form=csv_content;
   csv_file=/products_csv_lists_new/<IcecatUserID>_<LanguageCode>.<xlsx/csv>;
   api_token=<API_TOKEN>

In order to download your Catalog, you need to know your IcecatUserID.

Download any Personal Catalog File to clarify yours. For example. if your PCF name is 12345_INT.xslx your IcecatUserID is 12345.

Check the Language Table to view the full list of supported Languages.

❗The default format for PCF endpoint is CSV as we consider it more scalable and easy for to work with in the code. If you need to fetch the Excel PCF, you have to generate it on icecat.biz first.

Example for Personal Catalog in Excel

https://icecat.biz/index.cgi?login_form=csv_content;csv_file=/products_csv_lists_new/99999_INT.xlsx;api_token=<API_TOKEN>

Example for Personal Catalog in CSV

https://icecat.biz/index.cgi?login_form=csv_content;csv_file=/products_csv_lists_new/111111_EN.csv;api_token=<API_TOKEN>

Image Download

🔎 Manual Downloading Image Libraries for Your Online Products

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

  • Hi,

    Does you service allow me to do an EAN lookup by product name?

    I have a XML/CSV file with a couple of thousand product names & brands which I need to lookup/match the correct existing EAN. Preferably by bulk uploading CSV.

    Is it possible with your system? Do i need to register for a full Icecat for that?

    Please let me know.

    Thanks in advance.
    Miler

  • I'm trying to create csv with icecat, the truth is not clear when I ask that suva file from my pc I do not understand if it should be empty or full of products ando super lost if someone could show video or pass me a sample csv.

    Thank you

    • Dear Joaquin, thanks for your comment. We should better understand your path. Please contact us and we will support you. Kind Regards, Gloria

  • We also have so many laptop batteries and adapters for selling, but really I do not find the correct way to upload,how to upload the price list and product detail.
    I think it must has a templet there,where is it?

  • In section 2 you describe that a dedicated list of product codes and/or EAN is necessary for individual download. Is there also a possibility to get all products by e.g. brand name?

    Thanks in advance

  • Hi Julie, thanks for your message! You can actually follow step-by-step this guide, namely at point #5. If you have questions on how to go ahead with uploading your price list, please contact us

  • Is there a possibility to force PIF creation after uploading new price list, not via the icecat interface, but via an API call / URL request?

  • I am in UK and need full products catalogue. what do i need to do to get it regularly on json format. please advice

  • Hello team,

    I generated a csv file based on my supplier data, and the file generated is 1.34 gb csv, when I download it, it downloads too fast for a 1.34 gb file so not surprisingly the file is corrupt. What could be the problem?

    Thank you
    Younes

    • Dear Yuones,

      I will send you an email to understand the problem better and put you in contact with the right person to help you solve it.

      Kind Regards,
      Laura

  • Just had a strange experience.
    I have +/- 20 suppliers that provide me in total of over 500.000 products.
    I act smart to download the icecat's csv's.
    - product_names
    - product_features
    - all csv's related to product_features
    - products listings
    - products_descriptions

    Products ARE found in the products listing, yet not ALL in product_names or product_descriptions.
    Find out later, there is NO csv file that hold the productTitle........ mmm ok.... then let's move back to single product datasheets (.xml)
    Try to lookup:
    https://uk.icecat.biz/en/p/10zig+technology/9011/not+categorized-optional+pcie+card+for+10zig+68xx+thin+client-22551232.html
    when i click in right bottom:
    XML product data for 10ZiG Technology 9011
    i get: EN Access to this product is restricted. Please contact your account manager at Icecat.
    ( the link should be: https://data.icecat.biz/xml_s3/xml_server3.cgi?prod_id=9011;vendor=10ZiG%20Technology;lang=EN;output=productxml )

    I have THOUSANDS of these , yet..... out of the CSV products i imported from icecat, all of them exist in the database, yet i not get access to them via the output=productxml links.

    So what is going on here?
    I have FULL icecat catalog access with the vertical "Computers & Electronics" and language English.
    And i KNOW this product exists in the icecat database.

  • Does you service allow me to do an EAN lookup by product name?

    Hello, I have a XML/CSV file with a couple of thousand product names (Manufacturer code, EAN code) which I need to lookup/match the correct attributes like RAM, Os system, Storage type or capacity. Preferably by bulk uploading CSV.

    Is it possible with your system? Do i need to register for a full Icecat for that?

    Please let me know.

    Thanks in advance.

    • You can match via your Open Icecat account (assuming you're registered) after login. By uploading the file and match on brand + brand product code or GTIN (EAN). For Open Icecat (sponsoring) brands you can look up all data with a free account. For non-sponsoring brands you will need a Full Icecat subscription.

Recent Posts

Joybuy Opens Its Marketplace as Competition for European Sellers Intensifies

Europe's e-commerce landscape continues to attract new competitors, and one of the latest developments comes…

1 day ago

Securing Against LLMs: Why the Icecat robots.txt Matters to You and Your E-Commerce Store

At Icecat, managing, enriching, and syndicating millions of product data-sheets across thousands of global brands…

2 days ago

Starbucks’ AI Inventory Experiment Offers a Reality Check for Retail Automation

Artificial intelligence has become one of the biggest investment priorities for retailers. From personalized shopping…

2 days ago

Icecat Studio – Sprint 97 Release Notes

We are thrilled to announce the release of Sprint 97 for Icecat Studio. In this…

3 days ago

Amazon’s New Warehouse Robot Shows Where E-commerce Investment Is Heading

Artificial intelligence is often associated with chatbots, shopping assistants, and personalized recommendations. However, some of…

3 days ago

DHL’s 2026 E-commerce Report Maps the Next Consumer Trends

For years, the e-commerce industry has focused on making online shopping faster and more convenient.…

4 days ago