pro

productcategorization

npm i productcategorization

Readme

Product Categorization API for Node.js

Product Categorization API is a Node.js module that uses text classification ML model to classify texts into Ecommerce based categories.

It supports three Tiers or depth levels of categorization.

Tier 1 categories include:

  • Toys & Games
  • Vehicles & Parts
  • Arts & Entertainment
  • Apparel & Accessories
  • Baby & Toddler
  • Media
  • Hardware
  • Home & Garden
  • Electronics
  • Office Supplies
  • Furniture
  • Sporting Goods
  • Health & Beauty
  • Food, Beverages & Tobacco
  • Animals & Pet Supplies
  • Business & Industrial
  • Mature
  • Cameras & Optics
  • Religious & Ceremonial
  • Software
  • Luggage & Bags

Tier 2 includes 186 categories, whereas Tier 3 supports classification into one of possible 1113 categories.

Installation

npm i productcategorization

Usage example

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://www.productcategorization.com/api/iab/gpt_category2.php',
  'headers': {
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  form: {
    'query': 'audi car'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Usage of product categorization

Product categorization is primarily used in online stores, to provide more detailed categorization of stores products, which leads to better searchability, filtering and improved conversions of the online store. Product categorization API can also be used in other settings, e.g. as part of internal or external apps/Saas websites.

The process of categorizing products is usually automated, using a machine learning model, due to sheer number of products that are available on online stores. E.g. Amazon sells more than 12 million products and if including Amazon Marketplace sellers, the number of products sold is over 300 million.

You can learn more about other use cases in this in-depth guide on product categorization.

If interested in possible product categories that one can use in this kind of classification, check out the taxonomy from Google: https://www.google.com/basepages/producttype/taxonomy.en-US.txt.

If you are looking for a free tool for ecommerce categorizations, check out this free tool for categorizing products, which is the base of this API service.

Usage in online dashboard

The API service also has an online dashboard version, which may be sometimes more conveninent and quicker than usage of API.

Here is an example screenshot:

image

Form of json

Example output from Product Categorization API for "online puzzle":

{
  "classification": [
    {
      "category": "Toys & Games",
      "value": 0.9638764770961815
    },
    {
      "category": "Baby & Toddler",
      "value": 0.035059565554713144
    },
    {
      "category": "Home & Garden",
      "value": 0.0002963369659567312
    },
    {
      "category": "Sporting Goods",
      "value": 0.00023261258646299374
    },
    {
      "category": "Apparel & Accessories",
      "value": 0.0002154233610409791
    },
    {
      "category": "Arts & Entertainment",
      "value": 0.00006532454044944747
    },
    {
      "category": "Animals & Pet Supplies",
      "value": 0.000059422859421801474
    },
    {
      "category": "Food, Beverages & Tobacco",
      "value": 0.00002773526129753021
    },
    {
      "category": "Hardware",
      "value": 0.00002505846630513308
    },
    {
      "category": "Vehicles & Parts",
      "value": 0.000021958370880675152
    },
    {
      "category": "Office Supplies",
      "value": 0.00001764502356391286
    },
    {
      "category": "Software",
      "value": 0.000016447423481062168
    },
    {
      "category": "Electronics",
      "value": 0.000016334880730325363
    },
    {
      "category": "Luggage & Bags",
      "value": 0.00001318376032711391
    },
    {
      "category": "Business & Industrial",
      "value": 0.000012255740845011877
    },
    {
      "category": "Health & Beauty",
      "value": 0.000011468345231805086
    },
    {
      "category": "Mature",
      "value": 0.000009977075952148216
    },
    {
      "category": "Furniture",
      "value": 0.000008364040734807803
    },
    {
      "category": "Religious & Ceremonial",
      "value": 0.0000053440428514067635
    },
    {
      "category": "Media",
      "value": 0.0000046483939975945625
    },
    {
      "category": "Cameras & Optics",
      "value": 0.00000441620957481985
    }
  ],
  "language": "en"
}

Language support

API service accepts texts not only in English, but many other languages, including German, Italian, Spanish, Dutch, French and others.

Useful resources

Jump To