Skip to content

Product Groups

https://{cluster-id}.api.esales.apptus.cloud/api/admin/v3/export/product-groups

GET

An export of the product data in Elevate 4 as a json object.

Request

Header parameters

Name Description Example
Api-Key
Required
Api-key that was supplied during on-boarding pkA123456789AB1BE..
Accept-Encoding
Required
Allows responses to be compressed using Gzip. gzip

Query parameters

Name Description Example
market
Required
The visitor market identifier. Must match the corresponding market identifier in the data feed. UK
limit The number of product groups to include. If parameter is omitted, all product groups will be returned. 10
locale The visitor locale. Must match an available locale identifier on the current market in the data feed. en-UK
productRules Filter which products should be returned. rule incl product_key {"pk1" "pk2"}
curl -i \
-X GET \
-H 'Api-Key: pkA123456789AB1BE..' \
-H 'Accept-Encoding: gzip' \
"https://{cluster-id}.api.esales.apptus.cloud/api/admin/v3/export/product-groups?market=UK&limit=10&locale=en-UK&productRules=rule+incl+product_key+%7B%22pk1%22+%22pk2%22%7D"

Response

Response codes

Status Description
200 Query accepted. The data will be returned as an application/json-object.
403 Incorrect cluster credentials.
404 Cluster not found.
406 No acceptable encoding found in Accept-Encoding header.
500 Server error such as cluster unavailable, busy or internal error. If 5xx errors persist, contact support and attach any information found in the response body.

Response body

Example
application/json;chraset=UTF-8
{
  "market" : "se",
  "locale" : "sv-SE",
  "productGroups" : [ {
    "key" : "pg1",
    "brand" : "Box Boss",
    "department" : "Home",
    "suppressDuplicates" : false,
    "products" : [ {
      "key" : "1",
      "title" : "Basic storage box",
      "url" : "/home/storage/products/1",
      "description" : "A box for storing smaller items",
      "images" : [ {
        "typeOverride" : "misc",
        "tags" : [ "First" ],
        "custom" : [ {
          "monochrome" : "false"
        } ],
        "urls" : [ {
          "url" : "https://path/to/image",
          "width" : 800,
          "height" : 600
        } ]
      } ],
      "custom" : {
        "dimension" : [ {
          "id" : "30x20x20",
          "label" : "30x20x20"
        } ]
      },
      "variants" : [ {
        "key" : "1_0",
        "cost" : 50.0,
        "listPrice" : 100.0,
        "sellingPrice" : 75.0,
        "sizes" : [ {
          "size" : "30x20x20"
        } ],
        "stockNumber" : 5,
        "stores" : [ {
          "key" : "Store",
          "stockNumber" : 3
        } ],
        "customPrices" : [ {
          "id" : "EUR",
          "listPrice" : "10.0",
          "sellingPrice" : "10.0"
        } ],
        "custom" : {
          "rim_material" : [ {
            "id" : "a1",
            "label" : "plastic"
          } ]
        }
      } ]
    } ]
  } ]
}
×
Copyright

This online publication is intellectual property of Voyado Lund AB. Its contents can be duplicated in part or whole, provided that a copyright label is visibly located on each copy and the copy is used in conjunction with the product described within this document.

All information found in these documents has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Voyado Lund AB nor the authors shall be held liable for possible errors or the consequences thereof.

Software and hardware descriptions cited in these documents might be registered trademarks. All trade names are subject to copyright restrictions and may be registered trademarks. Voyado Lund AB essentially adheres to the manufacturer’s spelling. Names of products and trademarks appearing in this document, with or without specific notation, are likewise subject to trademark and trade protection laws and may thus fall under copyright restrictions.

CLOSE