This documentation is generated by Sensefuel.
AI Search & Product Discovery platform that makes ecommerce search personal.

Retrieve recommendations for a given slotId or dynamically

POST

/{siteUUID}/recommendations

Retrieve products recommendations for a given siteUUID

Request

Authorization

API Key

Add parameter in header

X-API-KEY

Example:

X-API-KEY: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200

application/json

The list of recommended products

Body

🟢204

🟠400

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.sensefuel.live/recommend//recommendations' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "slotId": "1fd03219-2f29-4078-be20-7aad951bd70b",
    "userId": "ce1d38aa-07ad-4627-af2a-6735450f3b23"
}'

Response Example

200 - Example 1

{
    "products": [
        {
            "item_group_id": "10535",
            "offset": 0,
            "title": "Mug personnalisable - Supporter depuis toujours",
            "sf:price": 14.99,
            "brand": "My brand",
            "sf:currency": "NOC",
            "sf:isNew": true,
            "price": "14.99",
            "sale_price": "14.99",
            "sf:isPromo": false,
            "description": "PRENEZ VOTRE PETIT DÉJEUNER DE BONNE HUMEUR ! Idéal pour profiter de votre boisson chaude du matin, ou même quelle que soit l'heure de la journée, ce mug personnalisable vous séduira par son élégance.  DÉTAILS PRODUIT  Mug SUPPORTER DEPUIS TOUJOURS Mug en céramique Poignée et intérieur bleu Lavage en machine Hauteur: 96mm  Diamètre: 80mm Volume 375ml Personnalisation : max 12 caractères   Les  produits personnalisables nécessitent une préparation particulière. Merci de compter 2 jours supplémentaires pour la livraison.",
            "sf:previous_price": 14.99,
            "link": "https://www.example.com/product/10535",
            "id": "10535_100748",
            "image_link": "https://www.example.com/product/10535.jpg",
            "availability": "in stock",
            "size": "Unique",
            "color": "Blanc"
        },
        {
            "item_group_id": "11588",
            "offset": 1,
            "title": "Mug 3D OL",
            "sf:price": 12.99,
            "brand": "My brand",
            "sf:currency": "NOC",
            "sf:isNew": true,
            "price": "12.99",
            "sale_price": "12.99",
            "sf:isPromo": false,
            "description": "LE MUG 3D HYPER STYLÉ QUI VOUS PERMET DE VOUS DÉMARQUER Avec son effet 3D du blason, ce mug bleu marine vous rappellera chaque matin pourquoi vous êtes fier d'être un supporter.  DÉTAILS PRODUIT  Un mug en céramique bleu marine. Une contenance de 310 ml. Un diamètre de 8,2 cm. Une hauteur de 9,5 cm. Un marquage du blason en 3D sur une face.  Un marquage en couleur à plat sur l'autre face. ",
            "sf:previous_price": 12.99,
            "link": "https://www.example.com/product/11588",
            "id": "11588_103829",
            "image_link": "https://www.example.com/product/11588.jpg",
            "availability": "in stock",
            "size": "Unique",
            "color": "Bleu"
        }
    ],
    "layout": {
        "titleAlignment": "center",
        "titleColor": "#404040",
        "backgroundColor": "#C3D6FC",
        "backgroundTitle": "Quelques produits similaires",
        "templateType": "LIGHT"
    },
    "details": {
        "configId": "1234567890",
        "slotId": "1234567890",
        "source": "catalog"
    }
}

Documentation