Skip to main content
PUT
Import and update products
This endpoint imports your products into your Kameleoon account. It’s the preferred method for importing your catalog if you have more than 50K products. Kameleoon recommends using this endpoint to also update the list of products and their properties, rather than fully re-importing your catalog daily.
If you rely entirely on this endpoint to import your catalog, first import all categories using the import categories endpoint. Kameleoon ignores any products without a known category during the import process.
You send the data as a JSON string in the body of the request.

Rate limit

  • Kameleoon sets the API request limit (Rate Limit) at 40 requests per minute, with a maximum of 1 request every 1.5 seconds.
  • Kameleoon caps the API request weight limit (Weight Limit) at 35 megabytes per request.

List of query parameters

The purpose of the webhook is to notify the developer once a request completes. Once Kameleoon imports all products in the API call and they become fully available, it sends a POST request to the designated webhook.Example of a successful request:
Example of an unsuccessful request:

List of parameters for items object

To update only certain products, provide all mandatory parameter values for each product in the request. If a product omits any mandatory properties, Kameleoon ignores that product during the import and makes no changes to the database. For example, to update only the price of a product, include all its mandatory parameters, such as categories, name, picture, and available.For non-mandatory properties, Kameleoon removes any omitted values from the database.

List of parameters for locations object

Use the locations object to provide price, inventory, and other location-specific information when you have multiple locations. Pass the locations object inside the product items object.

List of parameters for delivery_types object

List of parameters for Params object

The params object allows you to specify custom parameter values for the item. Pass the params object inside the product items object.

List of parameters for Fashion object

The fashion object allows you to specify additional information about fashion items. Pass the fashion object inside the product items object.

Example JSON request

Body

application/json
shop_id
string
required

Store Key. Find this in Recommendations > Settings > Store settings in the Kameleoon app. Contact your Customer Success Manager for the key if necessary.

shop_secret
string
required

Secret Key. Find this in Recommendations > Settings > Store settings in the Kameleoon app. Contact your Customer Success Manager for the key if necessary.

items
object[]
required

A list of product items. To update only some properties of a product, you must still include all of that product's mandatory parameters, or the product is ignored during import.

webhook
string

The webhook URL where a POST request is sent upon completion of the import.

Response

Import accepted. Verified against a live response on 2026-09-24: this endpoint returns an empty 204 response on success, not a JSON body — the {"status": "success"} shape only applies to the asynchronous webhook callback payload, if a webhook was provided.