npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

productcategorization

v1.0.15

Published

Updated: October 12, 2024

Downloads

53

Readme

Product Categorization API for Node.js

Updated: October 12, 2024

This is a Node.js module that uses text classification ML model to classify texts into Ecommerce based categories, using a product categorization API service.

It supports a wide array of different taxonomies of definitions of categories.

First is the Google Shopping taxonomy with around 5600 categories, you can find them here: https://www.google.com/basepages/producttype/taxonomy.en-US.txt

Categories are in form of Tiers or levels of depth.

E.g. 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

There are other, higher Tiers which cover increasingly more detail.

In addition to Google Shopping, our service provides custom support for 100+ other marketplaces, including eBay. If you have your own definition of categories that are different from the standard ones, we can set up a product categorization AI model for these as well.

In addition to categories, we also return 10 buyer personas that are most relevant for given product.

For example, for product pgytech mavic mini mini uv filter professional we return category "Cameras & Optics > Camera & Optic Accessories > Camera Lens Accessories > Lens Filters" and these buyer personas:

  • Travel Enthusiast

  • Sports Event Participant

  • Street Style Aficionado

  • Professional Photographer

  • Outdoor Adventure Enthusiast

  • Documentary Filmmaker

  • Astronomy Enthusiast

  • Underwater Capture Specialist

  • Wildlife Enthusiast

  • Wedding Planner

Installation

npm i productcategorization

Usage example

const apiBaseUrl = "https://www.productcategorization.com/api/ecommerce/ecommerce_category6_get.php?";
const api_Key = "your api key";
const query = "macbook air";

const encodedQueryText = encodeURIComponent(query);
const finalUrl = `${apiBaseUrl}query=${encodedQueryText}&api_key=${api_Key}`;

fetch(finalUrl)
.then(response => response.text())
.then(data => {
console.log(data);
})
.catch((error) => console.error('Error:', error)); 

Above request will return this:

{"language": "en", "total_credits": 12, "remaining_credits": 12, "classification": "Electronics > Computers > Laptops", "buyer_personas": ["Home Office Enthusiast", "Budget Conscious Individual", "Academic Researcher", "High-End Gamer", "Small Business Professional", "Professional Designer", "Tech Savvy Individual", "Software Developer", "Casual Lifestyle Enthusiast", "Digital Nomad"], "category": "Electronics > Computers > Laptops", "status": 200}

Usage of product categorization AI

Product categorization AI 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 detailed article on product categorization AI.

What are the benefits of product categorization

Product categorization API provide many benefits:

  1. Improved Search Experience One of the primary applications of product categorization is to enhance the search experience for customers. With well-organized categories, shoppers can easily navigate through your product range, finding what they need quickly and effortlessly. This streamlined process reduces the time spent searching and increases the likelihood of a successful purchase. Without product categorization, customers may get frustrated, leading to lower conversion rates and reduced customer satisfaction. Additionally, a well-structured categorization system can help customers discover related products they might not have initially considered, potentially increasing sales and customer engagement.

  2. Personalized Recommendations Product categorization enables advanced algorithms to generate personalized product recommendations. By understanding which categories a customer frequently shops in, you can provide tailored suggestions that are more likely to result in a purchase. This tactic can significantly boost your average order value and increase customer loyalty. Moreover, personalized recommendations based on product categories can help cross-sell and upsell related items, further enhancing the shopping experience and increasing revenue. By analyzing customer behavior within specific categories, businesses can also identify trends and preferences, allowing for more accurate and effective recommendation strategies.

  3. Enhanced SEO Performance Product categorization also helps improve SEO performance. By using appropriate keywords in your product categories, you can improve your visibility on search engines, driving more organic traffic to your online store. Well-structured categories can also contribute to better site architecture, making it easier for search engine crawlers to index your pages. This improved indexing can lead to higher rankings for category-specific searches, potentially attracting more targeted traffic to your site. Furthermore, category pages can serve as valuable landing pages for long-tail keywords, capturing more specific search queries and improving overall search visibility.

  4. Simplified Inventory Management For businesses, product categorization can simplify inventory management. By grouping similar products together, retailers can gain a clearer view of their stock levels and better manage supply and demand. This organization allows for more efficient restocking processes and helps identify slow-moving items within specific categories. Additionally, categorization can facilitate better forecasting of inventory needs based on category-specific trends and seasonality. This improved inventory management can lead to reduced carrying costs, minimized stockouts, and optimized cash flow.

  5. Easier Comparative Shopping Categorizing products allows customers to engage in comparative shopping easily. When similar products are grouped together, customers can compare features, prices, and reviews side-by-side, helping them make informed purchase decisions. This transparency can increase customer trust and satisfaction, as they feel empowered to choose the best product for their needs. Moreover, by facilitating easy comparisons, businesses can highlight the unique selling points of their products within each category, potentially increasing conversions for higher-value or premium items.

Buyer personas can provide the following benefits:

  1. Advanced Customer Profiling Every purchase on your site provides valuable data points. By linking products to specific buyer personas, you can create dynamic customer profiles based on their interactions. For instance, a customer might be categorized as 54% 'Eco-Conscious Shopper', 24% 'Tech-Savvy Professional', 22% 'Budget-Conscious Student', and 8% 'Digital Photographer'. This detailed insight is invaluable for marketers and enables highly targeted future interactions.

  2. Tailored Product Descriptions Understanding a user's buyer persona profile allows for customized product descriptions. For example, an "Eco-Conscious Shopper" might see a description highlighting a product's sustainability features: "Made from recycled materials, 100% recyclable, and produced in a factory using only renewable energy sources." This personalization increases product resonance and potentially boosts conversions and sales.

Our free demo showcases this capability. Simply input any product description, and our AI service will identify relevant buyer personas and generate tailored descriptions for each.

  1. Enhanced Product Recommendations A clear understanding of a customer's persona alignment enables more accurate and appealing product recommendations, increasing the likelihood of additional purchases.

  2. Efficient Inventory Management Knowing your customers' most common buyer personas helps anticipate product demand, informing stock purchasing decisions and reducing the risk of over or understocking.

  3. Optimized Pricing Strategies Insights into the budget constraints and spending habits of your buyer personas allow for tailored pricing and discount strategies, maximizing revenue and profitability.

  4. Improved User Experience Buyer personas can inform website design, resulting in a more intuitive shopping experience. This might include personalized landing pages or navigation paths for different personas.

  5. Informed Product Development Understanding your buyer personas' needs and preferences helps identify gaps in your product range and develop new products aligned with customer desires.

  6. Data-Driven Decision Making Implementing buyer personas for individual products provides rich, actionable data, enabling strategic decisions based on actual customer behavior rather than assumptions.

  7. Increased Customer Loyalty Personalization driven by buyer personas demonstrates that you understand and value customers' unique needs, potentially increasing satisfaction and loyalty.

  8. Competitive Edge In a crowded online marketplace, offering a personalized shopping experience sets your store apart. Effective use of buyer personas can provide a level of service that competitors may struggle to match.

543

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

Our package is available on these websites