NUnumeral-com

Classify Products

Changed on

Suggest a Numeral tax category for up to 20 products from their names and descriptions, using the AI provider keys stored for your account. Optionally create the classified products in one call. Available on API version 2026-01-01 and later.

post/tax/products/classify

Request

Request body

create_productsboolean

When true, every product that classifies successfully is also created with the suggested category, as if sent to POST /tax/products. Products already registered under the same reference_product_id are left unchanged. reference_product_id must then be unique within the batch.

Example request

{
  "products": [
    {
      "reference_product_id": "sku-shirt-001",
      "reference_product_name": "Cotton crew neck t-shirt",
      "reference_product_description": "Unisex short-sleeve shirt, 100% cotton"
    }
  ]
}

Response

One result per input product, in request order

objectstring required

Always list.

create_productsboolean required

Echo of the request's create_products.

testmodeboolean required

true if called with a test API key.

Example response

{
  "object": "list",
  "product_categories": [
    {
      "reference_product_id": "sku-shirt-001",
      "status": "classified",
      "product_category": "CLOTHING_GENERAL",
      "confidence_score": 0.94,
      "product_creation_status": "not_requested"
    }
  ],
  "testmode": true
}

Changes