Skip to content

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
curl -v -L 'https://data.unwrangle.com/api/getter/?platform=bestbuy_reviews&url=https%3A%2F%2Fwww.bestbuy.com%2Fsite%2Fapple-iphone-13-5g-128gb-midnight-verizon%2F6443282.p&api_key=API_KEY'

Note

When using curl, it is necessary to add the option -L to get the data back. This is because in some cases our server responds with a 301 and curl does not follow the redirect by default.

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

Each request returns up to 20 reviews and costs 10 credits or 1 credit per review, whichever is higher.

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