Similar

Get Similar

POST https://api.discoverist.ai/recommend/v1/clients/{client_id}/products/similar

Get 6 Similar Products specific to the Product

Request Body

Name	Type	Description
product_id*	string	Product Id from your Product Catalog
user_id	string	unique user identifer for each user on your website.

200 Get Similar

{
    "results": [
        {
            "id": 7951785263271,
            "name": "Airdog V5 Car Air Purifier",
            "url": "https://cdn.shopify.com/s/files/1/0635/0959/4279/products/car-purifier-1.webp?v=1709604067",
            "price": 99.0,
            "handle": "airdog-v5-car-air-purifier",
            "options": [
                {
                    "name": "Title",
                    "position": 1,
                    "values": [
                        "Default Title"
                    ]
                }
            ],
            "sizes": "Default",
            "variants": [
                {
                    "id": 44802403074215,
                    "product_id": 7951785263271,
                    "title": "Default Title",
                    "price": "99.00",
                    "inventory_policy": "continue",
                    "compare_at_price": "199.00",
                    "option1": "Default Title",
                    "option2": null,
                    "option3": null
                }
            ],
            "images": [],
            "age_group": ""
        },
       ...
    ]
}

401 Error product not found

{
    "error": "No matching document found."
}

curl

curl --location 'https://api.discoverist.ai/recommend/v1/clients/{YOUR_CLIENT_ID}/products/similar' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "product_id": "7951758721191",
    "user_id": "XYZ"
}

Java Script

const apiKey = process.env.REACT_APP_API_KEY || 'YOUR_API_KEY'; // Replace with your actual API key (consider environment variables)
const clientId = 'YOUR_CLIENT_ID'; // Replace with your actual client ID
const url = `https://api.discoverist.ai/recommend/v1/clients/${clientId}/products/similar`;
const headers = {
    'accept': 'application/json',
    'x-api-key': apiKey,
  };
const data = {
  product_id: "242424242",
  user_id: "XYZ"
};
const response = await fetch(url, {
      method: 'GET',
      headers,
      body: JSON.stringify(data),  
    });

Python

import requests
import os
api_key = os.environ.get("YOUR_API_KEY")
client_id = "YOUR_CLIENT_ID"  # Replace with your actual client ID
headers = {
    'accept': 'application/json',
    'x-api-key': YOUR_API_KEY,
}
data = {
    "product_id": "23232323",
    "user_id": "XYZ"
}
url = "https://api.discoverist.ai/recommend/v1/clients/" + client_id + "/products/similar"
response = requests.get(url, headers=headers, json=data, verify=False)