These methods allow to get the information of all the products available in the catalogue. APIs are designed to support XML format. We provide also CSV and XLS format only to support existing customers, no support will be given to new customers using those formats.

Use

Method Url Format
GET /restful/export/api/products.xml XML format
GET /restful/export/api/products.csv CSV format, Deprecated: provided only to existing customers
GET /restful/export/api/products.xls XLS format, Deprecated: provided only to existing customers

Authentication

Remember to authenticate properly, using HTTP Basic Authentication with your API-Key as username and your password.

Query Params

Name Description Values Mandatory
acceptedlocales Locale code for languages. The comma separated list of values it_IT, en_US, fr_FR... Yes
output-filetype Format of the output data xml Yes
since the timestamp of the last update ISO8601 date format No
tag_1 product's brand Any brand name No
tag_4 product's category “clothing”, “accessories”, “bags”, “cosmetics”, “underwear”, “shoes” No
tag_26 product's gender “kids”, “women”, “unisex”, “men” No
tag_11 product's season “fw” (fall/winter), “ss” (spring/summer), “all-year” No

Response Body (XML Format)

The main tag (page) shows the information about the number of results and the pagination:

This tag (items) contains a collection of items, which show product's informations.

Each tag has many child elements, corresponding to a product's property. The most important ones are:

Each model element has six useful attributes:

A specific model can be identified by it's id or by product code/product id + size + color.

Response Body Example

Request example query: /restful/export/api/products.xml?tag_5=A%20mano&acceptedlocales=en_US

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<page totalPages="4" totalNumberOfElements="345" pageSize="100" lastUpdate="""2017-10- 31T14:05:12.322+01:00""" currentPage="1">
    <query/>
    <items>
        <item xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="product">
            <availability>1</availability>
            <bestTaxable>12.0</bestTaxable>
            <brand>BRAND NAME</brand>
            <code>GD65_CELESTE</code>
            <country_selling_restrictions>
                <country>IT</country>
                [...]
            </country_selling_restrictions>
            <currency>EUR</currency>
            <descriptions>
                <description>
                    <description>
                        PRODUCT DESCRIPTION I18N
                    </description>
                    <localecode>en_US</localecode>
                </description>
                <description> ... </description>
                ...
            </descriptions>
            <id>31741</id>
            <pictures>
                <image>
                    <id>111695</id>
                    <url>/prod/stock_prod31741_image_1412490303.jpg</url>
                </image>
                <image> ... </image>
                ...
            </pictures>
            <intra>42022100</intra>
            <models>
                <model>
                    <availability>1</availability>
                    <barcode>00000000</barcode>
                    <code>GD065_CELESTE</code>
                    <color>#000000</color>
                    <id>100617</id>
                    <lastUpdate>2017-10-31T14:24:55.048+01:00</lastUpdate>
                    <model>MODEL NAME</model>
                    <size>SIZE</size>
                    <streetPrice>75.0</streetPrice>
                    <taxable>12.0</taxable>
                </model>
                <model>...</model>
                    ...
            </models>
            <name>Borse</name>
            <online>true</online>
            <streetPrice>75.0</streetPrice>
            <tags>
                <tag>
                    <hidden>false</hidden>
                    <id>1</id>
                    <name>brand</name>
                    <priority>0</priority>
                    <translations>
                        <translation>
                            <description>Firme</description>
                            <localecode>it_IT</localecode>
                        </translation>
                    </translations>
                    <value>
                        <translations>
                            <translation>
                                <description>Borse</description>
                                <localecode>it_IT</localecode>
                            </translation>
                        </translation>
                        <value>Prada</value>
                    </value>
                </tag>
                <tag>...</tag>
                    ...
            </tags>
            <taxable>12.0</taxable>
            <weight>4.0</weight>
        </item>
        <item xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="product">...</item>
            ...
    </items>
</page>

Incremental updates(XML format)

Once you download the whole catalog, you can ask for updates only. The “since” query parameter is used to ask for quantity modifications after a given timestamp. The last update timestamp is retrieved from the “lastUpdate” attribute of the XML “page” tag.

Pay attention: