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 |
|
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. Please note that Amazon removed the ability to view reviews beyond page 10 starting July, 2023; so the max accepted value for this parameter for now is 10.
sort_by
Optional
The order in which you want the reviews to be sorted. Supported values are recent and helpful. The default value for this parameter is recent.
filter_by_star
Optional
As the name suggests, this parameter allows you to filter the reviews by star. This is one way to get more than 100 reviews for a particular product on Amazon after they removed the ability to view reviews beyond page 10. Support values are: all_stars, five_star, four_star, three_star, two_star and one_star. The default value for this parameter is all_stars.
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