shopping24 documentation

s is for shopping

API export

Use this API endpoint to do an export of products. The usage of this endpoint is a lot faster than iterating over the data set by increasing the page number using the search or products endpoint. However, products will be returned in a random order. You can fetch a given amount of products and iterate over the whole set of products by submitting a cursor. By default you get an amount of 40 products and start without submitting a cursor value.

GET /v3/:appid/export

When submitting a parameter pageElements, you can define the amount of products to be returned. A maximum of 10.000 is allowed.

GET /v3/:appid/export?pageElements=:count

To get the next products use the link with rel=”next” from response. There we add an URL with the cursor value for the next products and the given value for pageElements. The cursor represents the start position for the next iteration, but don’t depends on the pageElements parameter. If you want to, you can always change the pageElements value during iteration.

If no link with rel=”next” (or the whole “links” tag is missing) is delivered in response, the end of iteration is reached.

Since we support iteration just by cursor, the page parameter is ignored and always set to “-1”.

In some cases the response can be empty, notably if the last products fitted completely in previous response.

It is also possible to export the list of products as CSV file. Preferably, we will grant you access to our FTP server from which you can download the file(s). They are updated multiple times a day and you have many more configuration and filter options, see also FAQ section for details.

<ns3:category xmlns:ns2="http://api.s24.com/v3/1.0/common" 
      xmlns:ns3="http://api.s24.com/v3/1.0/products" 
      count="825772" id="27165">
<products xmlns:ns2="http://api.s24.com/v3/1.0/products" xmlns:ns3="http://api.s24.com/v3/1.0/common" size="40" totalResults="123456" page="-1" pageElements="40" totalPages="3087">
      
  <product id="1">...</product>
  <product id="2">...</product>
  <product id="3">...</product>
  <link rel="next" href="http://api.../export?pageElements=:count&cursor=:cursor"/>
</products>