The BBYOpen APIs expose Best Buy products, stores, reviews, and categories. Approximately 400 attributes provide access to these items' details and specifications. The BBYOpen API Data Dictionary provides general attribute information, as well as links to lists of Products, Stores, Reviews, and Categories attributes. The lists themselves can be found on the API > Attributes pages, or can be accessed from the links below. Products API attributes are grouped into several tables. Click on a link below to see the appropriate data dictionary table.
General Attribute Information:
The Products API includes two types of attributes:
The product attribute pages list the data type for each attribute. The data type reflects how the information is stored in the BBYOpen database, and used by the API. Information actually passed by HTML is, of course, a string.
Some attributes have values that are used by default in queries, even if you do not specifically use them. For example, preowned is a filtered attribute whose default value is “false”. Not specifying preowned in your query is the same as specifying preowned=false. If you want used products returned, you must specify preowned=true. If you want used and new products returned, specify preowned=*.
In order to accommodate multiple attribute returns per item or to show relationships between attributes, some attributes have a parent-child relationship, of the form, parentAttribute.childAttribute.
When used in the request part of a query, both parent and child must be specified. Example: categoryPath.name="digital cameras". In the display part of a query (show=), specifying parent.child causes only the child attribute to be shown. Specifying just the parent name causes all children to be returned. For example, ...?show=shipping.ground returns:
In returned data, you may occasionally find an attribute that is not listed in the Data Dictionary. Usually, this is a deprecated attribute that will be removed from the API at some point. We are currently developing a deprecation policy, so you will be notified of attributes that will be removed, and when they will be removed. Deprecated attributes might no longer have valid data, and should not be used.
Other attributes may be reserved for future use. They may be supported by the API, but might not yet have any valid data. Again, these attributes should not be used.
In general, we support only those attributes that are listed in the Data Dictionary. If there is an attribute that you use regularly, but is not in the Data Dictionary, please let us know: http://www.bbyopen.com/contact.
Attribute Table Links:
Products API Attributes (click on one of the following table links)