Skip to main content

Import categories

This endpoint imports all of your product categories into Kameleoon.

HTTP Request

POST https://api.products.kameleoon.com/import/categories

Before uploading products, it is necessary to upload an up-to-date list of categories into our database. The data is sent as a JSON string that includes the body of the request. You must send all categories in a single request.

Query parameters

ParameterRequiredDescription
shop_idRequiredYour Store Key. You can find this in Recommendations > Settings > Store settings in the Kameleoon app. You can also contact your Customer Success Manager for the key.
shop_secretRequiredYour Secret Key. You can find this in Recommendations > Settings > Store settings in the Kameleoon app. You can also contact your Customer Success Manager for the key.
categoriesRequiredA list of category objects. Each category object contains the following:
  • id: String. A unique ID for the category. This field is required.
  • name: String. The name of the category. This field is required.
  • parent: String or null. If categories are hierarchical, this field defines a parent for this category. This field is optional.
  • url: String. A URL to associate with the category. This field is optional.
  • alias: String. An alias for the category. This field is optional

Example JSON request

{
"shop_id": "eehj3eu84299kg5ghw5a6743r8",
"shop_secret": "pmd5362597thrgq8k256ep01t0",
"categories": [ {
"id": "footwearID",
"name": "footwear",
"url": "https://example.com/footwear",
"alias": "kicks"
},
{
"id": "shoesID",
"name": "shoes",
"parent": "footwearID",
},
{
"id": "bootsID",
"name": "boots",
"parent": "footwearID",
}, ]
}