Appearance
AskLilySearch
Home

ENRICHMENT API

Submit products for enrichment.

Send product data and accessible image URLs for asynchronous processing.

On this page

Endpoint

POST https://api.selectika.com/v1/enrich_items
api_key: YOUR_API_KEY
Content-Type: application/json

Required fields

  • id — your unique item identifier.
  • images — an array of accessible product-image URLs.
  • gender — a descriptive gender value.
  • category — the category name; a parent category is recommended.

Optional fields

model_id, url, title, description, stock, price, salePrice, color and brand. Stock values: 0 out of stock; 1 in stock (default); 2 archived.

Example payload

Illustrative request. Replace the example identifier and image URL with your catalogue data.

{
  "items": [
    {
      "id": "sample-product-123",
      "images": [
        "https://example.com/product.jpg"
      ],
      "gender": "women",
      "category": "shirts",
      "title": "Sample shirt",
      "stock": 1
    }
  ]
}

What acceptance means

A successful response contains success, message and jobId. It means the items entered the processing queue, not that enrichment has finished. Retrieve the result using the Product Enrichment retrieval API or enable webhook notifications.

Prepare useful inputs

  • Include colour and size variants in a batch.
  • Use high-quality, accessible images.
  • Supply descriptions when available.
  • Confirm rate limits for your API key with Selectika.

Understand the intelligence behind the API

Selectika’s proprietary multimodal fashion intelligence connects imagery and catalogue context with structured attributes and product relationships. Review the technical architecture for the role of expert-reviewed data, vector retrieval and retailer-controlled ranking. The endpoint definitions on this page describe the published integration contract.

Search Selectika

Explore a topic

Meet Lily

Your personal Selectika assistant.