Reviews API

The Reviews API provides access to individual consumer reviews that have been submitted on BESTBUY.COM for the products we sell. You can use it to retrieve information such as the author of the review, the date that the review was submitted, the reviewer's rating (0-5 where 5 is the best) of a product and the reviewer's comments about the product.

Both real-time calls and archives are available for Reviews data. These are updated daily. Refer to archives for documentation on our archives.

Description

The Reviews data include the review ID, author info, reviewer rating for a product, comments submitted and the time of submission for each review.

The following examples explain how to query for review information using various attributes:

The Reviews API provides details of the reviews submitted for a product based on the SKU ID. If you would like to know more about the product specific information please refer to the Products API documentation.

Attributes

Hint: If you would like additional information about an attribute, including examples, detailed descriptions and any special considerations when using the attribute, please click on the attribute name.

NameDescriptionType
commentcomment left by the reviewerstring
idunique review identifierinteger
ratingaverage "score" or ratings as submitted by reviewersfloat
reviewer.namename of the reviewerstring
skuSKU identifier for a productlong
submissionTimereview submission timedate
titletitle of the reviewstring

comment

The comment attribute provides a detailed review on a product.

Type
string
Example
I use it for reading and web browsing ad I love it.
Back To Attributes

id

The ID attribute provides a unique review identifier for each review submitted.

Type
integer
Example
22250776
Back To Attributes

rating

The rating attribute provides an average of all the ratings submitted for a product by reviewers. The ratings that can be submitted using a range from zero to five where five is the best rating that can be given. Ratings may be returned using decimals (example 3.5).

Type
float
Example
4
Back To Attributes

sku

The SKU attribute provides the SKU identifier for the product of a review.

Type
long
Notes
For more product information please refer to the Products API and the sku attribute.
Example
1780275
Back To Attributes

title

The title attribute provides the title of the review given by the reviewer.

Type
string
Example
Easy to use. Lighter than my last IPad
Back To Attributes

Request/Response Examples

Returns all reviews

The below query retrieves all the reviews submitted for the products we sell on BESTBUY.COM Return to Description

#request:
http://api.bestbuy.com/v1/reviews?format=json&apiKey=YourAPIKey

#response:
{ "from": 1, "to": 10, "total": 941743, "currentPage": 1, "totalPages": 94175, "queryTime": "0.045", "totalTime": "0.049", "partial": false, "canonicalUrl": "/v1/reviews?format=json&apiKey=YourAPIKey", "reviews": [ { "id": 24798186, "sku": 3764993, "reviewer": [ { "name": "1cowgirl" } ], "aboutMe": [ ], "rating": 4.0, "title": "Good keyboard", "comment": "I bought this along with my laptop. I use it all of the time.", "submissionTime": "2014-04-29T22:40:33" } ...
#request:
http://api.bestbuy.com/v1/reviews?apiKey=YourAPIKey

#response:
<reviews currentPage="1" totalPages="94175" from="1" to="10" total="941743" queryTime="0.048" totalTime="0.054" canonicalUrl="/v1/reviews?apiKey=YourAPIKey partial="false"> <review> <id>24798186</id> <sku>3764993</sku> <reviewer> <name>1cowgirl</name> </reviewer> <aboutMe/> <rating>4.0</rating> <title>Good keyboard</title> <comment>I bought this along with my laptop. I use it all of the time.</comment> <submissionTime>2014-04-29T22:40:33</submissionTime> </review> <review> <id>24798180</id> <sku>9071056</sku> <reviewer> <name>Bates58</name> </reviewer> <aboutMe/> <rating>4.0</rating> <title>Simple technology with big impact</title> <comment>This new technology works as promised, solves a need tech consumers have been asking for, simple plug and play dongle connects wirelessly to broadcast computer screen to TV. Also has several apps that make broadcasting YouTube, Netflix and other programs seamlessly. Only drawback I have found is that secondary pop-up windows do not sync, remains on the main page. This does present problems on certain sites that use pop-up to stream videos.</comment> <submissionTime>2014-04-29T22:39:46</submissionTime> </review> ...

Returns reviews for a specific product

The below query retrieves all the reviews submitted for the product specified in the input. Note: If the input SKU is invalid or if there are no reviews submitted then a blank page is returned. An error will not be generated. Return to Description

#request:
http://api.bestbuy.com/v1/reviews(sku=1780275)?format=json&apiKey=YourAPIKey&show=id,sku

#response:
{ "from": 1, "to": 10, "total": 58, "currentPage": 1, "totalPages": 6, "queryTime": "0.003", "totalTime": "0.007", "partial": false, "canonicalUrl": "/v1/reviews(sku=1780275)?show=id,sku&format=json&apiKey=YourAPIKey", "reviews": [ { "id": 24184800, "sku": 1780275 }, { "id": 23808974, "sku": 1780275 }, { "id": 23569339, "sku": 1780275 }, { "id": 22963371, "sku": 1780275 } ...
#request:
http://api.bestbuy.com/v1/reviews(sku=1780275)?apiKey=YourAPIKey&show=id,sku

#response:
<reviews currentPage="1" totalPages="6" from="1" to="10" total="58" queryTime="0.003" totalTime="0.008" canonicalUrl="/v1/reviews(sku=1780275)?show=id,sku&amp;apiKey=YourAPIKey" partial="false"> <review> <id>24184800</id> <sku>1780275</sku> </review> <review> <id>23808974</id> <sku>1780275</sku> </review> <review> <id>23569339</id> <sku>1780275</sku> </review> <review> <id>22963371</id> <sku>1780275</sku> </review> <review> <id>22957553</id> <sku>1780275</sku> </review> <review> <id>22727976</id> <sku>1780275</sku> </review> ...

Returns reviews for a list of products

The below query retrieves all the reviews submitted for a list of the SKUs specified in the input. Return to Description

#request:
http://api.bestbuy.com/v1/reviews(sku%20in(1722009,1751791,1722018,1752291,1729354))?format=json&apiKey=YourAPIKey&show=id,sku

#response:
{ "from": 1, "to": 10, "total": 520, "currentPage": 1, "totalPages": 52, "queryTime": "0.007", "totalTime": "0.012", "partial": false, "canonicalUrl": "/v1/reviews(sku in(1722009,1751791,1722018,1752291,1729354))?show=id,sku&format=json&apiKey=YourAPIKey", "reviews": [ { "id": 24797093, "sku": 1722018 }, { "id": 24744919, "sku": 1722018 }, { "id": 24664873, "sku": 1722009 }, { "id": 24658237, "sku": 1722018 } ...
#request:
http://api.bestbuy.com/v1/reviews(sku%20in(1722009,1751791,1722018,1752291,1729354))?apiKey=YourAPIKey

#response:
<reviews currentPage="1" totalPages="52" from="1" to="10" total="520" queryTime="0.006" totalTime="0.010" canonicalUrl="/v1/reviews(sku in(1722009,1751791,1722018,1752291,1729354))?show=id,sku&amp;apiKey=YourAPIKey" partial="false"> <review> <id>24797093</id> <sku>1722018</sku> </review> <review> <id>24744919</id> <sku>1722018</sku> </review> <review> <id>24664873</id> <sku>1722009</sku> </review> <review> <id>24658237</id> <sku>1722018</sku> </review> <review> <id>24649493</id> <sku>1722018</sku> </review> <review> <id>24648729</id> <sku>1752291</sku> </review> --- http://api.bestbuy.com/v1/reviews(sku%20in(1722009,1751791,1722018,1752291,1729354))?apiKey=YourAPIKey --- <reviews currentPage="1" totalPages="52" from="1" to="10" total="520" queryTime="0.006" totalTime="0.010" canonicalUrl="/v1/reviews(sku in(1722009,1751791,1722018,1752291,1729354))?show=id,sku&amp;apiKey=b6qgvh88dwuc26hssgp2cb4a" partial="false"> <review> <id>24797093</id> <sku>1722018</sku> </review> <review> <id>24744919</id> <sku>1722018</sku> </review> <review> <id>24664873</id> <sku>1722009</sku> </review> <review> <id>24658237</id> <sku>1722018</sku> </review> <review> <id>24649493</id> <sku>1722018</sku> </review> <review> <id>24648729</id> <sku>1752291</sku> </review> ...

Returns products with a rating higher than 4.0

The below query retrieves all the reviews with ratings > 4.0. Return to Description

#request:
http://api.bestbuy.com/v1/reviews(rating%3E4.0)?format=json&apiKey=YourAPIKey

#response:
{ "from": 1, "to": 10, "total": 610215, "currentPage": 1, "totalPages": 61022, "queryTime": "0.070", "totalTime": "0.075", "partial": false, "canonicalUrl": "/v1/reviews(rating>4.0)?format=json&apiKey=YourAPIKey", "reviews": [ { "id": 24798165, "sku": 2601005, "reviewer": [ { "name": "Folafemi" } ], "aboutMe": [ ], "rating": 5.0, "title": "The Galaxy Tab has been a great learning device", "comment": "Overall, the products is a great one for children, my kids are fond of it, and they get the best out of its apps. It a product to recommend to others.", "submissionTime": "2014-04-29T22:35:52" } ...
#request:
http://api.bestbuy.com/v1/reviews(rating%3E4.0)?apiKey=YourAPIKey

#response:
<reviews currentPage="1" totalPages="61022" from="1" to="10" total="610215" queryTime="0.079" totalTime="0.085" canonicalUrl="/v1/reviews(rating&gt;4.0)?apiKey=YourAPIKey partial="false"> <review> <id>24798165</id> <sku>2601005</sku> <reviewer> <name>Folafemi</name> </reviewer> <aboutMe/> <rating>5.0</rating> <title>The Galaxy Tab has been a great learning device</title> <comment>Overall, the products is a great one for children, my kids are fond of it, and they get the best out of its apps. It a product to recommend to others.</comment> <submissionTime>2014-04-29T22:35:52</submissionTime> </review> <review> <id>24798160</id> <sku>6639547</sku> <reviewer> <name>Vilkins123</name> </reviewer> <aboutMe/> <rating>5.0</rating> <title>Love this set of Headphones</title> <comment>Love these headphones, good clear audio, strong but not overpowering bass response.</comment> <submissionTime>2014-04-29T22:34:42</submissionTime> </review> ...

Returns reviews submitted on a specific date

The below query retrieves all the reviews submitted on a specific date. Return to Description

#request:
http://api.bestbuy.com/v1/reviews(submissionTime=2014-04-29)?format=json&apiKey=YourAPIKey

#response:
{ "from": 1, "to": 10, "total": 995, "currentPage": 1, "totalPages": 100, "queryTime": "0.004", "totalTime": "0.009", "partial": false, "canonicalUrl": "/v1/reviews(submissionTime=2014-04-29)?format=json&apiKey=YourAPIKey", "reviews": [ { "id": 24798186, "sku": 3764993, "reviewer": [ { "name": "1cowgirl" } ], "aboutMe": [ ], "rating": 4.0, "title": "Good keyboard", "comment": "I bought this along with my laptop. I use it all of the time.", "submissionTime": "2014-04-29T22:40:33" } ...
#request:
http://api.bestbuy.com/v1/reviews(submissionTime=2014-04-29)?apiKey=YourAPIKey

#response:
<reviews currentPage="1" totalPages="100" from="1" to="10" total="995" queryTime="0.003" totalTime="0.010" canonicalUrl="/v1/reviews(submissionTime=2014-04-29)?apiKey=YourAPIKey partial="false"> <review> <id>24798186</id> <sku>3764993</sku> <reviewer> <name>1cowgirl</name> </reviewer> <aboutMe/> <rating>4.0</rating> <title>Good keyboard</title> <comment>I bought this along with my laptop. I use it all of the time.</comment> <submissionTime>2014-04-29T22:40:33</submissionTime> </review> <review> <id>24798180</id> <sku>9071056</sku> <reviewer> <name>Bates58</name> </reviewer> <aboutMe/> <rating>4.0</rating> <title>Simple technology with big impact</title> <comment>This new technology works as promised, solves a need tech consumers have been asking for, simple plug and play dongle connects wirelessly to broadcast computer screen to TV. Also has several apps that make broadcasting YouTube, Netflix and other programs seamlessly. Only drawback I have found is that secondary pop-up windows do not sync, remains on the main page. This does present problems on certain sites that use pop-up to stream videos.</comment> <submissionTime>2014-04-29T22:39:46</submissionTime> ...
Best Buy logo

We do not support your browser. Neither does Microsoft.

We're glad that you're excited about Best Buy's APIs. However, you're using a browser that's too old to view our new developer site. We encourage you to switch to a newer browser, preferably a recent version of Chrome, Firefox, or Internet Explorer.