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.
New! Scrape all reviews at once with Amazon Reviews Scraper
The recommended way to scrape Amazon reviews now is the Amazon Reviews Scraper. This works better because it extracts all the reviews for a listing with a single request unlike this API which requires you to loop over the page numbers manually. It can be used via API or our No-Code application.
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:
Product URL
url
Required if
Product listing's URL on Amazon. Remove unnecessary query parameters and encode the URL. If not provided, asin and country_code must be specified.
ASIN
asin
Required if url not provided
The Amazon Standard Identification Number (ASIN) for the product. Required if url is not provided.
Country Code
country_code
Optional
The 2-letter country code for the Amazon marketplace. Defaults to us if not provided. See the Supported Countries section below for valid values.
Page Number
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
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
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": 3582,
"no_of_pages": 359,
"result_count": 10,
"reviews": [
{
"id": "R38XS84K2XCTDE",
"date": "2024-08-11",
"author_name": "LUIS MARTINEZ",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AH2H4ID3XM2HL6DOAU4DMDUDUCBQ",
"rating": 5,
"review_title": "5.0 out of 5 stars\nEXELENTE",
"review_url": "https://www.amazon.com/gp/customer-reviews/R38XS84K2XCTDE/",
"review_text": "Me llegó con las condiciones que ellos solicitaban",
"review_imgs": [],
"meta_data": {
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R2Y3M19G3TR12Q",
"date": "2024-08-11",
"author_name": "Mustaf114",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHG6VHIFVTDENFMKQB2C2S5CCNLQ",
"rating": 5,
"review_title": "5.0 out of 5 stars\nGood customer quick shipping",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2Y3M19G3TR12Q/",
"review_text": "Good phone no sctruch is working",
"review_imgs": [],
"meta_data": {
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R2EH6G3EC79XBU",
"date": "2024-08-11",
"author_name": "Janet",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AG2FUGLOOOWSPZ5QLPOYGXZCYEXA",
"rating": 1,
"review_title": "1.0 out of 5 stars\nNot worth your money",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2EH6G3EC79XBU/",
"review_text": "Bought refurbished iPhone 13 a few months ago it has a lot of scratches and scuffs in the screen. now it's not working any more.",
"review_imgs": [],
"meta_data": {
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R1XHNX9G69DEL0",
"date": "2024-08-10",
"author_name": "Allison",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGQY5NEKZMROGOTJFAN5WSX7NGUQ",
"rating": 4,
"review_title": "4.0 out of 5 stars\nBought pink got red",
"review_url": "https://www.amazon.com/gp/customer-reviews/R1XHNX9G69DEL0/",
"review_text": "The only complaints are small scratches on the top corners when I paid for Excellent Condition and that it's red not pink. Overall,still happy with the purchase!",
"review_imgs": [
"https://m.media-amazon.com/images/I/61Sp9Q-iz-L._SL1600_.jpg",
"https://m.media-amazon.com/images/I/71t4kDR6cCL._SL1600_.jpg"
],
"meta_data": {
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R36KM6CFS1H7KK",
"date": "2024-08-10",
"author_name": "andy hosier",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGJM4LUNDQETYJTPPKR6XDPOIUBA",
"rating": 4,
"review_title": "4.0 out of 5 stars\nBuy!!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R36KM6CFS1H7KK/",
"review_text": "The media could not be loaded.\n \n\n\n\nIt has a tiny dent but other than that it's great.",
"review_imgs": [
"https://m.media-amazon.com/images/I/61qLb0grKHL._SL1600_.jpg"
],
"meta_data": {
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R30ZV7O0TRYHC3",
"date": "2024-08-09",
"author_name": "Louise",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AEE66FPWXSONB7U2U26K4E232KAQ",
"rating": 5,
"review_title": "5.0 out of 5 stars\nGreat shape - great price",
"review_url": "https://www.amazon.com/gp/customer-reviews/R30ZV7O0TRYHC3/",
"review_text": "Very pleased. I sure don't need or want to pay for the latest and greatest",
"review_imgs": [],
"meta_data": {
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R2HX0R5MZAR64R",
"date": "2024-08-09",
"author_name": "deb",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AFNNQQKBXEZPZTX6RYMPT6P7DI6A",
"rating": 1,
"review_title": "1.0 out of 5 stars\nDirty with large scratches",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2HX0R5MZAR64R/",
"review_text": "Charger is also not Apple.",
"review_imgs": [
"https://m.media-amazon.com/images/I/61YUEUPCHjL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/710e52c818L._SL1600_.jpg"
],
"meta_data": {
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R20TCHE4XB2XER",
"date": "2024-08-09",
"author_name": "Adrian Otañez",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AENRTFA5HJNEUNML7KBTD52DTWLQ",
"rating": 5,
"review_title": "5.0 out of 5 stars\nEXCELENTE CALIDAD",
"review_url": "https://www.amazon.com/gp/customer-reviews/R20TCHE4XB2XER/",
"review_text": "ES UNA BUENA OPCION PARA ADQUIRIR UN EQUIPO ORIGINAL EN BUEN ESTADO Y A UN BUEN PRECIO, NO TENIA NINGUN RAYÓN Y ME VINO CON 94% DE BATERÍA",
"review_imgs": [],
"meta_data": {
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R3RZ7SQ6IO2YJ6",
"date": "2024-08-09",
"author_name": "Belle",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGKZ6KF3EBW7T2AEMOK2WQ5BYL4Q",
"rating": 5,
"review_title": "5.0 out of 5 stars\nDefinitely a must..you need to order one",
"review_url": "https://www.amazon.com/gp/customer-reviews/R3RZ7SQ6IO2YJ6/",
"review_text": "I love the quality and it had an 86% battery health. It had an easy transfer and for an acceptable refurbished phone, its actually perfect. No scratches on the lens corners or screen. Love the quality once again. Everyone needs to order and this is worth the price.",
"review_imgs": [
"https://m.media-amazon.com/images/I/61NObl9Jf+L._SL1600_.jpg"
],
"meta_data": {
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R2ZDX4H4G6VP1Q",
"date": "2024-08-09",
"author_name": "Jose",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AF33MNVFE6W2RX4U5AOBME5HHL7Q",
"rating": 1,
"review_title": "1.0 out of 5 stars\nknow that you are buying a head ache.",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2ZDX4H4G6VP1Q/",
"review_text": "I bought this phone and went to get it activated. AT&T could not activated because this phone is locked. I paid good money for a phone that I can use but I paid $300 for something useless. Be aware and look somewhere else unless you have money you don't need and time you don't need",
"review_imgs": [],
"meta_data": {
"verified_purchase": true
},
"location": "United States"
}
],
"meta_data": {
"total_ratings": 10919,
"rating_distribution": {
"5 star": "65%",
"4 star": "13%",
"3 star": "6%",
"2 star": "4%",
"1 star": "12%"
}
},
"remaining_credits": 619880
}
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 |
| Canada | Amazon.ca | ca |
| UK | Amazon.co.uk | gb |
| France | Amazon.fr | fr |
| Germany | Amazon.de | de |
| Spain | Amazon.es | es |
| Japan | Amazon.co.jp | jp |
| Australia | Amazon.au | au |
| India | Amazon.in | in |
| Brazil | Amazon.br | br |
If you don't see the country you need data from, please contact us at support@unwrangle.com.
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