Back to Main Website
API docs by Redocly

Product Classifier API (1.0.0)

Download OpenAPI specification:Download

Product Classifier support: support@productclassifier.com License: Private

Product Classifier is an AI-powered API that categorizes products from descriptions, matching them to the most relevant category in either Shopify’s or Google’s product taxonomy.

Categorize a product

Classifies a product based on its description using AI-powered analysis and vector search through product taxonomies.

The API returns the most relevant category match along with category metadata such as ID, path, and tags.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
product
required
string <= 2048 characters

The product description to classify

taxonomy
string
Default: "Shopify"
Enum: "Google" "Shopify"

The product taxonomy to use for classification. Defaults to Shopify if not specified.

customInstructionsForAi
string <= 2048 characters
Default: null

Custom instructions for AI processing

leafsOnly
boolean
Default: false

Whether to return only leaf categories

Responses

Request samples

Content type
application/json
Example
{
  • "product": "blue cotton t-shirt for men",
  • "customInstructionsForAi": "Focus on material and style",
  • "leafsOnly": false
}

Response samples

Content type
application/json
Example
{
  • "success": true,
  • "categoryFound": true,
  • "categoryId": "212",
  • "categoryPath": "Apparel & Accessories > Clothing > Shirts & Tops",
  • "categoryLine": "212 - Apparel & Accessories > Clothing > Shirts & Tops > Shirts",
  • "categoryTags": [
    ]
}