Product Classifier API (1.0.0)
Download OpenAPI specification:Download
License: Private
Product Classifier is an API that helps merchants find a category in the Google Product Taxonomy based on a product description.
The API uses AI-powered classification to analyze product descriptions and match them with the most appropriate categories from Google's or Shopify's product taxonomies.
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 Enum: "Google" "Shopify" The product taxonomy to use for classification. If not specified, uses the project's default taxonomy setting. |
Responses
Request samples
- Payload
Content type
application/json
Example
{- "product": "blue cotton t-shirt for men"
}Response samples
- 200
- 400
- 401
- 403
- 413
- 429
- 500
Content type
application/json
Example
{- "success": true,
- "categoryFound": true,
- "categoryId": "1604",
- "categoryPath": "Apparel & Accessories > Clothing > Shirts & Tops",
- "categoryLine": "Apparel & Accessories > Clothing > Shirts & Tops > Shirts",
- "categoryTags": [
- "apparel",
- "clothing",
- "shirts",
- "tops"
]
}