Skip to content

Amazon Product Reviews API

A GET request to our /api/getter/?platform="amazon_reviews" endpoint allows you to scrape customer reviews for any product listing URL on BestBuy.com 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=amazon_reviews&url=https%3A%2F%2Fwww.amazon.com%2FApple-iPhone-13-128GB-Blue%2Fdp%2FB09LNX6KQS%2F&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 Amazon. 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 amazon_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

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
author_name string Reviewer's name
author_url string Reviewer's retailer profile link
rating int Rating by reviewer
review_title string Review title
review_url string Link to review
review_text string Review's text content
review_imgs list Links to reviewer's images, if any
meta_data dict Dict containing meta data. For e.g. verified purchase status
location string Country level location of reviewer

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.amazon.com/Apple-iPhone-13-128GB-Blue/dp/B09LNX6KQS/",
    "page": 1,
    "total_results": 10,
    "no_of_pages": 1,
    "result_count": 10,
    "reviews": [
        {
            "id": "RGIQ9FIJEL8RU",
            "date": "2022-04-02",
            "author_name": "cupofjoe",
            "author_url": "https://www.amazon.com/gp/profile/amzn1.account.AE3BG7DC5SKCKTMJW7YDNL6EQ4AQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
            "rating": 2,
            "review_title": "iPhone 13 disappointing, should have kept XS",
            "review_url": "https://www.amazon.com/gp/customer-reviews/RGIQ9FIJEL8RU/",
            "review_text": "First I’ll say that I like the MagSafe chargers that are also available on the 12, besides that this phone is worse than the XS. The camera is not good at taking close ups, the battery lasts a day if I have it on low power mode and close apps I’m not using. 5G is obviously not ready for the public and I’ve never had to restart my phones this often either.",
            "review_imgs": [],
            "meta_data": {
                "verified_purchase": false
            },
            "location": "United States"
        },
        {
            "id": "RF06FKQOWDFPM",
            "date": "2022-03-31",
            "author_name": "Euniah ",
            "author_url": "https://www.amazon.com/gp/profile/amzn1.account.AH4OZVIERMUR7TDT3YC3NWX6JHGQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
            "rating": 5,
            "review_title": "looks new",
            "review_url": "https://www.amazon.com/gp/customer-reviews/RF06FKQOWDFPM/",
            "review_text": "Someone Could barely recognise it as renewed phone looks brand new",
            "review_imgs": [],
            "meta_data": {
                "verified_purchase": true
            },
            "location": "United States"
        },
        ...
        {
            "id": "R1XOIN0KQQ0ZWS",
            "date": "2022-03-08",
            "author_name": "Katrina Weiler",
            "author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGUM57Y5ET2HCEBULESUHMGISBUQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
            "rating": 5,
            "review_title": "amazing iphone",
            "review_url": "https://www.amazon.com/gp/customer-reviews/R1XOIN0KQQ0ZWS/",
            "review_text": "The phone itself arrived with extremely small and unnoticeable scratches, the rest of it was perfect. The camera is super high-quality and I didn’t notice any issues with setting it up. Everything works perfectly and I’m extremely excited about my new iPhone. It comes with a charger brick and a charger along with the Sim card remover.",
            "review_imgs": [],
            "meta_data": {
                "verified_purchase": true
            },
            "location": "United States"
        }
    ],
    "meta_data": {
        "total_ratings": 25
    }
}

Request Cost

Each request returns up to 10 reviews and costs 10 credits.

Supported Countries

The countries we support to scrape Amazon's search results from are listed below:

Country Domain Code
USA Amazon.com us
UK Amazon.co.uk gb
France Amazon.fr fr
Germany Amazon.de de
India Amazon.in in
Australia Amazon.au au

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