README

Ecommerce Product Categorization API for PHP

🛒 Categorize products using AI - generates relevant category matches with scores

Check the full documentation on the Ecommerce Product Categorization API for PHP API page.

Quick Links

Requirements

• PHP >= 8.0

Installation

Step 1. Install the package via Composer:

composer require sharpapi/php-ecommerce-product-categorization

Step 2. Visit SharpAPI to get your API key.

Laravel Integration

Building a Laravel application? Check the Laravel package version for better integration.

What it does

Categorize products using AI - generates relevant category matches with scores

Usage

<?php

require __DIR__ . '/vendor/autoload.php';

use SharpAPI\EcommerceProductCategories\ProductCategorizationClient;
use GuzzleHttp\Exception\GuzzleException;

$apiKey = 'your_api_key_here';
$client = new ProductCategorizationClient(apiKey: $apiKey);

try {
    $statusUrl = $client->categorizeProduct(
        content: 'Your text content here',
        language: 'English'
    );

    // Optional: Configure polling
    $client->setApiJobStatusPollingInterval(10);
    $client->setApiJobStatusPollingWait(180);

    // Fetch results (polls automatically)
    $result = $client->fetchResults($statusUrl);
    $resultData = $result->getResultJson();

    echo $resultData;
} catch (GuzzleException $e) {
    echo "API error: " . $e->getMessage();
}

Example Response

{
    "data": {
        "type": "api_job_result",
        "id": "6d3fec8c-34f8-4071-a5ba-af14910b4d77",
        "attributes": {
            "status": "success",
            "type": "ecommerce_product_categories",
            "result": [
                {
                    "name": "Gaming Laptops",
                    "weight": 10
                },
                {
                    "name": "Razer Laptops",
                    "weight": 10
                },
                {
                    "name": "High-Performance Laptops",
                    "weight": 9.5
                },
                {
                    "name": "Laptops",
                    "weight": 9
                },
                {
                    "name": "Razer Gear",
                    "weight": 8.5
                },
                {
                    "name": "Electronics",
                    "weight": 8
                },
                {
                    "name": "Computers & Accessories",
                    "weight": 7.5
                },
                {
                    "name": "PC Gaming",
                    "weight": 7
                },
                {
                    "name": "Portable Computers",
                    "weight": 6.5
                },
                {
                    "name": "Tech Gadgets",
                    "weight": 6
                }
            ]
        }
    }
}

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• A2Z WEB LTD
• Dawid Makowski
• Boost your PHP AI capabilities!

License

The MIT License (MIT). Please see License File for more information.

Social Media

🚀 For the latest news, tutorials, and case studies, don't forget to follow us on:

• SharpAPI X (formerly Twitter)
• SharpAPI YouTube
• SharpAPI Vimeo
• SharpAPI LinkedIn
• SharpAPI Facebook