Integration

Data processing workflow

data_workflow

  • Eshop publishes merchant feed

  • We periodically download the feed and precompute results for all services

  • The results are served back to eshop though the API

Interactive OpenAPI docs

  • Visit the Interactive OpenApi specification using the link on top of the page

  • You should see an interactive list of endpoints with basic documentation

  • Don’t forget to “log-in” before trying out requests (details in next section).

Authorization

To authorize your requests inside the interactive docs click the button authorize button placed top right. A modal window with 3 auth fields will pop up. Following sections describe how to fill them for each role.

Technical note: behind the scene the 2nd and 3rd field fill the same Authorization header. They are separated because the former will fill the value through Oauth2 flow - required for admin access. The latter will let you set this header directly as None - required for service access.

Service (read-only)

The most common way of authorization using only api-key.

  • Customer (apiKey)
    • type in your api_key and confirm with “Authorize” button

  • Authorization (OAuth2, implicit)
    • skip, used for admin only

  • None Authorization (apiKey)
    • type in value None and confirm with “Authorize” button

Admin

Not necessary in most cases. Enables modifying data like managing products or images on top of service privileges.

  • Customer (apiKey)
    • type in your api_key and confirm with “Authorize” button

  • Authorization (OAuth2, implicit)
    • use your client_id and click “Authorize” button. It will take you to the cognito login page, where you need to login with your admin credentials to authorize admin access.

  • None Authorization (apiKey)
    • skip, used for service only

Endpoints

Historically there was a lot of endpoints available in our api serving various use cases. Recently, we made an effort to simplify the api for the most common use-cases. The result was CatalogV2 that aggregates all of instyle.ai’s results and merges them with original data from merchant feed.

Catalog V2 Endpoints

swagger

The simplified catalog is represented as hierarchy of three entities

  • product
    • a model grouping all of its variants (colors, sizes, etc.)

    • has one or more looks, and one or more items

    • e.g. Nike Air Max 90 sneakers

  • look
    • variant of the product that is visually distinct

    • has a parent product and one or more items

    • e.g. Nike Air Max 90 sneakers - Black

  • item
    • concrete item that customer can purchase, usually a size variant of look (may include other attributes like condition - used or new)

    • has a parent look and a parent product

    • e.g. Nike Air Max 90 sneakers - Black - size 43

The api endpoints offer flexibility in

  • perspective
    • query products, looks or items

  • get or list
    • get a single entity by id or list through whole catalog

  • entity serializers
    • for each entity set how it will be represented in the response (none, id, expand)
      • none - entity won’t be included

      • id - only id will be included

      • expand - all data stored with this entity will be included

    • choose the least level necessary for each entity so that your response is small

Look results

The catalog endpoints serve both original data and our computed results. Currently our results are only look-related since we are processing the visual information. Therefore, all of our predictions are serialized in a single “results” object under expanded look. Here is simple description of the result fields (refer to example response bellow).

  • related looks: list of recommended look ids for each recommender
    • similarity will recommend visually similar looks (alternatives)

    • style_with will recommend complimentary look ids to form an outfit

  • tags_argmax: the most probable label for each tag, using these labels in eshop filters and search is recommended

  • tags: most probable labels with their likelihoods for each tag

  • tags_hash: save this value to assert if any tags have changed

  • image order: suggested primary image and the second “flip” image for on-hover animation

Examples

Following examples showcase some (not all) of the serializer combinations for single entity (product, look, item) The perspectives and serializers work analogically in list endpoints.

  • product

    • own attributes expanded

      curl -X GET "https://api.instyle.ai/recommendation-api/v2/products/695353?"
      -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
      

      Response

      {
          "product_id": "695353",
          "brand": "Trendyol",
          "category_paths": [
              [
                  "Ženy"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie",
                  "Topy"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie",
                  "Topy",
                  "Body"
              ]
          ],
          "title": "Women's Body Suit Trendyol Shiny",
          "description": "<ul><li> 98% Polyester% 2 Sim </li><li> Model Measurements: Height: 1.78, Chest: 87, Waist: 60, Hip: 89, Size: S / 36/1 </li><li> <a href="http://www..com/Assets/file/Milla_Beden_Tablosu.jpg">Dimension Table</a> </li><li> Our products will be shipped with the TRENDYOL tag. </li></ul>",
          "link": "https://sk.factcool.com/siyah-simli-yaka-dekolteli-body-1788629",
          "google_product_category": "212",
          "google_product_type": "Oblečení a doplňky > Oblečení > Košile a topy",
          "gender": "female",
          "adult": "no",
          "mpn": "1788629"
      }
      
    • fully expanded

      curl -X GET "https://api.instyle.ai/recommendation-api/v2/products/695353?product_serializer=expand&look_serializer=expand&item_serializer=expand"
      -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
      

      Response

      {
          "product_id": "695353",
          "brand": "Trendyol",
          "category_paths": [
              [
                  "Ženy"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie",
                  "Topy"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie",
                  "Topy",
                  "Body"
              ]
          ],
          "title": "Women's Body Suit Trendyol Shiny",
          "description": "<ul><li> 98% Polyester% 2 Sim </li><li> Model Measurements: Height: 1.78, Chest: 87, Waist: 60, Hip: 89, Size: S / 36/1 </li><li> <a href="http://www..com/Assets/file/Milla_Beden_Tablosu.jpg">Dimension Table</a> </li><li> Our products will be shipped with the TRENDYOL tag. </li></ul>",
          "link": "https://sk.factcool.com/siyah-simli-yaka-dekolteli-body-1788629",
          "google_product_category": "212",
          "google_product_type": "Oblečení a doplňky > Oblečení > Košile a topy",
          "gender": "female",
          "adult": "no",
          "mpn": "1788629",
          "looks": [
              {
                  "look_id": "695353",
                  "image_links": [
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_2_org_zoom.jpg",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_4_org_zoom.jpg",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_1_org_zoom.jpg",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_2_org_zoom.jpg",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_3_org_zoom.jpg",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_5_org_zoom.jpg"
                  ],
                  "thumbnail_links": [
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg?impolicy=298x298",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_2_org_zoom.jpg?impolicy=298x298",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_4_org_zoom.jpg?impolicy=298x298",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_1_org_zoom.jpg?impolicy=298x298",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_2_org_zoom.jpg?impolicy=298x298",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_3_org_zoom.jpg?impolicy=298x298",
                      "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_5_org_zoom.jpg?impolicy=298x298"
                  ],
                  "results": {
                      "image_order": null,
                      "related_looks": {
                          "similarity": [
                              "695353",
                              "1648148",
                              "950593",
                              "1648149",
                              "1363674",
                              "1569380",
                              "1527912",
                              "1363302",
                              "951779",
                              "1625158",
                              "1494431",
                              "1444524",
                              "1583439",
                              "1644299",
                              "772169",
                              "1257310",
                              "1662951",
                              "945559",
                              "1362946",
                              "1257309"
                          ],
                          "similarity_b": [
                              "695353",
                              "1648148",
                              "950593",
                              "1648149",
                              "1363674",
                              "1569380",
                              "1527912",
                              "1363302",
                              "951779",
                              "1625158",
                              "1494431",
                              "1444524",
                              "1583439",
                              "1644299",
                              "772169",
                              "1257310",
                              "1662951",
                              "945559",
                              "1362946",
                              "1257309"
                          ],
                          "style-with": [
                              "1325452",
                              "949449",
                              "1259105",
                              "1529549",
                              "1411333",
                              "1476097",
                              "1330948",
                              "1448476",
                              "1330942"
                          ]
                      },
                      "related_outfits": {
                          "shop_the_look": [
                              "female-formal170622676",
                              "female-formal215260645",
                              "female-formal219502837"
                          ]
                      },
                      "tags_hash": "918dc83885335641e3554579eff13b3e",
                      "tags": {
                          "neckline": {
                              "asymmetric": 0.03,
                              "U_neck": 0.21,
                              "V_neck": 0.68,
                              "high": 0.02,
                              "sweetheart": 0.02,
                              "off_shoulder": 0.05
                          },
                          "top_length": {
                              "crop": 0.07,
                              "above_the_hip": 0.89,
                              "below_the_hip": 0.04
                          },
                          "top_fit": {
                              "regular": 0.3,
                              "tight": 0.6,
                              "peplum": 0.09
                          },
                          "top_collar": {
                              "none": 0.73,
                              "shirt": 0.05,
                              "polo": 0.03,
                              "banded": 0.1,
                              "decorated": 0.09
                          },
                          "sleeve": {
                              "zero_sleeve": 0.95,
                              "short": 0.03
                          },
                          "dominant-colors": {
                              "#181819": 0.97,
                              "#3f3d3d": 0.01
                          },
                          "palette-colors": {
                              "#000000": 0.97,
                              "#bebebe": 0.02
                          },
                          "pattern.simple": {
                              "yes": 0.01,
                              "no": 0.99
                          },
                          "pattern.floral": {
                              "no": 1.0
                          },
                          "pattern.other": {
                              "yes": 0.02,
                              "no": 0.98
                          },
                          "pattern.square": {
                              "no": 1.0
                          },
                          "pattern.animal": {
                              "no": 1.0
                          },
                          "pattern.stripes": {
                              "no": 1.0
                          },
                          "pattern.dots": {
                              "yes": 0.97,
                              "no": 0.03
                          },
                          "pattern.logo": {
                              "no": 1.0
                          },
                          "pattern.imageText": {
                              "no": 1.0
                          }
                      },
                      "tags_argmax": {
                          "neckline": "V_neck",
                          "top_length": "above_the_hip",
                          "top_fit": "tight",
                          "top_collar": "none",
                          "sleeve": "zero_sleeve",
                          "dominant-colors": "#181819",
                          "palette-colors": "#000000",
                          "pattern.simple": "no",
                          "pattern.floral": "no",
                          "pattern.other": "no",
                          "pattern.square": "no",
                          "pattern.animal": "no",
                          "pattern.stripes": "no",
                          "pattern.dots": "yes",
                          "pattern.logo": "no",
                          "pattern.imageText": "no"
                      },
                      "color_variant": null
                  },
                  "color": "čierna",
                  "item_group_enabled": "1",
                  "color_group_id": "234157",
                  "image_link_box": "https://i.factcool.com/cache2/410x615/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg",
                  "items": [
                      {
                          "item_id": "695353-4154161",
                          "size": "42",
                          "price": "24.99 EUR",
                          "gtin": "TPRAW18FZ0181R48B34",
                          "condition": "new",
                          "availability": "in stock",
                          "full_id": "234157-695353-4154161",
                          "price_eur": "24.99",
                          "second_price": "33.99 EUR",
                          "second_price_eur": "33.99",
                          "third_price": null,
                          "third_price_eur": null
                      },
                      {
                          "item_id": "695353-4154159",
                          "size": "40",
                          "price": "24.99 EUR",
                          "gtin": "TPRAW18FZ0181R48B30",
                          "condition": "new",
                          "availability": "in stock",
                          "full_id": "234157-695353-4154159",
                          "price_eur": "24.99",
                          "second_price": "33.99 EUR",
                          "second_price_eur": "33.99",
                          "third_price": null,
                          "third_price_eur": null
                      },
                      {
                          "item_id": "695353-4154157",
                          "size": "38",
                          "price": "24.99 EUR",
                          "gtin": "TPRAW18FZ0181R48B26",
                          "condition": "new",
                          "availability": "in stock",
                          "full_id": "234157-695353-4154157",
                          "price_eur": "24.99",
                          "second_price": "33.99 EUR",
                          "second_price_eur": "33.99",
                          "third_price": null,
                          "third_price_eur": null
                      },
                      {
                          "item_id": "695353-4154155",
                          "size": "36",
                          "price": "24.99 EUR",
                          "gtin": "TPRAW18FZ0181R48B22",
                          "condition": "new",
                          "availability": "in stock",
                          "full_id": "234157-695353-4154155",
                          "price_eur": "24.99",
                          "second_price": "33.99 EUR",
                          "second_price_eur": "33.99",
                          "third_price": null,
                          "third_price_eur": null
                      }
                  ]
              }
          ]
      }
      
    • ids only for all entities

      curl -X GET "https://api.instyle.ai/recommendation-api/v2/products/695353?product_serializer=id&look_serializer=id&item_serializer=id"
      -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
      

      Response

      {
          "product_id": "695353",
          "looks": [
              {
                  "look_id": "695353",
                  "items": [
                      {
                          "item_id": "695353-4154161"
                      },
                      {
                          "item_id": "695353-4154159"
                      },
                      {
                          "item_id": "695353-4154157"
                      },
                      {
                          "item_id": "695353-4154155"
                      }
                  ]
              }
          ]
      }
      
  • look

    • own attributes expanded

      curl -X GET "https://api.instyle.ai/recommendation-api/v2/looks/695353?"
      -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
      

      Response

      {
          "look_id": "695353",
          "image_links": [
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_2_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_4_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_1_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_2_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_3_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_5_org_zoom.jpg"
          ],
          "thumbnail_links": [
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_2_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_4_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_1_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_2_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_3_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_5_org_zoom.jpg?impolicy=298x298"
          ],
          "results": {
              "image_order": null,
              "related_looks": {
                  "similarity": [
                      "695353",
                      "1648148",
                      "950593",
                      "1648149",
                      "1363674",
                      "1569380",
                      "1527912",
                      "1363302",
                      "951779",
                      "1625158",
                      "1494431",
                      "1444524",
                      "1583439",
                      "1644299",
                      "772169",
                      "1257310",
                      "1662951",
                      "945559",
                      "1362946",
                      "1257309"
                  ],
                  "similarity_b": [
                      "695353",
                      "1648148",
                      "950593",
                      "1648149",
                      "1363674",
                      "1569380",
                      "1527912",
                      "1363302",
                      "951779",
                      "1625158",
                      "1494431",
                      "1444524",
                      "1583439",
                      "1644299",
                      "772169",
                      "1257310",
                      "1662951",
                      "945559",
                      "1362946",
                      "1257309"
                  ],
                  "style-with": [
                      "1325452",
                      "949449",
                      "1259105",
                      "1529549",
                      "1411333",
                      "1476097",
                      "1330948",
                      "1448476",
                      "1330942"
                  ]
              },
              "related_outfits": {
                  "shop_the_look": [
                      "female-formal170622676",
                      "female-formal215260645",
                      "female-formal219502837"
                  ]
              },
              "tags_hash": "918dc83885335641e3554579eff13b3e",
              "tags": {
                  "neckline": {
                      "asymmetric": 0.03,
                      "U_neck": 0.21,
                      "V_neck": 0.68,
                      "high": 0.02,
                      "sweetheart": 0.02,
                      "off_shoulder": 0.05
                  },
                  "top_length": {
                      "crop": 0.07,
                      "above_the_hip": 0.89,
                      "below_the_hip": 0.04
                  },
                  "top_fit": {
                      "regular": 0.3,
                      "tight": 0.6,
                      "peplum": 0.09
                  },
                  "top_collar": {
                      "none": 0.73,
                      "shirt": 0.05,
                      "polo": 0.03,
                      "banded": 0.1,
                      "decorated": 0.09
                  },
                  "sleeve": {
                      "zero_sleeve": 0.95,
                      "short": 0.03
                  },
                  "dominant-colors": {
                      "#181819": 0.97,
                      "#3f3d3d": 0.01
                  },
                  "palette-colors": {
                      "#000000": 0.97,
                      "#bebebe": 0.02
                  },
                  "pattern.simple": {
                      "yes": 0.01,
                      "no": 0.99
                  },
                  "pattern.floral": {
                      "no": 1.0
                  },
                  "pattern.other": {
                      "yes": 0.02,
                      "no": 0.98
                  },
                  "pattern.square": {
                      "no": 1.0
                  },
                  "pattern.animal": {
                      "no": 1.0
                  },
                  "pattern.stripes": {
                      "no": 1.0
                  },
                  "pattern.dots": {
                      "yes": 0.97,
                      "no": 0.03
                  },
                  "pattern.logo": {
                      "no": 1.0
                  },
                  "pattern.imageText": {
                      "no": 1.0
                  }
              },
              "tags_argmax": {
                  "neckline": "V_neck",
                  "top_length": "above_the_hip",
                  "top_fit": "tight",
                  "top_collar": "none",
                  "sleeve": "zero_sleeve",
                  "dominant-colors": "#181819",
                  "palette-colors": "#000000",
                  "pattern.simple": "no",
                  "pattern.floral": "no",
                  "pattern.other": "no",
                  "pattern.square": "no",
                  "pattern.animal": "no",
                  "pattern.stripes": "no",
                  "pattern.dots": "yes",
                  "pattern.logo": "no",
                  "pattern.imageText": "no"
              },
              "color_variant": null
          },
          "color": "čierna",
          "item_group_enabled": "1",
          "color_group_id": "234157",
          "image_link_box": "https://i.factcool.com/cache2/410x615/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg"
      }
      
    • fully expanded

      curl -X GET "https://api.instyle.ai/recommendation-api/v2/looks/695353?product_serializer=expand&look_serializer=expand&item_serializer=expand"
      -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
      

      Response

      {
          "product_id": "695353",
          "brand": "Trendyol",
          "category_paths": [
              [
                  "Ženy"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie",
                  "Topy"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie",
                  "Topy",
                  "Body"
              ]
          ],
          "title": "Women's Body Suit Trendyol Shiny",
          "description": "<ul><li> 98% Polyester% 2 Sim </li><li> Model Measurements: Height: 1.78, Chest: 87, Waist: 60, Hip: 89, Size: S / 36/1 </li><li> <a href="http://www..com/Assets/file/Milla_Beden_Tablosu.jpg">Dimension Table</a> </li><li> Our products will be shipped with the TRENDYOL tag. </li></ul>",
          "link": "https://sk.factcool.com/siyah-simli-yaka-dekolteli-body-1788629",
          "google_product_category": "212",
          "google_product_type": "Oblečení a doplňky > Oblečení > Košile a topy",
          "gender": "female",
          "adult": "no",
          "mpn": "1788629",
          "look_id": "695353",
          "image_links": [
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_2_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_4_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_1_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_2_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_3_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_5_org_zoom.jpg"
          ],
          "thumbnail_links": [
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_2_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_4_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_1_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_2_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_3_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_5_org_zoom.jpg?impolicy=298x298"
          ],
          "results": {
              "image_order": null,
              "related_looks": {
                  "similarity": [
                      "695353",
                      "1648148",
                      "950593",
                      "1648149",
                      "1363674",
                      "1569380",
                      "1527912",
                      "1363302",
                      "951779",
                      "1625158",
                      "1494431",
                      "1444524",
                      "1583439",
                      "1644299",
                      "772169",
                      "1257310",
                      "1662951",
                      "945559",
                      "1362946",
                      "1257309"
                  ],
                  "similarity_b": [
                      "695353",
                      "1648148",
                      "950593",
                      "1648149",
                      "1363674",
                      "1569380",
                      "1527912",
                      "1363302",
                      "951779",
                      "1625158",
                      "1494431",
                      "1444524",
                      "1583439",
                      "1644299",
                      "772169",
                      "1257310",
                      "1662951",
                      "945559",
                      "1362946",
                      "1257309"
                  ],
                  "style-with": [
                      "1325452",
                      "949449",
                      "1259105",
                      "1529549",
                      "1411333",
                      "1476097",
                      "1330948",
                      "1448476",
                      "1330942"
                  ]
              },
              "related_outfits": {
                  "shop_the_look": [
                      "female-formal170622676",
                      "female-formal215260645",
                      "female-formal219502837"
                  ]
              },
              "tags_hash": "918dc83885335641e3554579eff13b3e",
              "tags": {
                  "neckline": {
                      "asymmetric": 0.03,
                      "U_neck": 0.21,
                      "V_neck": 0.68,
                      "high": 0.02,
                      "sweetheart": 0.02,
                      "off_shoulder": 0.05
                  },
                  "top_length": {
                      "crop": 0.07,
                      "above_the_hip": 0.89,
                      "below_the_hip": 0.04
                  },
                  "top_fit": {
                      "regular": 0.3,
                      "tight": 0.6,
                      "peplum": 0.09
                  },
                  "top_collar": {
                      "none": 0.73,
                      "shirt": 0.05,
                      "polo": 0.03,
                      "banded": 0.1,
                      "decorated": 0.09
                  },
                  "sleeve": {
                      "zero_sleeve": 0.95,
                      "short": 0.03
                  },
                  "dominant-colors": {
                      "#181819": 0.97,
                      "#3f3d3d": 0.01
                  },
                  "palette-colors": {
                      "#000000": 0.97,
                      "#bebebe": 0.02
                  },
                  "pattern.simple": {
                      "yes": 0.01,
                      "no": 0.99
                  },
                  "pattern.floral": {
                      "no": 1.0
                  },
                  "pattern.other": {
                      "yes": 0.02,
                      "no": 0.98
                  },
                  "pattern.square": {
                      "no": 1.0
                  },
                  "pattern.animal": {
                      "no": 1.0
                  },
                  "pattern.stripes": {
                      "no": 1.0
                  },
                  "pattern.dots": {
                      "yes": 0.97,
                      "no": 0.03
                  },
                  "pattern.logo": {
                      "no": 1.0
                  },
                  "pattern.imageText": {
                      "no": 1.0
                  }
              },
              "tags_argmax": {
                  "neckline": "V_neck",
                  "top_length": "above_the_hip",
                  "top_fit": "tight",
                  "top_collar": "none",
                  "sleeve": "zero_sleeve",
                  "dominant-colors": "#181819",
                  "palette-colors": "#000000",
                  "pattern.simple": "no",
                  "pattern.floral": "no",
                  "pattern.other": "no",
                  "pattern.square": "no",
                  "pattern.animal": "no",
                  "pattern.stripes": "no",
                  "pattern.dots": "yes",
                  "pattern.logo": "no",
                  "pattern.imageText": "no"
              },
              "color_variant": null
          },
          "color": "čierna",
          "item_group_enabled": "1",
          "color_group_id": "234157",
          "image_link_box": "https://i.factcool.com/cache2/410x615/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg",
          "items": [
              {
                  "item_id": "695353-4154161",
                  "size": "42",
                  "price": "24.99 EUR",
                  "gtin": "TPRAW18FZ0181R48B34",
                  "condition": "new",
                  "availability": "in stock",
                  "full_id": "234157-695353-4154161",
                  "price_eur": "24.99",
                  "second_price": "33.99 EUR",
                  "second_price_eur": "33.99",
                  "third_price": null,
                  "third_price_eur": null
              },
              {
                  "item_id": "695353-4154159",
                  "size": "40",
                  "price": "24.99 EUR",
                  "gtin": "TPRAW18FZ0181R48B30",
                  "condition": "new",
                  "availability": "in stock",
                  "full_id": "234157-695353-4154159",
                  "price_eur": "24.99",
                  "second_price": "33.99 EUR",
                  "second_price_eur": "33.99",
                  "third_price": null,
                  "third_price_eur": null
              },
              {
                  "item_id": "695353-4154157",
                  "size": "38",
                  "price": "24.99 EUR",
                  "gtin": "TPRAW18FZ0181R48B26",
                  "condition": "new",
                  "availability": "in stock",
                  "full_id": "234157-695353-4154157",
                  "price_eur": "24.99",
                  "second_price": "33.99 EUR",
                  "second_price_eur": "33.99",
                  "third_price": null,
                  "third_price_eur": null
              },
              {
                  "item_id": "695353-4154155",
                  "size": "36",
                  "price": "24.99 EUR",
                  "gtin": "TPRAW18FZ0181R48B22",
                  "condition": "new",
                  "availability": "in stock",
                  "full_id": "234157-695353-4154155",
                  "price_eur": "24.99",
                  "second_price": "33.99 EUR",
                  "second_price_eur": "33.99",
                  "third_price": null,
                  "third_price_eur": null
              }
          ]
      }
      
    • ids only for all entities

      curl -X GET "https://api.instyle.ai/recommendation-api/v2/looks/695353?product_serializer=id&look_serializer=id&item_serializer=id"
      -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
      

      Response

      {
          "product_id": "695353",
          "look_id": "695353",
          "items": [
              {
                  "item_id": "695353-4154161"
              },
              {
                  "item_id": "695353-4154159"
              },
              {
                  "item_id": "695353-4154157"
              },
              {
                  "item_id": "695353-4154155"
              }
          ]
      }
      
  • item

    • own attributes expanded

      curl -X GET "https://api.instyle.ai/recommendation-api/v2/items/695353-4154161?"
      -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
      

      Response

      {
          "item_id": "695353-4154161",
          "size": "42",
          "price": "24.99 EUR",
          "gtin": "TPRAW18FZ0181R48B34",
          "condition": "new",
          "availability": "in stock",
          "full_id": "234157-695353-4154161",
          "price_eur": "24.99",
          "second_price": "33.99 EUR",
          "second_price_eur": "33.99",
          "third_price": null,
          "third_price_eur": null
      }
      
    • fully expanded

      curl -X GET "https://api.instyle.ai/recommendation-api/v2/items/695353-4154161?product_serializer=expand&look_serializer=expand&item_serializer=expand"
      -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
      

      Response

      {
          "product_id": "695353",
          "brand": "Trendyol",
          "category_paths": [
              [
                  "Ženy"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie",
                  "Topy"
              ],
              [
                  "Ženy",
                  "Ženy oblečenie",
                  "Topy",
                  "Body"
              ]
          ],
          "title": "Women's Body Suit Trendyol Shiny",
          "description": "<ul><li> 98% Polyester% 2 Sim </li><li> Model Measurements: Height: 1.78, Chest: 87, Waist: 60, Hip: 89, Size: S / 36/1 </li><li> <a href="http://www..com/Assets/file/Milla_Beden_Tablosu.jpg">Dimension Table</a> </li><li> Our products will be shipped with the TRENDYOL tag. </li></ul>",
          "link": "https://sk.factcool.com/siyah-simli-yaka-dekolteli-body-1788629",
          "google_product_category": "212",
          "google_product_type": "Oblečení a doplňky > Oblečení > Košile a topy",
          "gender": "female",
          "adult": "no",
          "mpn": "1788629",
          "look_id": "695353",
          "image_links": [
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_2_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_4_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_1_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_2_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_3_org_zoom.jpg",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_5_org_zoom.jpg"
          ],
          "thumbnail_links": [
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_2_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_4_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B20_1_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_2_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_3_org_zoom.jpg?impolicy=298x298",
              "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_5_org_zoom.jpg?impolicy=298x298"
          ],
          "results": {
              "image_order": null,
              "related_looks": {
                  "similarity": [
                      "695353",
                      "1648148",
                      "950593",
                      "1648149",
                      "1363674",
                      "1569380",
                      "1527912",
                      "1363302",
                      "951779",
                      "1625158",
                      "1494431",
                      "1444524",
                      "1583439",
                      "1644299",
                      "772169",
                      "1257310",
                      "1662951",
                      "945559",
                      "1362946",
                      "1257309"
                  ],
                  "similarity_b": [
                      "695353",
                      "1648148",
                      "950593",
                      "1648149",
                      "1363674",
                      "1569380",
                      "1527912",
                      "1363302",
                      "951779",
                      "1625158",
                      "1494431",
                      "1444524",
                      "1583439",
                      "1644299",
                      "772169",
                      "1257310",
                      "1662951",
                      "945559",
                      "1362946",
                      "1257309"
                  ],
                  "style-with": [
                      "1325452",
                      "949449",
                      "1259105",
                      "1529549",
                      "1411333",
                      "1476097",
                      "1330948",
                      "1448476",
                      "1330942"
                  ]
              },
              "related_outfits": {
                  "shop_the_look": [
                      "female-formal170622676",
                      "female-formal215260645",
                      "female-formal219502837"
                  ]
              },
              "tags_hash": "918dc83885335641e3554579eff13b3e",
              "tags": {
                  "neckline": {
                      "asymmetric": 0.03,
                      "U_neck": 0.21,
                      "V_neck": 0.68,
                      "high": 0.02,
                      "sweetheart": 0.02,
                      "off_shoulder": 0.05
                  },
                  "top_length": {
                      "crop": 0.07,
                      "above_the_hip": 0.89,
                      "below_the_hip": 0.04
                  },
                  "top_fit": {
                      "regular": 0.3,
                      "tight": 0.6,
                      "peplum": 0.09
                  },
                  "top_collar": {
                      "none": 0.73,
                      "shirt": 0.05,
                      "polo": 0.03,
                      "banded": 0.1,
                      "decorated": 0.09
                  },
                  "sleeve": {
                      "zero_sleeve": 0.95,
                      "short": 0.03
                  },
                  "dominant-colors": {
                      "#181819": 0.97,
                      "#3f3d3d": 0.01
                  },
                  "palette-colors": {
                      "#000000": 0.97,
                      "#bebebe": 0.02
                  },
                  "pattern.simple": {
                      "yes": 0.01,
                      "no": 0.99
                  },
                  "pattern.floral": {
                      "no": 1.0
                  },
                  "pattern.other": {
                      "yes": 0.02,
                      "no": 0.98
                  },
                  "pattern.square": {
                      "no": 1.0
                  },
                  "pattern.animal": {
                      "no": 1.0
                  },
                  "pattern.stripes": {
                      "no": 1.0
                  },
                  "pattern.dots": {
                      "yes": 0.97,
                      "no": 0.03
                  },
                  "pattern.logo": {
                      "no": 1.0
                  },
                  "pattern.imageText": {
                      "no": 1.0
                  }
              },
              "tags_argmax": {
                  "neckline": "V_neck",
                  "top_length": "above_the_hip",
                  "top_fit": "tight",
                  "top_collar": "none",
                  "sleeve": "zero_sleeve",
                  "dominant-colors": "#181819",
                  "palette-colors": "#000000",
                  "pattern.simple": "no",
                  "pattern.floral": "no",
                  "pattern.other": "no",
                  "pattern.square": "no",
                  "pattern.animal": "no",
                  "pattern.stripes": "no",
                  "pattern.dots": "yes",
                  "pattern.logo": "no",
                  "pattern.imageText": "no"
              },
              "color_variant": null
          },
          "color": "čierna",
          "item_group_enabled": "1",
          "color_group_id": "234157",
          "image_link_box": "https://i.factcool.com/cache2/410x615/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg",
          "item_id": "695353-4154161",
          "size": "42",
          "price": "24.99 EUR",
          "gtin": "TPRAW18FZ0181R48B34",
          "condition": "new",
          "availability": "in stock",
          "full_id": "234157-695353-4154161",
          "price_eur": "24.99",
          "second_price": "33.99 EUR",
          "second_price_eur": "33.99",
          "third_price": null,
          "third_price_eur": null
      }
      
    • ids only for all entities

      curl -X GET "https://api.instyle.ai/recommendation-api/v2/items/695353-4154161?product_serializer=id&look_serializer=id&item_serializer=id"
      -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
      

      Response

      {
          "product_id": "695353",
          "look_id": "695353",
          "item_id": "695353-4154161"
      }
      

Recommendation Endpoints

Static vs Personalized Recommendations

We distinguish two types of recommendations

  • personalized: results are tailored specifically to given customer e.g. last seen products (user or session identifier is required)

  • static: results are same for everyone e.g. category bestsellers

Recommendation Serializers

The recommendation results can be serialized as

  • id: result contains only ids of recommended looks (best performance)

  • expand: result looks are expanded with basic fields like title, price, image_url, (alpha version, not recommended for production)

Product detail page recommendations

pdp_recommenders

Examples

  • static recommendations with id serializer

    curl -X GET "https://api.instyle.ai/recommendation-api/v2/recommender/pdp/static/695353?serializer=id"
    -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
    

    Response

    {
        "similarity": [
            "695353",
            "1648148",
            "950593",
            "1648149",
            "1363674",
            "1569380",
            "1527912",
            "1363302",
            "951779",
            "1625158",
            "1494431",
            "1444524",
            "1583439",
            "1644299",
            "772169",
            "1257310",
            "1662951",
            "945559",
            "1362946",
            "1257309"
        ],
        "similarity_b": [
            "695353",
            "1648148",
            "950593",
            "1648149",
            "1363674",
            "1569380",
            "1527912",
            "1363302",
            "951779",
            "1625158",
            "1494431",
            "1444524",
            "1583439",
            "1644299",
            "772169",
            "1257310",
            "1662951",
            "945559",
            "1362946",
            "1257309"
        ],
        "style-with": [
            "1325452",
            "949449",
            "1259105",
            "1529549",
            "1411333",
            "1476097",
            "1330948",
            "1448476",
            "1330942"
        ]
    }
    
  • static recommendations with expand serializer

    curl -X GET "https://api.instyle.ai/recommendation-api/v2/recommender/pdp/static/695353?serializer=expand"
    -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
    

    Response

    {
        "similarity": [
            {
                "id": "695353",
                "title": "Women's Body Suit Trendyol Shiny",
                "brand": "Trendyol",
                "price": 24.99,
                "sizes": [
                    "36",
                    "38",
                    "40",
                    "42"
                ],
                "image_url": "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg",
                "link": "https://sk.factcool.com/siyah-simli-yaka-dekolteli-body-1788629"
            },
            {
                "id": "1648148",
                "title": "Greenpoint Woman's Top TOP73700",
                "brand": "Greenpoint",
                "price": 15.99,
                "sizes": [
                    "34",
                    "36",
                    "38",
                    "40",
                    "42",
                    "44"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/22/f1/14-22-f1990299top737003635s21dot43_e.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1648148"
            },
            {
                "id": "950593",
                "title": "Lenitif Woman's Body K483",
                "brand": "Lenitif",
                "price": 32.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/c5/35/14-c5-35K483_ecru_1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=950593"
            },
            {
                "id": "1648149",
                "title": "Greenpoint Woman's Top TOP73700",
                "brand": "Greenpoint",
                "price": 15.99,
                "sizes": [
                    "34",
                    "36",
                    "38",
                    "40",
                    "42",
                    "44"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/12/bb/14-12-bbb6e89ctop737003635s21dot44_d.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1648149"
            },
            {
                "id": "1363674",
                "title": "BUENITA women's blouse pink RY1500",
                "brand": "DStreet",
                "price": 28.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/cf/38/60-cf-385f8da629454-3.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1363674"
            },
            {
                "id": "1569380",
                "title": "Trendyol 2-Pack Black-White Knitted Body",
                "brand": "Trendyol",
                "price": 17.99,
                "sizes": [
                    "XS",
                    "S"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/c4/fc/11-c4-fc12fee72_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1569380"
            },
            {
                "id": "1527912",
                "title": "V-neck lace bodysuit",
                "brand": "Ptakmoda",
                "price": 16.99,
                "sizes": [
                    "L",
                    "S"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/ee/c8/60-ee-c8d5322akoronkowe-body-z-dekoltem-w-serek.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1527912"
            },
            {
                "id": "1363302",
                "title": "SUWIENE women's blouse white RY1392",
                "brand": "DStreet",
                "price": 29.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/e4/dd/60-e4-dd8b47cd28914-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1363302"
            },
            {
                "id": "951779",
                "title": "Figl Woman's Body M201",
                "brand": "Figl",
                "price": 24.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/22/db/14-22-dbM201_black_2.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=951779"
            },
            {
                "id": "1625158",
                "title": "Embroidered women's top KEJSI beige Dstreet RY1725",
                "brand": "DStreet",
                "price": 17.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/06/c4/60-06-c4fc479635344-5.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1625158"
            },
            {
                "id": "1494431",
                "title": "Trendyol Black Bike Collar Body",
                "brand": "Trendyol",
                "price": 15.99,
                "sizes": [
                    "34",
                    "36",
                    "38"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/c3/20/11-c3-202d84eb4_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1494431"
            },
            {
                "id": "1444524",
                "title": "Dámsky crop top Trendyol Tulle detailed",
                "brand": "Trendyol",
                "price": 16.99,
                "sizes": [
                    "34",
                    "38",
                    "40"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/66/9f/11-66-9f5407491_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1444524"
            },
            {
                "id": "1583439",
                "title": "GAP T-shirt",
                "brand": "GAP",
                "price": 22.99,
                "sizes": [
                    "XS",
                    "S",
                    "M",
                    "L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/70/3b/61/70-3b-61584549ae52ac24-e0d5-4a60-be12-581e5aa19f7c-647612-02-0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1583439"
            },
            {
                "id": "1644299",
                "title": "Black top with lace inserts",
                "brand": "Fashionhunters",
                "price": 20.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/f9/e0/60-f9-e07fe364372693-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1644299"
            },
            {
                "id": "772169",
                "title": "Dámsky top Golddigga Cami",
                "brand": "Golddigga",
                "price": 15.99,
                "sizes": [
                    "XS",
                    "S",
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/b4/156-b4-150ed00c20210906140838_65149903_xxl.jpg",
                "link": "https://sk.factcool.com/golddigga-cami-65149903"
            },
            {
                "id": "1257310",
                "title": "Trendyol Body",
                "brand": "Trendyol",
                "price": 16.99,
                "sizes": [
                    "36",
                    "38",
                    "42"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/1d/42/11-1d-42378d761_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1257310"
            },
            {
                "id": "1662951",
                "title": "Conte Woman's ELEGANT TATTOO STYLE LBM 1480",
                "brand": "Conte",
                "price": 25.99,
                "sizes": [
                    "170-84-90 / XS",
                    "170-88-94 / S",
                    "170-92-98 / M",
                    "170-96-102 / L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/61/4f/14-61-4fdb3746other_1-148-.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1662951"
            },
            {
                "id": "945559",
                "title": "Figl Woman's Body M354",
                "brand": "Figl",
                "price": 16.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/80/20/14-80-20M354_ecru_2_blank.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=945559"
            },
            {
                "id": "1362946",
                "title": "BELISSA top black RY1291",
                "brand": "DStreet",
                "price": 21.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/7e/0e/60-7e-0ec18d1528416-3.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1362946"
            },
            {
                "id": "1257309",
                "title": "Trendyol Anthracite Payet Body",
                "brand": "Trendyol",
                "price": 16.99,
                "sizes": [
                    "38"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/61/7a/11-61-7a5f91083_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1257309"
            }
        ],
        "similarity_b": [
            {
                "id": "695353",
                "title": "Women's Body Suit Trendyol Shiny",
                "brand": "Trendyol",
                "price": 24.99,
                "sizes": [
                    "36",
                    "38",
                    "40",
                    "42"
                ],
                "image_url": "https://i.factcool.com/catalog/products/tmp/ty/TPRAW18FZ0181R48B22_4_org_zoom.jpg",
                "link": "https://sk.factcool.com/siyah-simli-yaka-dekolteli-body-1788629"
            },
            {
                "id": "1648148",
                "title": "Greenpoint Woman's Top TOP73700",
                "brand": "Greenpoint",
                "price": 15.99,
                "sizes": [
                    "34",
                    "36",
                    "38",
                    "40",
                    "42",
                    "44"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/22/f1/14-22-f1990299top737003635s21dot43_e.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1648148"
            },
            {
                "id": "950593",
                "title": "Lenitif Woman's Body K483",
                "brand": "Lenitif",
                "price": 32.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/c5/35/14-c5-35K483_ecru_1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=950593"
            },
            {
                "id": "1648149",
                "title": "Greenpoint Woman's Top TOP73700",
                "brand": "Greenpoint",
                "price": 15.99,
                "sizes": [
                    "34",
                    "36",
                    "38",
                    "40",
                    "42",
                    "44"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/12/bb/14-12-bbb6e89ctop737003635s21dot44_d.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1648149"
            },
            {
                "id": "1363674",
                "title": "BUENITA women's blouse pink RY1500",
                "brand": "DStreet",
                "price": 28.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/cf/38/60-cf-385f8da629454-3.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1363674"
            },
            {
                "id": "1569380",
                "title": "Trendyol 2-Pack Black-White Knitted Body",
                "brand": "Trendyol",
                "price": 17.99,
                "sizes": [
                    "XS",
                    "S"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/c4/fc/11-c4-fc12fee72_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1569380"
            },
            {
                "id": "1527912",
                "title": "V-neck lace bodysuit",
                "brand": "Ptakmoda",
                "price": 16.99,
                "sizes": [
                    "L",
                    "S"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/ee/c8/60-ee-c8d5322akoronkowe-body-z-dekoltem-w-serek.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1527912"
            },
            {
                "id": "1363302",
                "title": "SUWIENE women's blouse white RY1392",
                "brand": "DStreet",
                "price": 29.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/e4/dd/60-e4-dd8b47cd28914-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1363302"
            },
            {
                "id": "951779",
                "title": "Figl Woman's Body M201",
                "brand": "Figl",
                "price": 24.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/22/db/14-22-dbM201_black_2.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=951779"
            },
            {
                "id": "1625158",
                "title": "Embroidered women's top KEJSI beige Dstreet RY1725",
                "brand": "DStreet",
                "price": 17.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/06/c4/60-06-c4fc479635344-5.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1625158"
            },
            {
                "id": "1494431",
                "title": "Trendyol Black Bike Collar Body",
                "brand": "Trendyol",
                "price": 15.99,
                "sizes": [
                    "34",
                    "36",
                    "38"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/c3/20/11-c3-202d84eb4_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1494431"
            },
            {
                "id": "1444524",
                "title": "Dámsky crop top Trendyol Tulle detailed",
                "brand": "Trendyol",
                "price": 16.99,
                "sizes": [
                    "34",
                    "38",
                    "40"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/66/9f/11-66-9f5407491_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1444524"
            },
            {
                "id": "1583439",
                "title": "GAP T-shirt",
                "brand": "GAP",
                "price": 22.99,
                "sizes": [
                    "XS",
                    "S",
                    "M",
                    "L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/70/3b/61/70-3b-61584549ae52ac24-e0d5-4a60-be12-581e5aa19f7c-647612-02-0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1583439"
            },
            {
                "id": "1644299",
                "title": "Black top with lace inserts",
                "brand": "Fashionhunters",
                "price": 20.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/f9/e0/60-f9-e07fe364372693-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1644299"
            },
            {
                "id": "772169",
                "title": "Dámsky top Golddigga Cami",
                "brand": "Golddigga",
                "price": 15.99,
                "sizes": [
                    "XS",
                    "S",
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/b4/156-b4-150ed00c20210906140838_65149903_xxl.jpg",
                "link": "https://sk.factcool.com/golddigga-cami-65149903"
            },
            {
                "id": "1257310",
                "title": "Trendyol Body",
                "brand": "Trendyol",
                "price": 16.99,
                "sizes": [
                    "36",
                    "38",
                    "42"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/1d/42/11-1d-42378d761_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1257310"
            },
            {
                "id": "1662951",
                "title": "Conte Woman's ELEGANT TATTOO STYLE LBM 1480",
                "brand": "Conte",
                "price": 25.99,
                "sizes": [
                    "170-84-90 / XS",
                    "170-88-94 / S",
                    "170-92-98 / M",
                    "170-96-102 / L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/61/4f/14-61-4fdb3746other_1-148-.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1662951"
            },
            {
                "id": "945559",
                "title": "Figl Woman's Body M354",
                "brand": "Figl",
                "price": 16.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/80/20/14-80-20M354_ecru_2_blank.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=945559"
            },
            {
                "id": "1362946",
                "title": "BELISSA top black RY1291",
                "brand": "DStreet",
                "price": 21.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/7e/0e/60-7e-0ec18d1528416-3.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1362946"
            },
            {
                "id": "1257309",
                "title": "Trendyol Anthracite Payet Body",
                "brand": "Trendyol",
                "price": 16.99,
                "sizes": [
                    "38"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/61/7a/11-61-7a5f91083_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1257309"
            }
        ],
        "style-with": [
            {
                "id": "1325452",
                "title": "Emilio Pucci EP008",
                "brand": "Emilio Pucci",
                "price": 70.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/48/9c/b7/48-9c-b7649324stock_product_image_108921_556556553.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1325452"
            },
            {
                "id": "949449",
                "title": "Made Of Emotion Woman's Jacket M030",
                "brand": "Made Of Emotion",
                "price": 45.99,
                "sizes": [
                    "L",
                    "M",
                    "S",
                    "XL",
                    "XS",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/e4/4b/14-e4-4bm030_ecru_1b.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=949449"
            },
            {
                "id": "1259105",
                "title": "Trendyol Black Fringed Viscose Sarong Skirt",
                "brand": "Trendyol",
                "price": 16.99,
                "sizes": [
                    "34",
                    "36",
                    "38",
                    "40"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/01/7f/11-01-7fa7b84c2_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1259105"
            },
            {
                "id": "1529549",
                "title": "Trendyol Black Genuine Leather Women Classic Heeled Shoes",
                "brand": "Trendyol",
                "price": 33.99,
                "sizes": [
                    "37"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/3d/4f/11-3d-4fc4a3a91_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1529549"
            },
            {
                "id": "1411333",
                "title": "Dámska sukňa Kilpi TANY-W",
                "brand": "Kilpi",
                "price": 44.99,
                "sizes": [
                    "40",
                    "42",
                    "44",
                    "46"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/f4/fe6-f4-fe010fdf20201211092034_8592914533153.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1411333"
            },
            {
                "id": "1476097",
                "title": "Dámske lodičky Trendyol Classic",
                "brand": "Trendyol",
                "price": 18.99,
                "sizes": [
                    "36",
                    "37",
                    "38",
                    "39",
                    "40"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/d1/26/11-d1-2680d3961_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1476097"
            },
            {
                "id": "1330948",
                "title": "Dámsky kabát dewberry Z6628",
                "brand": "dewberry",
                "price": 61.99,
                "sizes": [
                    "L",
                    "S",
                    "XS"
                ],
                "image_url": "https://i.factcool.com/catalog/products/59/c8/b3/59-c8-b381bffaz6628-dewberry-bayan-palto-yesil-85b3.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1330948"
            },
            {
                "id": "1448476",
                "title": "Dámska sukňa ALIFE AND KICKIN Miley",
                "brand": "ALIFE AND KICKIN",
                "price": 27.99,
                "sizes": [
                    "XS",
                    "S",
                    "M"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/9f/2a6-9f-2a41f4e620210223095437_62040-9100_2.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1448476"
            },
            {
                "id": "1330942",
                "title": "Dámsky kabát dewberry Z6630",
                "brand": "dewberry",
                "price": 61.99,
                "sizes": [
                    "L",
                    "S",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/59/3c/15/59-3c-15ab0e52z6630-dewberry-bayan-palto-antrasit-01c6b-.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1330942"
            }
        ]
    }
    
  • personalized recommendations with id serializer

    curl -X GET "https://api.instyle.ai/recommendation-api/v2/recommender/pdp/personalized/695353?session_id=123&serializer=id"
    -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
    

    Response

    {
        "last_seen": [
            "352633",
            "1440169",
            "1440161",
            "1414517",
            "1414516",
            "1414515",
            "1410367",
            "1410366",
            "1410365",
            "1410363",
            "1410353",
            "1367719",
            "1362248",
            "1361153",
            "1349448",
            "1349447",
            "1298252",
            "1294875",
            "1294873",
            "1072224"
        ],
        "personalized": [
            "1444013",
            "1475451",
            "1326679",
            "772169",
            "839213",
            "976211",
            "1229140",
            "1328750",
            "1255864",
            "1444521"
        ]
    }
    
  • personalized recommendations with expand serializer

    curl -X GET "https://api.instyle.ai/recommendation-api/v2/recommender/pdp/personalized/695353?session_id=123&serializer=expand"
    -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
    

    Response

    {
        "last_seen": [
            {
                "id": "352633",
                "title": "Boxerky pánske Lee Cooper 5Pcs",
                "brand": "Lee Cooper",
                "price": 17.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/1/2b/8e/1-2b-8e4514ba42217490_xxl.jpg",
                "link": "https://sk.factcool.com/boxers-5-pack-42217490"
            },
            {
                "id": "1440169",
                "title": "Pánske boxerky Lee Cooper 10P",
                "brand": "Lee Cooper",
                "price": 27.99,
                "sizes": [
                    "M",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/70/ec6-70-ec4a7b3c20210503070136_9911111142972------10pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1440169"
            },
            {
                "id": "1440161",
                "title": "Pánske boxerky Lee Cooper 7P",
                "brand": "Lee Cooper",
                "price": 19.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/4f/4b6-4f-4b04dab920210430123809_9911111142927------7pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1440161"
            },
            {
                "id": "1414517",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "XL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/4c/a86-4c-a83c370220201211083642_9911111133857------5pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1414517"
            },
            {
                "id": "1414516",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "L",
                    "XL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/70/766-70-76b6edf820201211083436_9911111133901-----5pack_10.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1414516"
            },
            {
                "id": "1414515",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/c7/946-c7-944755c720201211083146_9911111133956------5pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1414515"
            },
            {
                "id": "1410367",
                "title": "Pánske boxerky Lee Cooper 10P",
                "brand": "Lee Cooper",
                "price": 29.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/5b/9b6-5b-9b2aa50020201127160021_9911111133765----10pack.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410367"
            },
            {
                "id": "1410366",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "L",
                    "XL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/b1/d96-b1-d995b3f920201127134735_LCU3200709A.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410366"
            },
            {
                "id": "1410365",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/29/a96-29-a918e38320201127142032_LCU3200710A.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410365"
            },
            {
                "id": "1410363",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/90/df6-90-df6ee9b920201127144546_LCU3200711A.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410363"
            },
            {
                "id": "1410353",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "M",
                    "L",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/5b/a96-5b-a9ffcfbb20201127154542_LCU3200712A.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410353"
            },
            {
                "id": "1367719",
                "title": "Pánske tepláky DStreet UX3244",
                "brand": "DStreet",
                "price": 12.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/b1/ec/60-b1-ec6c315c29796-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1367719"
            },
            {
                "id": "1362248",
                "title": "Pánske tepláky DStreet UX3244",
                "brand": "DStreet",
                "price": 12.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/fa/9b/60-fa-9b8b8e5027382-3.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1362248"
            },
            {
                "id": "1361153",
                "title": "Pánska mikina DStreet BX4110",
                "brand": "DStreet",
                "price": 14.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/4b/e6/60-4b-e65c79b424690-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1361153"
            },
            {
                "id": "1349448",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 13.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/cb/cb43d1_9911111134366.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1349448"
            },
            {
                "id": "1349447",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 13.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/112bbd_9911111134311.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1349447"
            },
            {
                "id": "1298252",
                "title": "Pánske boxerky Lee Cooper 7P",
                "brand": "Lee Cooper",
                "price": 19.99,
                "sizes": [
                    "M",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/16/986-16-9895d4b220201130161346_a521d1_9911111133802----7pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1298252"
            },
            {
                "id": "1294875",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 13.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/48/48fb45_9911111133703------5pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1294875"
            },
            {
                "id": "1294873",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 14.99,
                "sizes": [
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/53/538e2c_9911111133604-----5pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1294873"
            },
            {
                "id": "1072224",
                "title": "Pánske boxerky Lee Cooper 5 Pack Printed",
                "brand": "Lee Cooper",
                "price": 19.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/1/22/83/1-22-836f095542157103_xxl.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1072224"
            }
        ],
        "personalized": [
            {
                "id": "1444013",
                "title": "Trendyol Stone Back Detailed Blouse",
                "brand": "Trendyol",
                "price": 15.99,
                "sizes": [
                    "36",
                    "40"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/0e/79/11-0e-797639812_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1444013"
            },
            {
                "id": "1475451",
                "title": "Dámsky top Trendyol Lace detailed",
                "brand": "Trendyol",
                "price": 6.99,
                "sizes": [
                    "XS",
                    "S",
                    "L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/0c/32/11-0c-329698051_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1475451"
            },
            {
                "id": "1326679",
                "title": "Trendyol Stone V Collar KnitWear Blouse",
                "brand": "Trendyol",
                "price": 9.49,
                "sizes": [
                    "S",
                    "M"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/68/dc/11-68-dc848c081_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1326679"
            },
            {
                "id": "772169",
                "title": "Dámsky top Golddigga Cami",
                "brand": "Golddigga",
                "price": 15.99,
                "sizes": [
                    "XS",
                    "S",
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/b4/156-b4-150ed00c20210906140838_65149903_xxl.jpg",
                "link": "https://sk.factcool.com/golddigga-cami-65149903"
            },
            {
                "id": "839213",
                "title": "Dámske body Trendyol V-neck",
                "brand": "Trendyol",
                "price": 15.99,
                "sizes": [
                    "36"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/51/ce/11-51-ceaf40881_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=839213"
            },
            {
                "id": "976211",
                "title": "Dámsky top Trendyol Knitwear",
                "brand": "Trendyol",
                "price": 7.49,
                "sizes": [
                    "S",
                    "M",
                    "L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/53/3f/11-53-3f0700f11_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=976211"
            },
            {
                "id": "1229140",
                "title": "Dámsky top Trendyol Knitwear",
                "brand": "Trendyol",
                "price": 8.49,
                "sizes": [
                    "S",
                    "M"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/de/8c/11-de-8c2f67801_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1229140"
            },
            {
                "id": "1328750",
                "title": "Trendyol Black Tulle Detailed Knitting Body",
                "brand": "Trendyol",
                "price": 10.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XS"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/dc/d3/11-dc-d36d8b781_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1328750"
            },
            {
                "id": "1255864",
                "title": "Dámsky top Trendyol Knitwear",
                "brand": "Trendyol",
                "price": 8.49,
                "sizes": [
                    "S",
                    "L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/ac/43/11-ac-43bc40181_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1255864"
            },
            {
                "id": "1444521",
                "title": "Dámsky top Trendyol Nacy",
                "brand": "Trendyol",
                "price": 16.99,
                "sizes": [
                    "34"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/8d/1e/11-8d-1e031cbc1_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1444521"
            }
        ]
    }
    

Landing page Recommendations

  • recommendations with id serializer

    curl -X GET "https://api.instyle.ai/recommendation-api/v2/recommender/landing?session_id=123&serializer=id"
    -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
    

    Response

    {
        "bestsellers": [
            "1294873",
            "1414516",
            "1294875",
            "1410367",
            "1362248",
            "352633",
            "1367719",
            "1361153",
            "1349448",
            "1349447"
        ],
        "last_seen": [
            "352633",
            "1440169",
            "1440161",
            "1414517",
            "1414516",
            "1414515",
            "1410367",
            "1410366",
            "1410365",
            "1410363",
            "1410353",
            "1367719",
            "1362248",
            "1361153",
            "1349448",
            "1349447",
            "1298252",
            "1294875",
            "1294873",
            "1072224"
        ],
        "personalized": [
            "611831",
            "1072225",
            "1072227",
            "1072226",
            "918708",
            "918707",
            "1476902",
            "1054310",
            "633279",
            "1477478"
        ]
    }
    
  • recommendations with expand serializer

    curl -X GET "https://api.instyle.ai/recommendation-api/v2/recommender/landing?session_id=123&serializer=expand"
    -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
    

    Response

    {
        "bestsellers": [
            {
                "id": "1294873",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 14.99,
                "sizes": [
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/53/538e2c_9911111133604-----5pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1294873"
            },
            {
                "id": "1414516",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "L",
                    "XL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/70/766-70-76b6edf820201211083436_9911111133901-----5pack_10.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1414516"
            },
            {
                "id": "1294875",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 13.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/48/48fb45_9911111133703------5pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1294875"
            },
            {
                "id": "1410367",
                "title": "Pánske boxerky Lee Cooper 10P",
                "brand": "Lee Cooper",
                "price": 29.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/5b/9b6-5b-9b2aa50020201127160021_9911111133765----10pack.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410367"
            },
            {
                "id": "1362248",
                "title": "Pánske tepláky DStreet UX3244",
                "brand": "DStreet",
                "price": 12.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/fa/9b/60-fa-9b8b8e5027382-3.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1362248"
            },
            {
                "id": "352633",
                "title": "Boxerky pánske Lee Cooper 5Pcs",
                "brand": "Lee Cooper",
                "price": 17.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/1/2b/8e/1-2b-8e4514ba42217490_xxl.jpg",
                "link": "https://sk.factcool.com/boxers-5-pack-42217490"
            },
            {
                "id": "1367719",
                "title": "Pánske tepláky DStreet UX3244",
                "brand": "DStreet",
                "price": 12.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/b1/ec/60-b1-ec6c315c29796-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1367719"
            },
            {
                "id": "1361153",
                "title": "Pánska mikina DStreet BX4110",
                "brand": "DStreet",
                "price": 14.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/4b/e6/60-4b-e65c79b424690-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1361153"
            },
            {
                "id": "1349448",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 13.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/cb/cb43d1_9911111134366.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1349448"
            },
            {
                "id": "1349447",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 13.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/112bbd_9911111134311.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1349447"
            }
        ],
        "last_seen": [
            {
                "id": "352633",
                "title": "Boxerky pánske Lee Cooper 5Pcs",
                "brand": "Lee Cooper",
                "price": 17.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/1/2b/8e/1-2b-8e4514ba42217490_xxl.jpg",
                "link": "https://sk.factcool.com/boxers-5-pack-42217490"
            },
            {
                "id": "1440169",
                "title": "Pánske boxerky Lee Cooper 10P",
                "brand": "Lee Cooper",
                "price": 27.99,
                "sizes": [
                    "M",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/70/ec6-70-ec4a7b3c20210503070136_9911111142972------10pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1440169"
            },
            {
                "id": "1440161",
                "title": "Pánske boxerky Lee Cooper 7P",
                "brand": "Lee Cooper",
                "price": 19.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/4f/4b6-4f-4b04dab920210430123809_9911111142927------7pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1440161"
            },
            {
                "id": "1414517",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "XL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/4c/a86-4c-a83c370220201211083642_9911111133857------5pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1414517"
            },
            {
                "id": "1414516",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "L",
                    "XL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/70/766-70-76b6edf820201211083436_9911111133901-----5pack_10.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1414516"
            },
            {
                "id": "1414515",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/c7/946-c7-944755c720201211083146_9911111133956------5pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1414515"
            },
            {
                "id": "1410367",
                "title": "Pánske boxerky Lee Cooper 10P",
                "brand": "Lee Cooper",
                "price": 29.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/5b/9b6-5b-9b2aa50020201127160021_9911111133765----10pack.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410367"
            },
            {
                "id": "1410366",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "L",
                    "XL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/b1/d96-b1-d995b3f920201127134735_LCU3200709A.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410366"
            },
            {
                "id": "1410365",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/29/a96-29-a918e38320201127142032_LCU3200710A.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410365"
            },
            {
                "id": "1410363",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/90/df6-90-df6ee9b920201127144546_LCU3200711A.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410363"
            },
            {
                "id": "1410353",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 15.99,
                "sizes": [
                    "M",
                    "L",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/5b/a96-5b-a9ffcfbb20201127154542_LCU3200712A.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1410353"
            },
            {
                "id": "1367719",
                "title": "Pánske tepláky DStreet UX3244",
                "brand": "DStreet",
                "price": 12.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/b1/ec/60-b1-ec6c315c29796-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1367719"
            },
            {
                "id": "1362248",
                "title": "Pánske tepláky DStreet UX3244",
                "brand": "DStreet",
                "price": 12.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/fa/9b/60-fa-9b8b8e5027382-3.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1362248"
            },
            {
                "id": "1361153",
                "title": "Pánska mikina DStreet BX4110",
                "brand": "DStreet",
                "price": 14.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/4b/e6/60-4b-e65c79b424690-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1361153"
            },
            {
                "id": "1349448",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 13.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/cb/cb43d1_9911111134366.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1349448"
            },
            {
                "id": "1349447",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 13.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/112bbd_9911111134311.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1349447"
            },
            {
                "id": "1298252",
                "title": "Pánske boxerky Lee Cooper 7P",
                "brand": "Lee Cooper",
                "price": 19.99,
                "sizes": [
                    "M",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/16/986-16-9895d4b220201130161346_a521d1_9911111133802----7pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1298252"
            },
            {
                "id": "1294875",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 13.99,
                "sizes": [
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/48/48fb45_9911111133703------5pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1294875"
            },
            {
                "id": "1294873",
                "title": "Pánske boxerky Lee Cooper Multicolored",
                "brand": "Lee Cooper",
                "price": 14.99,
                "sizes": [
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/53/538e2c_9911111133604-----5pack_0.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1294873"
            },
            {
                "id": "1072224",
                "title": "Pánske boxerky Lee Cooper 5 Pack Printed",
                "brand": "Lee Cooper",
                "price": 19.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/1/22/83/1-22-836f095542157103_xxl.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1072224"
            }
        ],
        "personalized": [
            {
                "id": "611831",
                "title": "Boxerky pánske Lee Cooper 5Pcs",
                "brand": "Lee Cooper",
                "price": 17.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL",
                    "XXL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/1/71/ed/1-71-ed71c29e42217491_xxl.jpg",
                "link": "https://sk.factcool.com/boxers-5-pack-42217491"
            },
            {
                "id": "1072225",
                "title": "Pánske boxerky Lee Cooper 10 pack",
                "brand": "Lee Cooper",
                "price": 34.99,
                "sizes": [
                    "S",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/cache2/1400x1400/products/Man/spodné prádlo/42261103_xxl_99.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1072225"
            },
            {
                "id": "1072227",
                "title": "Pánske boxerky Lee Cooper 10 pack",
                "brand": "Lee Cooper",
                "price": 34.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL",
                    "XXL",
                    "3XL"
                ],
                "image_url": "https://i.factcool.com/cache2/1400x1400/products/Man/spodné prádlo/42261102_xxl_99.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1072227"
            },
            {
                "id": "1072226",
                "title": "Pánske boxerky Lee Cooper 10 pack",
                "brand": "Lee Cooper",
                "price": 34.99,
                "sizes": [
                    "L"
                ],
                "image_url": "https://i.factcool.com/cache2/1400x1400/products/Man/spodné prádlo/42261140_xxl_99.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1072226"
            },
            {
                "id": "918708",
                "title": "Pánske ponožky Lee Cooper 10 Pack",
                "brand": "Lee Cooper",
                "price": 14.99,
                "sizes": [
                    "Mens 7-11",
                    "Mens 12+"
                ],
                "image_url": "https://i.factcool.com/catalog/products/1/7a/d1/1-7a-d1aaf76141601790_xxl.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=918708"
            },
            {
                "id": "918707",
                "title": "Pánske ponožky Lee Cooper 10 Pack",
                "brand": "Lee Cooper",
                "price": 14.99,
                "sizes": [
                    "Mens 7-11",
                    "Mens 12+"
                ],
                "image_url": "https://i.factcool.com/catalog/products/1/ae/2f/1-ae-2fd4970141601703_xxl.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=918707"
            },
            {
                "id": "1476902",
                "title": "Trendyol Black Male 5 Pack Boxer",
                "brand": "Trendyol",
                "price": 14.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/ee/d6/11-ee-d6a06b3a1_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1476902"
            },
            {
                "id": "1054310",
                "title": "Pánske ponožky Trendyol Multicolored",
                "brand": "Trendyol",
                "price": 7.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/9d/97/11-9d-97356a381_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1054310"
            },
            {
                "id": "633279",
                "title": "Pánske ponožky Slazenger Trainer",
                "brand": "Slazenger",
                "price": 9.49,
                "sizes": [
                    "Mens 7-11"
                ],
                "image_url": "https://i.factcool.com/catalog/products/1/93/7b/1-93-7bb0790e41112090_xxl.jpg",
                "link": "https://sk.factcool.com/slazenger-5-pack-trainer-socks-mens-41112090"
            },
            {
                "id": "1477478",
                "title": "Pánske boxerky Top Secret 3 Pack",
                "brand": "Top Secret",
                "price": 12.99,
                "sizes": [
                    "L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/12/12/dd/12-12-dda7cb6fssx0071gr_7.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1477478"
            }
        ]
    }
    

Category listing page Recommendations

  • recommendations with id serializer

    curl -X GET "https://api.instyle.ai/recommendation-api/v2/recommender/clp/3?session_id=123&serializer=id"
    -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
    

    Response

    {
        "bestsellers": [
            "1385898",
            "1516454",
            "1633324",
            "1618865",
            "1449689",
            "1023200",
            "1326730",
            "935641",
            "1328602",
            "1258060"
        ]
    }
    
  • recommendations with expand serializer

    curl -X GET "https://api.instyle.ai/recommendation-api/v2/recommender/clp/3?session_id=123&serializer=expand"
    -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
    

    Response

    {
        "bestsellers": [
            {
                "id": "1385898",
                "title": "Dámska košeľa Trendyol Plaid",
                "brand": "Trendyol",
                "price": 14.99,
                "sizes": [
                    "34",
                    "36",
                    "38",
                    "40",
                    "42",
                    "32"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/97/24/11-97-242a27b41_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1385898"
            },
            {
                "id": "1516454",
                "title": "Ponožky Frogies Regular",
                "brand": "Frogies",
                "price": 3.99,
                "sizes": [
                    "35-38",
                    "39-42"
                ],
                "image_url": "https://i.factcool.com/catalog/products/6/b6/0a6-b6-0a4e9b4320210701140139_9911111169511.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1516454"
            },
            {
                "id": "1633324",
                "title": "Dámske tepláky Edoti PLR001",
                "brand": "Edoti",
                "price": 9.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/13/49/14/13-49-14bc2a4516940_1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1633324"
            },
            {
                "id": "1618865",
                "title": "Dámske tenisky Kesi High",
                "brand": "Kesi",
                "price": 32.99,
                "sizes": [
                    "38",
                    "39",
                    "40",
                    "41",
                    "36",
                    "37"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/a4/13/60-a4-13718b2a11971-3.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1618865"
            },
            {
                "id": "1449689",
                "title": "Dámske tepláky Fashionhunters Low rise",
                "brand": "Fashionhunters",
                "price": 17.99,
                "sizes": [
                    "XS",
                    "S",
                    "M",
                    "L",
                    "XL"
                ],
                "image_url": "https://i.factcool.com/catalog/products/60/66/e3/60-66-e329de99328221-1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1449689"
            },
            {
                "id": "1023200",
                "title": "Dámske legíny Trendyol Glossy",
                "brand": "Trendyol",
                "price": 6.99,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XL",
                    "XS"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/6e/9f/11-6e-9f42ae932_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1023200"
            },
            {
                "id": "1326730",
                "title": "Dámsky sveter Trendyol Two-toned",
                "brand": "Trendyol",
                "price": 11.99,
                "sizes": [
                    "S",
                    "M",
                    "L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/6f/1b/11-6f-1b6d955e3_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1326730"
            },
            {
                "id": "935641",
                "title": "Dámske šaty Trendyol Ribbon Detailed",
                "brand": "Trendyol",
                "price": 9.49,
                "sizes": [
                    "S",
                    "M",
                    "L",
                    "XS"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/aa/aa/11-aa-aa51045b1_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=935641"
            },
            {
                "id": "1328602",
                "title": "Dámsky sveter Trendyol Knitwear",
                "brand": "Trendyol",
                "price": 9.49,
                "sizes": [
                    "S",
                    "L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/28/79/11-28-79b1da2b1_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1328602"
            },
            {
                "id": "1258060",
                "title": "Dámske šaty Trendyol Multicolored",
                "brand": "Trendyol",
                "price": 9.99,
                "sizes": [
                    "XS",
                    "S",
                    "M"
                ],
                "image_url": "https://i.factcool.com/catalog/products/11/69/7a/11-69-7aaa93671_org_zoom.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1258060"
            }
        ]
    }
    

In Cart Recommendations

  • recommendations with id serializer

    curl -X GET "https://api.instyle.ai/recommendation-api/v2/recommender/cart?cart=695353=&cart=124567?session_id=123&serializer=id"
    -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
    

    Response

    {
        "cart_bestsellers": [
            "1516454",
            "1066032",
            "1414490",
            "1414488",
            "1516441",
            "1516482",
            "1514134",
            "1066033",
            "1066028",
            "1066031"
        ]
    }
    
  • recommendations with expand serializer

    curl -X GET "https://api.instyle.ai/recommendation-api/v2/recommender/cart?cart=695353=&cart=124567?session_id=123&serializer=expand"
    -H  "accept: application/json" -H  "x-api-key: $API_KEY" -H  "Authorization: None"
    

    Response

    {
        "cart_bestsellers": [
            {
                "id": "1252004",
                "title": "Edoti Cotton mask A260",
                "brand": "Edoti",
                "price": 4.03,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/13/88/e2/13-88-e2fe79a214711_1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1252004"
            },
            {
                "id": "1264152",
                "title": "Edoti Mask with a filter pocket A262",
                "brand": "Edoti",
                "price": 0.99,
                "sizes": [
                    "One size",
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/13/ba/e3/13-ba-e3f443f815112_1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1264152"
            },
            {
                "id": "1372742",
                "title": "Mr. GUGU & Miss GO Unisex's Mask M2048",
                "brand": "Mr. GUGU & Miss GO",
                "price": 9.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/f9/76/14-f9-7693736220201001133700_sHzp9e4B2VmQPrwY_800x880.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1372742"
            },
            {
                "id": "1372712",
                "title": "Mr. GUGU & Miss GO Unisex's Mask M1962",
                "brand": "Mr. GUGU & Miss GO",
                "price": 9.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/45/53/14-45-531e868220200723092621_RZSYL8NF5oh9tIVt_800x880.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1372712"
            },
            {
                "id": "1372727",
                "title": "Mr. GUGU & Miss GO Unisex's Mask M1989",
                "brand": "Mr. GUGU & Miss GO",
                "price": 9.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/7b/a1/14-7b-a1f0358820200804085040_ozN3UhneMhl6PbFX_800x880.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1372727"
            },
            {
                "id": "1243833",
                "title": "Ochranné rúško CrazyFly Adult",
                "brand": "CrazyFly",
                "price": 2.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/bc/bc8857_32_.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1243833"
            },
            {
                "id": "1336575",
                "title": "Reebok 3 Pack Face Masks",
                "brand": "Reebok",
                "price": 13.99,
                "sizes": [
                    "L"
                ],
                "image_url": "https://i.factcool.com/catalog/products/1/09/15/1-09-15c1563570929703_xxl.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1336575"
            },
            {
                "id": "1372668",
                "title": "Mr. GUGU & Miss GO Unisex's Mask M1675",
                "brand": "Mr. GUGU & Miss GO",
                "price": 9.99,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/14/0b/ee/14-0b-eed9d55b20200623124811_24tsA12YE7H7hSd7_800x880.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1372668"
            },
            {
                "id": "1383689",
                "title": "Edoti Cotton mask A305",
                "brand": "Edoti",
                "price": 2.49,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/13/a3/57/13-a3-57db3f4516346_1.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1383689"
            },
            {
                "id": "1597101",
                "title": "HYGIENIC MASK REUSABLE APPROVED HARRY POTTER",
                "brand": "HARRY POTTER",
                "price": 7.49,
                "sizes": [
                    "One size"
                ],
                "image_url": "https://i.factcool.com/catalog/products/69/28/93/69-28-9314b09b2200007563.jpg",
                "link": "https://sk.factcool.com/index.php?route=product/product&product_id=1597101"
            }
        ]
    }