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 productimages
: Array of product image URLsgender
: 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" , } ] }' |
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.