Get information for a single alcohol product.


HTTP Request

GET /data/product/{product_id}?merchant_id={merchant_id}

Resource Information

Parameter Value
Response Format JSON
Authentication pass in client_id only
Rate Limited. Yes


Unauthenticated API request. Simply pass in the client_id. You can receive a client_id after signing up for a developer account.

Full Example URL


All parameter keys should be lowercase; parameter values should all be UTF-8 and URL-encoded.

Parameter Name Type Description
Required Parameters
product_id string Alphanumeric string identifying the product selection. Enter this value directly into the url route.
merchant_id integer Id of the merchant_id currently offering this product.
Optional Parameters
show_description boolean Set to true to return the full item description (when available).

Product_id Uniqueness

  • The product_id is the liquid_id.
  • Items containing the same liquid will usually have the same product_id.
  • However, sometimes the same “liquid” products will be assigned different product_ids.

The product_id can not be used for checkout. As this only specifies the alcohol liquid (product type). Alcohol products have varying volume, quantity, and container types. The “children” key in the response will return all permutations (volume, container, and quantity) of the bottles. Use that id to make a call to checkout.

The product_id is useful to get all similar products with varying volume / container type / quantity – especially during item browsing.

Merchant Id

The merchant_id must be passed in so the appropriate item information is returned. Inventory and prices are based on availability from local merchants.

Merchant ids can be obtained by issuing a general a call to Get alcohol products.


item: [
  0 : {
    available: true,
    children: [{ ... }],
    description: 'Some description',
    id: "11234",
    image: "",
    increment: 1,
    max_price: 33.99,
    max_qty: 25,
    merchant_id: 62184,
    min_qty: 1,
    name: "Bacardi Rum Gold",
    popular_flag: false,
    price: 5.99,
    tags: [ ... ],
    type: "item", 
    unique_id: ""
Parameter Type Explanation
available boolean Is the item currently in stock?
children object Lists all item size/price options
description string Item description
id string product_id
image string Url of image thumbnail
increment integer Used internally
max_price float Maximum price of all available options
max_qty integer Maximum number of items that can be ordered at once
merchant_id integer Merchant id of the inventory lookup
min_qty integer Minimum number of items that must be purchased
name string Item title
popular_flag boolean Used internally
price float Minimum price of all available options
tags object Additional item tagging information
type string Defaults to “item”
unique_id string Not currently used


The deepest children will list a collection of price/size object options.

children: [{
 0: {
  children: [],
  description: "",
  id: "56fa9db6275af6b84a8b4ecc",
  max_price: 0,
  name: "1.75L",
  price: 33.99,
  type: "option",
  unique_id: ""
 1: {
  children: [],
  description: "",
  id: "56fa9f8f275af6b84a8b6911",
  max_price: 0,
  name: "1L",
  price: 24.99,
  type: "option",
  unique_id: ""
 ... all other options
Parameter Type Explanation
children object Not currently used
id string Unique id used for checkout
max_price int Not currently used
name string Size / container / quantity information
price float Price of item option
type string Set to “option” (vs. “item” from earlier)
unique_id string Not currently used

The unique_id is used to make a call to checkout. The id uniquely identifies:

merchant_id  /  product_id (liquid)  /  size_option