The Item Object

Attributes

Attribute

Data type

Description

display_name required

string

The display name of the product.

sku required

string

The product SKU.

unit_price required

integer

The item price amount in USD or CAD cents.

qty

integer

The item quantity expressed as an integer.

item_image_url

string

The item's product image URL.

item_url

string

The item's product description page URL.

categories

Array

An array of lists that indicate the various categories that apply to this product, and the hierarchy of those category definitions. Each list in the array contains one or more comma-separated strings, with the first string being the highest-level (widest) category.

Response Example

{
   "display_name":"Awesome Pants",
   "sku":"ABC-123",
   "unit_price":1999,
   "qty":3,
   "item_image_url":"http://merchantsite.com/images/awesome-pants.jpg",
   "item_url":"http://merchantsite.com/products/awesome-pants.html",
   "categories":[
      [
         "Apparel",
         "Pants"
      ],
      [
         "Mens",
         "Apparel",
         "Pants"
      ]
   ]
}