Best Buy API Features: Query by Product Attribute

Julie Muraski
Best Buy Developers
2 min readMar 26, 2015

--

Best Buy has 200+ attributes and most are queryable. We detail the Products API attributes in our Products API documentation. The attributes are sorted into like attributes. As an example, all attributes that describe a product are in our Products Detail section; or anything related to pricing is in our Pricing and Sales Ranking section.

You can query across most of our attributes (those attributes that are not queryable are identified in the Attribute Detail section of each attribute). Your queries can involve multiple attributes in a single request. This allows users to search for information about the product itself. Searchers aren’t limited to Best Buy info like SKU and sub-categories, and instead can search real-world concepts like refrigerator storage size or laptop memory. These searches can also be combined to produce richer and more specific results.

Example

A TV search can be refined to return only products top-rated by our customers, with a screen size greater than 40" and less than 50" at a store within 50 miles of the searcher. That’s some impressive specificity, if we do say so ourselves.

Anatomy of a Request baseURL : `http://api.remix.bestbuy.com/v1/` storeQuery : `stores(area(55423,5))` productQuery : `+products(categoryPath.id=abcat0100000&customerReviewAverage>=4&customerReviewCount>=50&screenSizeIn>=40&screenSizeIn<=50)` APIKey : `?apiKey=YourAPIKey` showOptions : `&show=name,products.sku,products.name,products.customerReviewCount,products.customerReviewAverage,products.screenSizeIn` responseFormat : `&format=json`

Full URL

fullURL : `http://api.remix.bestbuy.com/v1/stores(area(55423,5))+products(categoryPath.id=abcat0100000&customerReviewAverage>=4&customerReviewCount>=50&screenSizeIn>=40&screenSizeIn<=50)?apiKey=YourAPIKey&show=name,products.sku,products.name,products.customerReviewCount,products.customerReviewAverage,products.screenSizeIn&format=json`
```

--

--