Overview

Selectika is a cutting-edge recommendation engine platform designed for e-commerce fashion retailers. By leveraging advanced algorithms and deep learning, Selectika enhances online shopping experiences through personalized product recommendations. Our solutions help increase customer engagement, boost sales, and improve overall satisfaction.

Visit our website: https://www.selectika.com/

Authentication

All API requests require authentication using an API key provided by Selectika.

How to Authenticate:

Include the API key in the request header as follows:

api_key: YOUR_API_KEY

API Key Request: To obtain your API key, please contact Selectika support at support@selectika.com.

API Endpoints

Base URL for all requests:

https://api.selectika.com/v1

Note: Before you can receive recommendations, Selectika needs to ingest your catalog feed. Please provide your product catalog to ensure accurate and effective recommendations.

Common Query Parameter

• item_id (string, required): The unique identifier of the item for which you are requesting recommendations.

Response Structure

All responses will return a JSON object containing:

• status (string): The status of the request (e.g., “success”, “error”).
• items (array): A list of recommended items.
  • Each item in the array includes:
    • item_id (string): Selectika’s internal item ID.
    • retailer_item_id (string): Your internal item ID as provided in the catalog.
    • thumbnail_url (string): URL to the item’s thumbnail image.
    • item_name (string): The name of the item.

---

1. Shop Similar

Endpoint:

**HTTP GET** /shop_similar/{itemID}

Description:

Provides a list of items similar to the specified item_id on URL path.

Request Example:

HTTP GET <https://api.selectika.com/v1/shop_similar/12345> HTTP/1.1
api_key: YOUR_API_KEY

Response Example:

{
  "status": "success",
  "items": [
    {
      "item_id": "67890",
      "retailer_item_id": "ABC123",
      "thumbnail_url": "<https://yourstore.com/images/ABC123_thumb.jpg>",
      "item_name": "Stylish Denim Jeans"
    },
    {
      "item_id": "67891",
      "retailer_item_id": "DEF456",
      "thumbnail_url": "<https://yourstore.com/images/DEF456_thumb.jpg>",
      "item_name": "Classic Blue Jeans"
    }
    // Additional items...
  ]
}

---

2. Complete the Look

Endpoint:

**HTTP GET** /complete_the_look/{itemID}
api_key: YOUR_API_KEY

Description:

Recommends items that complement the specified item_id on URL path to complete an outfit.

Request Example:

HTTP GET <https://api.selectika.com/v1/complete_the_look/12345> HTTP/1.1
api_key: YOUR_API_KEY

Response Example:

{
  "status": "success",
  "items": [
    {
      "item_id": "67892",
      "retailer_item_id": "GHI789",
      "thumbnail_url": "<https://yourstore.com/images/GHI789_thumb.jpg>",
      "item_name": "Leather Belt"
    },
    {
      "item_id": "67893",
      "retailer_item_id": "JKL012",
      "thumbnail_url": "<https://yourstore.com/images/JKL012_thumb.jpg>",
      "item_name": "Casual Sneakers"
    }
    // Additional items...
  ]
}

---

3. Shop the Look

Endpoint:

**HTTP GET** /shop_the_look/{itemID}
api_key: YOUR_API_KEY

Description:

Identifies and recommends other items found in the product image of the specified item_id that are available in your catalog.

Request Example:

HTTP GET <https://api.selectika.com/v1/shop_the_look/12345> HTTP/1.1
api_key: YOUR_API_KEY

Response Example:

{
  "status": "success",
  "items": [
    {
      "item_id": "67894",
      "retailer_item_id": "MNO345",
      "thumbnail_url": "<https://yourstore.com/images/MNO345_thumb.jpg>",
      "item_name": "White T-Shirt"
    },
    {
      "item_id": "67895",
      "retailer_item_id": "PQR678",
      "thumbnail_url": "<https://yourstore.com/images/PQR678_thumb.jpg>",
      "item_name": "Baseball Cap"
    }
    // Additional items...
  ]
}