Product

A full reference to a product type for different Liquid Commerce APIs.

ProductType

Attribute	Description
id: string	identifier of the product
name: string	product name
salsifyGrouping: string [optional]	optional Salsify grouping identifier
brand: string	product brand
catPath: string	the category path normalized through our liquid taxonomy
category: string	normalized category
classification: string	product classification, ex: Canadian Whiskey
type: string	product type, ex: Whiskey
subType: string	product type, ex: Flavored Whiskey
region: string	product region, ex: Toronto
country: string	country of origin, ex: Canada
material: string	material used in production, ex: Grains
color: string	product color, ex: Tawny/Brown
flavor: string	product flavor profile, ex: Apple
variety: string	product variety, ex: Blend-Grains
appellation: string	similar to country or region, ex: Canada
abv: string	product alcohol by volume, ex: 40 (40%)
proof: string	alcohol proof
age: string	product age, ex: 14
vintage: string	year of production/harvest, ex: 2020
description: string	a product detailed description, max length: 250 characters
htmlDescription: string	a product detailed description with html tags, max length: 250 characters
tastingNotes: string	product tasting notes breakdown, max length: 250 characters
additionalInformation: string [optional]	a product additional information
images: string[] | Array<Record<string, any>>	product images
sizes: Array<Size>	all of the available sizes for the product
attributes: Partial<Attributes> [optional]	optional product attributes
priceInfo: ProductPriceInfo | null	represents product price information

Size

Attribute	Description
id: string	identifier of the product size
size: string	product size, ex: 750ML
salsifyPid: string [optional]	optional Salsify product identifier
upc: string	each size's UPC
container: string	each size's container, ex: Bottle
containerType: string	each size's container type, ex: Glass
pack: boolean	whether the size is a pack, ex: true
packDesc: string	if the size is a pack and a description is available, ex: 8pk
volume: string	volume measurement
uom: string	unit of measure
image: string	product size specific image (if available, otherwise defaults to the mainImage)
attributes: ProductSizeAttributes	each size's attributes
modalities: Modalities [optional]	available fulfillment modalities
variants: Array<Variant>	each retailer's available variant for the size

ProductSizeAttributes

Attribute	Description
engraving: ProductSizeEngraving	Each size's engraving attributes
presale: ProductPresale	Representing a product presale
maxQuantityPerOrder: number [optional]	Maximum quantity per order allowed for this product

ProductPresale

Attribute	Description
canPurchaseOn: Date | null	The date when the product can be added to the cart
estimatedShipBy: Date | null	The date when the product is expected to ship
isActive: boolean	Indicates whether the presale is currently active
language: string	The language associated with the product presale

Attributes

Attribute	Description
brandOrigin: string	brand's origin information
originStatement: string	detailed origin description
ownershipType: Array<string>	types of ownership
tags: Array<string>	product tags
images: AttributesImage	product image configurations
awards: Array<AttributesAward>	product awards
recipes: Array<AttributesRecipe>	related recipes
video: Array<AttributesVideo>	product videos
tastingNotes: Array<AttributesTastingNote>	detailed tasting notes
personalizations: Array<AttributesPersonalization>	personalization options

ProductSizeEngraving

Attribute	Description
status: boolean	whether engraving is activated if true
validated: boolean [optional]	engraving validation
maxLines: number	the maximum number of line allowed, ex: the maximum allowed in this example id 2 (maxLines: 2) [ "Happy Birthday", "100 more!" ]
maxCharsPerLine: number	the maximum number of characters allowed per line, ex: 14 it includes whitespaces
fee: number	engraving price, ex: 5000 ($50.00)
location: string	engraving location on the product, ex: Above the label

Variants

Attribute	Description
partNumber: string	variant identifier (used to add to cart), ex: 00082002599562_6565f4e5ddec8ce19105d26
retailerId: string	retailer identifier (used to map the Array<Retailer>), ex: 6565f4e8700628ce19106b14
price: number	variant price, ex: 1499
isEngravable: boolean	whether this retailer's variant allows engraving, ex: true
modalities: string[]	the methods of fulfillment available for the variant, ex: [ 'shipping', 'onDemand' ]
salePrice: number	variant sale price, ex: 1199 ($11.99)
stock: number	variant stock quantity, ex: 82
fulfillmentTypes: VariantFulfillmentTypes	variants retailer offered fulfillment based on type
fulfillments: string[]	fulfillment identifier (used to map the Array<Fulfillment>), ex: ["6570c3ec700628ce1910c265", "6565f4e8700628ce19106b14"]

VariantFulfillmentTypes

Attribute	Description
shipping: string	retailer's shipping fulfillment Id, * ONLY SHIPPING RETAILERS CAN HANDLE ENGRAVING ORDER *
onDemand: string	retailer's onDemand fulfillment Id

AttributesImage

Attribute	Description
backOfBottle: string	url for back of bottle image
frontOfBottle: string	url for front of bottle image
lifestyle: Array<string>	array of lifestyle image urls

AttributesAward

Attribute	Description
image: string	award image url
statement: string	award statement text
title: string	award title

AttributesRecipe

Attribute	Description
image: string	recipe image url
ingredients: Array<AttributesRecipeIngredient>	array of recipe ingredients
steps: Array<string>	array of recipe steps
title: string	recipe title

AttributesRecipeIngredient

Attribute	Description
name: string	ingredient name
amount: string	amount needed for recipe

AttributesVideo

Attribute	Description
link: string	video url
image: string	video thumbnail image url
title: string	video title

AttributesTastingNote

Attribute	Description
statement: string	tasting note description
image: string	associated image url
title: string	tasting note title

AttributesPersonalization

Attribute	Description
type: string	type of personalization
engravingMaxLines: number	maximum number of lines for engraving
engravingMaxCharsPerLine: number	maximum characters per line for engraving
location: Array<string>	available locations for personalization
width: number	width for personalization area
height: number	height for personalization area
image: string	personalization reference image url
fee: number	cost of personalization
availableFrom: Date	start date for personalization availability
availableTo: Date	end date for personalization availability

ProductPriceInfo

Attribute	Description
currency: string	the currency code for the prices
minimum: number	the lowest price available for this product across all retailers
average: number	the average price of the product across all retailers
maximum: number	the highest price available for this product across all retailers

Sample product

Product Object

{
  "id": "50726f643247373737343330",
  "name": "TITO'S HANDMADE VODKA",
  "salsifyGrouping": "GROUPING-33277",
  "brand": "TITO'S",
  "catPath": "Spirits > Vodka > Regular Vodka",
  "category": "Spirits",
  "classification": "Vodka",
  "type": "Regular Vodka",
  "subType": "",
  "region": "TEXAS",
  "country": "UNITED STATES",
  "material": "GRAIN",
  "color": "WHITE",
  "flavor": "",
  "variety": "CORN",
  "appellation": "TEXAS",
  "vintage": "",
  "description": "Tito's Handmade Vodka is America's Original Craft Vodka produced in Austin, Texas. Tito's is known for its high-quality product, charitable giving, and goal to make people happy while making the world a better place. Tito's is crafted in old-fashioned pot stills, with each batch taste-tested. Exceptionally smooth with an impeccably clean finish, our unflavored, low-calorie vodka is six times distilled, made from corn, and naturally gluten-free with no carbs or sugar*. From a Bloody Mary at brunch, a Transfusion on the golf course, or a simple Tito's and soda with friends, make every occasion a celebration with Tito's! Tito's Handmade Vodka turns spirits into love and goodness with Love, Tito's, the philanthropic heart of the company, supporting thousands of nonprofit organizations across the U.S. — and around the world — amplifying their missions of disaster relief and response, community building, animal welfare, veteran services, and so much more. Available in Liter, 1.75L, 750mL, 375mL, 200mL, and 50mL sizes. For more information, visit titosvodka.com.\n\n*(Average Analysis per 1.5 oz Tito's Handmade Vodka: 98 calories, Carbohydrates 0 grams, Protein 0 grams, Fat 0 grams, Sugar 0 grams)\n\nMADE IN BATCHES: Tito's Handmade Vodka is made in Austin, Texas, and distilled in old-fashioned pot stills, with each batch taste-tested.\n\nMADE FROM CORN: Our unflavored vodka is distilled from corn, making it naturally gluten-free. Tito's is 98 calories per 1.5 oz serving, and 65 calories per 1 oz serving.\n\nMIXES WITH EVERYTHING: Tito's mixes with everything, from a classic Tito's Soda Lime to the iconic Bloody Mary to a refreshing Tito's Transfusion, the official drink of the green.\n\nSPREAD THE LOVE: Tito's Handmade Vodka is dedicated to giving back through its Love, Tito's®️ and Vodka for Dog People®️ programs, plus a no-cost farmers market for employees at its Fourteen Acres™️ Farm.",
  "htmlDescription": "<ul><li><p>Tito's Handmade Vodka is America's</p></li><li><p>Original Craft Vodka produced in Austin,</p></li><li><p>Texas. Tito's is known for its high-quality product, charitable giving, and goal to make people happy while making the world a better place. Tito's is crafted in old-fashioned pot stills, with each batch taste-tested. Exceptionally smoot</p></li><li><p>h with an impeccably clean finish, our unflavored, low-calorie vodka is six times distilled, made from corn, and naturally gluten-free with no carbs or sugar*. From a Bloody Mary at brunch, a Transfusion on the golf course, or a simple Tito's and soda with friends, make every occasion a celebration with Tito's! Tito's Handmade Vodka turns spirits into love and goodness with Love, Tito's, the philanthropic heart of the company, supporting thousands of nonprofit organizations across the U.S. — and around the world — amplifying their missions of disaster relief and response, community building, animal welfare, veteran services, and so much more. Available in Liter, 1.75L, 750mL, 375mL, 200mL, and 50mL sizes. For more information, visit titosvodka.com.</p></li></ul><p>*(Average Analysis per 1.5 oz Tito's Handmade Vodka: 98 calories, Carbohydrates 0 grams, Protein 0 grams, Fat 0 grams, Sugar 0 grams)</p><p>MADE IN BATCHES: Tito's Handmade Vodka is made in Austin, Texas, and distilled in old-fashioned pot stills, with each batch taste-tested.</p><p>MADE FROM CORN: Our unflavored vodka is distilled from corn, making it naturally gluten-free. Tito's is 98 calories per 1.5 oz serving, and 65 calories per 1 oz serving.</p><p>MIXES WITH EVERYTHING: Tito's mixes with everything, from a classic Tito's Soda Lime to the iconic Bloody Mary to a refreshing Tito's Transfusion, the official drink of the green.</p><p>SPREAD THE LOVE: Tito's Handmade Vodka is dedicated to giving back through its Love, Tito's®️ and Vodka for Dog People®️ programs, plus a no-cost farmers market for employees at its Fourteen Acres™️ Farm.</p>",
  "tastingNotes": "Exceptionally Smooth. Distilled from corn, Tito's offers a taste that leads with smoky notes of roasted grain and black pepper and finishes with a subtle sweetness. Our gluten-free vodka is crafted for spirit connoisseurs and taste-tested to make sure you get the best juice we have to offer.",
  "images": [
    "https://assets.liquidcommerce.co/catalog/img/3d972802-7f88-410a-a6d7-15e3267f569a.png",
    "https://assets.liquidcommerce.co/catalog/images/2023_Evergreen_LoveTitos_3000x3000.jpg",
    "https://assets.liquidcommerce.co/catalog/images/2023_Evergreen_GoesDownSmooth_3000x3000.jpg",
    "https://assets.liquidcommerce.co/catalog/images/2023_Evergreen_Corn_3000x3000.jpg",
    "https://assets.liquidcommerce.co/catalog/images/image_-_2024-12-18T181404.457_(1).png",
    "https://assets.liquidcommerce.co/catalog/images/(Image_4)_Evergreen_AustinTexas_3000x3000.png",
    "https://assets.liquidcommerce.co/catalog/images/(Image_5)_Evergreen_Cocktails_3000x3000.png"
  ],
  "abv": "40",
  "proof": "80",
  "age": "",
  "availableFrom": null,
  "sizes": [
    {
      "id": "6554c9a46b741e7ad37bc5db",
      "upc": "00619947000020",
      "size": "750 ML",
      "volume": "750",
      "catPath": "SPIRITS > VODKA > REGULAR VODKA",
      "uom": "MILLILITRE",
      "container": "Bottle",
      "containerType": "Glass",
      "pack": false,
      "packDesc": "",
      "image": "https://assets.liquidcommerce.co/catalog/img/3d972802-7f88-410a-a6d7-15e3267f569a.png",
      "attributes": {
        "presale": {
          "canPurchaseOn": null,
          "estimatedShipBy": null,
          "language": "",
          "isActive": false
        },
        "engraving": {
          "maxCharsPerLine": 16,
          "maxLines": 2,
          "fee": 5000,
          "status": true,
          "location": "Above the Label, Front of the Bottle"
        },
        "maxQuantityPerOrder": 12
      },
      "variants": [
        {
          "partNumber": "00619947000020_retailerId-123",
          "retailerId": "retailerId_123",
          "modalities": [
            "shipping"
          ],
          "price": 1799,
          "salePrice": 0,
          "stock": 1878,
          "isEngravable": true,
          "fulfillmentTypes": {
            "shipping": "fulfillmentId_123",
            "onDemand": ""
          },
          "fulfillments": [
            "fulfillmentId_123"
          ]
        }
      ],
      "salsifyPid": "926",
      "maxQuantityPerOrder": 12
    }
  ],
  "attributes": {
    "brandOrigin": "Tito's Handmade Vodka was founded by sixth-generation Texan, Tito Beveridge. His career track took a few turns, but he always found time to do what he loved: make people smile with spirits. Tito got a kick out of infusing vodka for friends and handing out bottles at parties. He quickly became known as \"the vodka guy.\" Willing to risk it all, he pursued the career of his dreams and set out to build a distillery. With a dog by his side, Tito found a plot of land in rural Austin, convinced a few friends to help him build a shack for his still and, against all odds, perfected his pot-distilled spirit. He fought Texas laws, took on nearly $90,000 of debt, and for several years, played a one-man show to get his dream going, overseeing all distilling, hand-bottling, and selling during the hours in between until he sold his first case. Over twenty-five years later, Tito's Handmade Vodka has remained true to its roots and is celebrated for its high-quality product, charitable contributions, and its goal to make people happy while making the world a better place.",
    "originStatement": "Tito's Handmade Vodka was founded in 1997 by sixth-generation Texan, Tito Beveridge. Twenty-five years later, Tito's has remained true to its roots and is celebrated for its high-quality product, charitable contributions, and goal to make people happy while making the world a better place.",
    "ownershipType": [],
    "tags": [],
    "images": {
      "backOfBottle": "",
      "frontOfBottle": "",
      "lifestyle": [
        "https://assets.liquidcommerce.co/catalog/images/2023_Evergreen_LoveTitos_3000x3000.jpg",
        "https://assets.liquidcommerce.co/catalog/images/2023_Evergreen_GoesDownSmooth_3000x3000.jpg",
        "https://assets.liquidcommerce.co/catalog/images/2023_Evergreen_Corn_3000x3000.jpg",
        "https://assets.liquidcommerce.co/catalog/images/image_-_2024-12-18T181404.457_(1).png",
        "https://assets.liquidcommerce.co/catalog/images/(Image_4)_Evergreen_AustinTexas_3000x3000.png",
        "https://assets.liquidcommerce.co/catalog/images/(Image_5)_Evergreen_Cocktails_3000x3000.png"
      ]
    },
    "recipes": [
      {
        "image": "",
        "ingredients": [
          {
            "name": "Tito's Handmade Vodka",
            "amount": "1.5 oz"
          },
          {
            "name": "Ginger Beer",
            "amount": "3 oz"
          },
          {
            "name": "Fresh Lime Juice",
            "amount": "0.5 oz"
          },
          {
            "name": "Lime Slice",
            "amount": "Garnish"
          }
        ],
        "steps": [
          "Add all ingredients to a Tito's Copper Mug with ice.",
          "Stir and garnish with a lime slice."
        ],
        "title": "TITO'S AMERICAN MULE"
      }
    ],
    "video": [
      {
        "link": "goOVywpBvPA",
        "image": "",
        "title": "The Story of Tito's Handmade Vodka"
      }
    ],
    "tastingNotes": [],
    "awards": []
  },
  "priceInfo": {
    "currency": "USD",
    "minimum": 1699,
    "average": 2320,
    "maximum": 3247
  }
}