Publisher API Widget online!

We would like to proudly announce the new Publisher API Widget. You are now able to search and test our Publisher API online without having to implement the OATH 1.0 protokoll.
You will only need to enter your zanox Connect ID and the provided Secret Key. Your credentials can be found on the zanox marketplace under Links & Tools > Getting Started or here
Please Select a URL resource you want to request. Please keep in mind that we are only able to request GET URLs because the widget works on live data. To view more information on the URL resource, visit the corresponding page on the documentation pages in the developer portal. An overview can be found here.
The Api Widget is available here: 

Retiring zanox product category tree

With merchant category filters now active in our product search API, we will be discontinuing our old zanox product category tree and the related API filter on January 1st, 2014.


First, a bit of background on how current categorisation works. Products are assigned to a zanox category automatically, using a machine-learning algorithm, which makes this decision based on keywords in the product name, description and other fields. This approach allows us to categorise products independently of how much information is provided and does not force merchants to adopt (or map to) the zanox category tree. But as with all machine-learning algorithms - it is not perfect, especially when it comes to recognising same items in different languages or spotting a difference between a real item and its accessory (e.g. iPad and iPad case).

Changes and solutions

To address these shortcomings, we have already introduced result filtering by merchant categories and today we are announcing discontinuation of the current zanox product categorisation. Existing clients will continue working without changes until the 1st of January 2014. After that, queries using the old category IDs will return an empty resultset without errors. 

We advise you to rely on search keywords and merchant categories if you need better filtering.

EAN and merchant category filters in the product search API

As the beta phase of the new product search aproaches the end, we continue rolling out the features. Today, we are happy to present you two latest additions to the API interface - the EAN and the merchant category filters.

EAN filter

You can now search for products using the unique international article number - the EAN. It's a great filter for all those barcode scanner applications, which don't have any other keywords to use. EAN can be passed as a query parameter and will limit the results to matching products only. Even though EAN uniquely identifies a product, it is possible that you will get multiple results if several merchants have the same item for sale. Here's an example request to find the Galaxy Note 10.1 (ean 8806085308091):[...]&ean=8806085308091

Response contains two products from different merchants (cropped for readability):

<productItem id="b3d8b8ac4dd085a5b7a239b61ce5beb6">
    <name>Samsung Galaxy Note 10.1 WiFi TM 16GB white (GT-N8020ZWADBT)</name>
    <category id="7000000">Computers & Software</category>
    <merchantCategory>Computer + Büro</merchantCategory>
<productItem id="9cf344f049b0289e5016dff4262b75ff">
    <name>Samsung Galaxy Note 10.1 N8020 LTE white</name>

Please note that not all merchants provide EANs for their product data feeds, therefore not all products in our database can be found using their article number.

Merchant category filter

Most shops use their own category tree to organize products. They are different from merchant to merchant, but make good and reliable search criteria if you want to get the best possible search result for a specific merchant. We are therefore adding the functionality to filter products by the merchant category or several categories. Like EAN, merchant category can be passed via REST URL query parameter. You can also pass multiple categories, from the same or different merchants by repeating the query parameter. For example, if you wanted to search for Samsung tablets and notebook PCs, you could formulate a query like this:[...]&merchantcategory=Tablets&merchantcategory=Notebooks&q=samsung

It returns multiple products from both categories, two of which you can see below (cropped for readability):

<productItem id="92544ec116ba54cf87175675521e88a4">
    <name>Samsung Notebook NP370R5E-S01CH</name>
<productItem id="e1cb94e83497cf8c11760871c56847bf">
    <name>Samsung Galaxy TAB2 7.0” WIFI 8GB</name>

We will be extending our API in the near future to allow you to download merchant-defined category trees, in order to enable you to use the full potential of this feature.

Both of the new filters are also documented in the Publisher API 2011 reference.


Updated: retrieving all merchant's categories

We have also added an API resource that returns all product categories for a selected merchant. For example you can get categories for EU (ID 13299) like this:

Response at the time of writing is (cropped for readability):

        <category>Women / Necklaces</category>
        <category>Home / Unframed Prints</category>
        <category>Home / Workspace</category>
        <category>Home / Kitchen Tools</category>
        <category>Home / Bed Linens</category>
        <category>Home / Serveware</category>
        <category>Women / Watches</category>
        <category>Women / Bangles</category>

Currently we have identified a few programs that provide low quality category data or do not provide it at all. Therefore this resource will not return categories where it detects that data is not correct. We will be working with advertisers to improve EAN and category data quality over time.

New in the REST API: sales basket items

We are happy to present you the latest addition to our API resource family - the sale basket. As you might know a single sale can contain multiple products, which can belong to different categories and have different commissions. While the Publisher API has always had a resource to get sales or an individual sale, the response included an undefined commission and a "basket" as tracking category in case of multiple products in a single sale.

To cover this gap, we now introduce a new basket resource, which, among other properties, returns products in the sale basket, their respective tracking categories and commissions. A basket item looks like this:

   <productName>Apple iPad 4</productName>

To get the basket, you will have to provide the sale ID as a REST URL path parameter. Sale IDs are returned by the aforementioned sales resource. The basket resource is protected, so you will need to generate the zanox OAuth signature as described in the authentication documentation. This functionality is implemented in REST API only, with the usual XML or JSON response formats to choose from.

For more information, please refer to the sales basket documentation page.

Maintenance work on 19th/20th and 26th/27th October 2013

There is an announcement on the main zanox blog, about maintenance work that we will be carrying out over the last two weekends of October. I wanted to make it a bit more transparent on the developer blog about what effect this will have on our APIs.

Publisher and Connect APIs

Due to maintenance, we are going to set these APIs into read only mode for a couple of hours on the first weekend and if necessary, on the second weekend as well. For all you Publisher REST API users, this means that POST, PUT and DELETE requests will be returning HTTP 503 - Service unavailable. Publisher SOAP API will also deny all create, update and delete operations returning an HTTP 503 too.
The Connect SOAP API will deny promoting and closing sessions, creating new connects and getting UI URL.

All Publisher REST API GET methods and SOAP API get* operations will continue to work as expected. The essential for apps "getSession" and "getOfflineSession" in the Connect SOAP API will not be affected either.

Data API

Data API is not affected.


Unfortunately, access to the ERP API will have to be blocked during maintenance - you will not be able to log into the service.

Please note, that no data will be lost during the maintenance, and you will be able to catch up with your retrieve, update and create requests after the maintenance window.