BestBuy Product Reviews API
A GET request to our /api/getter/?platform="bestbuy_reviews" endpoint allows you to scrape customer reviews for any product listing URL on BestBuy's online store in real-time.
Example
To scrape customer reviews for the latest iPhone, you can use the following command:
1 | |
Query Parameters
As you can see in the example below, our endpoint needs the following query parameters:
Review Query
url
Required
Product listing's URL on BestBuy.com. Remove unnecessary query parameters and encode the URL.
page
Optional
The page number for which you want the results. Default value is 1.
Other Required Parameters
platform
Required
Specifies the scraping engine you wish to invoke. In this case, the value should be bestbuy_reviews.
api_key
Required
Your account's token—which can be obtained by signing up here.
Note
The value of the query parameter url must be URL or percent encoded. If you're using Python, this can be done with the function urlencode.
Results
Each request returns up to 20 reviews. The response will include the following attirbutes for each review present in the response:
| Attributes Returned | Data Type | Information Represented |
|---|---|---|
| id | string | Retailer ID of the review |
| date | string | Date when review was published |
| rating | int | Rating by reviewer |
| review_title | string | Review title |
| review_text | string | Review's text content |
| review_url | string | Link to review |
| author_name | string | Reviewer's name |
| meta_data | dict | Dict containing meta data like whether purchase is verified and user recommends product. For e.g. verified purchase status |
| lang_code | string | Country level language of review content |
Response Example
Each request returns up to 10 results. Here's the response you can expect for the request showcased above:
{
"success": true,
"url": "https://www.bestbuy.com/site/apple-iphone-13-5g-128gb-midnight-verizon/6443282.p",
"page": 1,
"total_results": 424,
"no_of_pages": 22,
"result_count": 20,
"reviews": [
{
"id": "3cb9853d-66ed-3c98-9172-434d05010397",
"date": "2022-04-10",
"rating": 5,
"review_title": "Iphone 13 review",
"review_text": "Love my new phone! I was deciding between the blue and white and am so happy I chose the white. It is so much faster than my iPhone8!",
"review_url": "https://www.bestbuy.com/site/reviews/submission/6443285/review/278244608?campaignid=RR_&return=",
"author_name": "Jodi",
"author_url": null,
"author_avatar": null,
"meta_data": {
"verified_purchase": true,
"is_recommended": true,
"upvotes": 0,
"downvotes": 0,
"secondary_ratings": {
"quality": null,
"value": null,
"ease_of_use": null
},
"days_of_ownership": 63
},
"lang_code": "en-US",
"location": null,
"response": null
},
{
"id": "8459274f-7b20-3971-96f2-5fb5feaf08be",
"date": "2022-04-10",
"rating": 5,
"review_title": "Fantastic phone with great Best Buy experience!",
"review_text": "Very happy with this phone. Upgraded from IPhone 6S and am amazed at how much better this phone is. Great price too from Best Buy and salesperson was remarkable.",
"review_url": "https://www.bestbuy.com/site/reviews/submission/6443285/review/278231593?campaignid=RR_&return=",
"author_name": "Micklovesgolf",
"author_url": null,
"author_avatar": null,
"meta_data": {
"verified_purchase": true,
"is_recommended": true,
"upvotes": 0,
"downvotes": 0,
"secondary_ratings": {
"quality": null,
"value": null,
"ease_of_use": null
},
"days_of_ownership": 30
},
"lang_code": "en-US",
"location": null,
"response": null
},
...
{
"id": "6ba3bd17-7071-3bbc-a605-ee354e6e4758",
"date": "2022-03-27",
"rating": 5,
"review_title": "Good color choice",
"review_text": "Bought this phone for my mom, she loves it and loves the color! She hasnt had any problems other than some glitches but the green looks soo good",
"review_url": "https://www.bestbuy.com/site/reviews/submission/6487362/review/277718608?campaignid=RR_&return=",
"author_name": "Mohib",
"author_url": null,
"author_avatar": null,
"meta_data": {
"verified_purchase": true,
"is_recommended": true,
"upvotes": 0,
"downvotes": 0,
"secondary_ratings": {
"quality": null,
"value": null,
"ease_of_use": null
},
"days_of_ownership": 9
},
"lang_code": "en-US",
"location": null,
"response": null
}
],
"meta_data": {}
}
Request Cost
1 credit per request.
Support
If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com