Getting Started

The Product Classifier API automatically categorizes products into standardized taxonomies. Send a product description via HTTP request, and receive the matching category within seconds.

Prerequisites

Before making API requests, you’ll need:

1. A Product Classifier account - Sign up to create one
2. An API key - Generate one from your dashboard

API keys authenticate your requests and track your usage. For details on creating and managing keys, see Managing API Keys.

Authentication

All API requests require authentication using your API key as a Bearer token in the Authorization header:

Authorization: Bearer your_api_key_here

Your First Request

Here’s a complete example that classifies a product:

curl -X POST https://api.productclassifier.com/api/v1/products/categorize \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "Apple iPhone 16 Pro 512GB smartphone with titanium design and A18 chip",
    "taxonomy": "Google"
  }'

Replace your_api_key_here with your actual API key from the dashboard.

Understanding the Response

A successful classification returns JSON with the category information:

{
  "success": true,
  "categoryFound": true,
  "categoryId": "267",
  "categoryPath": "Electronics > Communications > Telephony > Mobile Phones",
  "categoryLine": "267 - Electronics > Communications > Telephony > Mobile Phones",
  "categoryTags": [
    "Electronics",
    "Communications",
    "Telephony",
    "Mobile Phones"
  ],
  "confidenceLevel": "AI"
}

Key fields:

• categoryId: Unique category identifier
• categoryPath: Full hierarchy from root to category
• categoryLine: Combined ID and path
• categoryTags: Array of each level in the hierarchy
• confidenceLevel: Indicates how the category was determined

Next Steps

Now that you’ve made your first request:

• Making API Requests - Learn about all available parameters, request options, and response fields
• Managing API Keys - Create additional keys, rotate credentials, and manage permissions
• Rate Limits & Usage Quotas - Understand your plan’s limits and credit consumption
• Error Handling and Response Codes - Troubleshoot issues and handle errors gracefully

For testing and experimentation before writing code, try the Playground - a web interface for instant classification without API integration.