Skip to main content

Products Enrichment API

Overview

The Selectika Products enrichment API helps retailers improve their product data through AI-powered enrichment.
The service processes product details and delivers enhanced data to boost product discoverability and customer experience.
P.S. You can later retrieve all enriched items data with our Auto Tagging API as well.

Authentication

All API requests require authentication using an API key. You can include the API key in either:

  • Query parameter: ?api_key=YOUR_API_KEY
  • HTTP header: api_key: YOUR_API_KEY

Endpoint

POST https://api.selectika.com/v1/enrich_items

Request Format

The request body should be in JSON format with the following structure:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
  "items": [
    {
      "id": "string", // required
      "model_id": "string",
      "url": "string",
      "title": "string",
      "description": "string",
      "images": ["string"], // required
      "stock": number, // 0: out of stock, 1 (default): in stock, 2: archived
      "gender": "string", // required
      "price": "string",
      "salePrice": "string",
      "color": "string",
      "category": "string", // required, most common categories for fashion & home
      "brand": "string"
    }
  ]
}

Required Fields

The following fields are required in each item:

  • id: Unique identifier for the product
  • images: Array of product image URLs
  • gender: any known text to identify gender (woman, female, men, male etc)
  • category: Category name, prefer parent cat (shirts, pants etc)

Best Practices

For optimal results:

  • Include all color and size variants in a single request
  • Provide high-quality product images
  • Include detailed product descriptions when available
  • Ensure all URLs are accessible and valid

Sample Request

Here’s an example of a basic API request: Regarding categories – We accept any category name, but for faster enrichment, it’s best to provide a parent category such as shirts, pants, or dresses.

1
2
3
4
5
6
7
8
9
10
11
12
13
-H "Content-Type: application/json" \
-d '{
  "items": [
    {
      "id": "sample-product-123",
      "title": "Sample Product",
      "color": "Blue",
      "caregory": "shirts",
      "images": ["https://example.com/image.jpg"]
    }
  ]
}'

Response Format

The API returns a JSON response indicating the success status of the enrichment request:

1
2
3
4
5
{
  "success": true,
  "message": "N items queued for priority enrichment",
  "jobId": "aaaaa-bbbbb-ccccc-dddddd-efca919937fe"
}

A successful response indicates that the items were accepted for processing. The actual enrichment process happens asynchronously, and updates are delivered via webhooks if configured.

Webhook Integration

Selectika offers webhook support to receive real-time notifications for each item enrichment events. To set up webhooks:

  • Contact Selectika support to enable webhook integration
  • Provide your webhook URL for receiving notifications

Webhook notifications are sent with the following data structure:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "event": "eventType", // onItemCreated, onItemUpdated, onItemDeleted
  "id": "sample-product-123",
  "jobId": "aaaaa-bbbbb-ccccc-dddddd-efca919937fe",
  "timestamp": "2025-03-03T08:19:14.918Z",
  "changes": {
    "category": "Shirts",
    "features": [
      {
        "name": "ShirtShape",
        "value": "TShirt"
      },
      {
        "name": "BodyFit",
        "value": "Fitted"
      },
      {
        "name": "SleeveShape",
        "value": "Straight"
      },
      // .....
    ]
  }
}

The webhook system allows you to receive immediate updates as items are processed and enriched by our API.

Rate Limits

Please contact Selectika support for information about rate limits and usage quotas for your API key.

Support

For technical support or questions about the API, please contact our support team.