DocumentationAPIManaging API Keys

Managing API Keys

API keys authenticate requests to the Product Classifier API. Each key is a Bearer token that identifies your account and tracks usage.

Authentication

All API requests require a valid API key in the Authorization header:

Authorization: Bearer your_api_key_here

Each classification request deducts one credit from your account balance.

Creating an API Key

Navigate to Categorization / API keys in your dashboard and click Generate new.

Provide a name to identify the key’s purpose. The system generates a random API key automatically.

Important: The full API key is only displayed once. Copy it immediately after creation. If lost, delete the key and create a new one.

Limits

Maximum of 3 active API keys per account. Contact support@productclassifier.com if you need more.

Deleting an API Key

Delete keys from the Categorization / API keys page. Deletion immediately revokes access—requests using that key will return 401 errors.

Testing Your Connection

Test your API key with a classification request:

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

Security Best Practices

Rotate Keys Regularly

Rotate production keys periodically. Create a new key, update your application configuration, verify, then delete the old key.

Use Different Keys for Different Environments

Use separate keys for production, staging, and development environments. This isolates potential compromises to non-production systems.

Monitor Key Usage

Monitor API usage in your dashboard. Unexpected activity may indicate a compromised key.

Next Steps

Getting StartedMaking API Requests