Retrieve outfits and similar items

You can request related item recommendations directly from the browser using our SDK.

Interaction tracking

In order for us to automatically instrument click and view tracking, you should follow the Interaction Tracking guide

To request outfits, partner outfits, and/or similar items simultaneously for an item

For recommendations to be accurate, it's important not to change the order or grouping of the items returned from the API.

Using the below, you can request related items (similar items, outfits, and partner outfits) in a single request.

Partner outfits (aka "model wears") are only available for sites that have provided Mapp Fashion with the necessary information.

Dressipi("related", "items", {
  item_id: "YOUR_PRODUCT_CODE_OR_SKU",
  placement_id: "A_UUID_PROVIDED_BY_DRESSIPI",
  request_format: "detailed",
  methods: ["outfits,partner_outfits,similar_items"] // should be an array, amend as required
  try_all_methods: true, // if false (the default), the methods listed are attempted until one succeeds
  onSuccess: (data) => {
  },
  onFailure: (err) => {},
});

{
  "outfits": [
    {
      "content_id": "65dfa7", // use this for interaction tracking
      "items": [
        {
          // this is the Dressipi identifier for this related item, used in the interaction tracking
          "dressipi_item_id": 1322, 
          
          // this is your identifier for this related item
          "id": "REDDRESS01", 
        },
        ...
      ],
      "occasion": "casual",
    },
    ...
   ],
   "partner_outfits": [
    {
      "content_id": "65dfa7", // use this for interaction tracking
      "items": [
        {
          // this is the Dressipi identifier for this related item, used in the interaction tracking
          "dressipi_item_id": 1322, 
          
          // this is your identifier for this related item
          "id": "REDDRESS01", 
        },
        ...
      ],
      "occasion": null,
    },
    ...
	],
  "similar_items": {
    "content_id": "65dfa7", // use this for interaction tracking
    "items": [
      {
        // this is the Dressipi identifier for this related item, used in the interaction tracking
        "dressipi_item_id": 35122,

        // this is your identifier for this related item
        "id": "602849501492",
      },
      ...
  	],
  }
}