In addition to being the largest e-commerce platform, Amazon is also a place where buyers share their opinions on the products they purchase. It makes the marketplace a great source of feedback data that can be used in various ways: from developing a review management tool to training an NLP model.
Now you can finally access this data!
We’re glad to announce that we have enriched our Merchant API with the Amazon Reviews endpoints, enabling you to collect customer feedback on any product stored on Amazon.
Collect Amazon reviews with ease
1 Call the Amazon Reviews Task POST endpoint.
POST https://api.dataforseo.com/v3/merchant/amazon/reviews/task_post
2 Specify the ASIN of a product you want to get reviews for in the asin field. In case you don’t know what ASIN is and where to find it, check this help center article.
3 Specify the location parameters by adding the location_name, location_coordinate or location_code field to the POST body.
You will receive the full list of available locations by making a separate request to the Locations endpoint.
GET https://api.dataforseo.com/v3/merchant/amazon/locations
4 Specify the language parameters by adding the language_name or language_code field to the POST body.
You will receive the full list of available languages by making a separate request to the Languages endpoint.
GET https://api.dataforseo.com/v3/merchant/amazon/languages
5 Specify the number of reviews to be returned in the API response. To do that, add the depth parameter and set it to the desired value.
We strongly recommend setting the parsing depth in the multiples of ten as our system processes ten reviews in a row. In other words, you will be charged for every 10 reviews returned. Thus, if you specify depth as 11 you will be charged for 20 reviews.
Default depth value: 10.
Your POST request should be structured as in the following example:
[
{
"language_code": "en_US",
"location_code": 2840,
"asin": "B0773ZY26F",
"depth": 10
}
]
Once the request is set, send it to the API and copy the task ID. Using it, collect the results with the Amazon Reviews Task GET endpoint.
GET https://api.dataforseo.com/v3/merchant/amazon/reviews/task_get/advanced/$id
Example of the API response:
{
"version": "0.1.20220407",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1241 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "04121703-2806-0415-0000-53557c13150d",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0580 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"merchant",
"amazon",
"reviews",
"task_get",
"advanced",
"04121703-2806-0415-0000-53557c13150d"
],
"data": {
"se_type": "reviews",
"api": "merchant",
"function": "reviews",
"se": "amazon",
"language_code": "en_US",
"location_code": 2840,
"asin": "B0773ZY26F",
"depth": 10,
"device": "desktop",
"os": "windows"
},
"result": [
{
"asin": "B0773ZY26F",
"type": "reviews",
"se_domain": "amazon.com",
"location_code": 2840,
"language_code": "en_US",
"check_url": "https://www.amazon.com/product-reviews/B0773ZY26F?ie=UTF8&pageNumber=1&language=en_US",
"datetime": "2022-04-12 14:03:27 +00:00",
"spell": null,
"title": "Sceptre 24\" Professional Thin 75Hz 1080p LED Monitor 2x HDMI VGA...",
"image": {
"type": "images_element",
"alt": "Sceptre 24\" Professional Thin 75Hz 1080p LED Monitor 2x HDMI VGA Build-in Speakers, Machine Black (E248W-19203R Series)",
"url": "https://amazon.com/Sceptre-E248W-19203R-Monitor-Speakers-Metallic/dp/B0773ZY26F",
"image_url": "https://m.media-amazon.com/images/I/51pUnYYWQBL._AC_US60_SCLZZZZZZZ__.jpg"
},
"rating": {
"type": "rating_element",
"position": "left",
"rating_type": "Max5",
"value": "4.6",
"votes_count": 17823,
"rating_max": "5"
},
"reviews_count": 2397,
"item_types": [
"amazon_review_item"
],
"items_count": 10,
"items": [
{
"type": "amazon_review_item",
"rank_group": 1,
"rank_absolute": 1,
"position": "right",
"xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[5]/div[3]/div[1]/div[1]/div[1]/div[1]",
"verified": true,
"subtitle": "Reviewed in the United States on March 24, 2018",
"helpful_votes": 819,
"images": null,
"videos": null,
"user_profile": {
"name": "John Moran",
"avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/default._CR0,0,1024,1024_SX48_.png",
"url": "https://amazon.com/gp/profile/amzn1.account.AE2OKUHR3BUNQNESEXOXM4SE466Q",
"reviews_count": null,
"locations": null
},
"title": "I am extremelly impressed with this monitor! Great buy specially for gaming!",
"url": "https://amazon.com/gp/customer-reviews/RD10DVV2K8F00?ASIN=B0773ZY26F",
"review_text": "I have a GTX 1060 laptop, set up is easy and there was no need for me to calibrate anything, I even dare say this monitor looks better than my own laptop screen at 1080p.\nAt first i thought it didn not support 75Hz and the colors were washed out and it was too bright, also on the nvidia panel it said 1080p at 60Hz however this is what you gotta do to fix it.\n\"CALIBRATION\"\n1. Connect via HDMI\n2. Open Display settings and make sure that they are set so that only the 2nd display is turned on, do not put duplicate or extend.\n3. Open Nvidia control panel and go to \"Change Resolution\"\n4. You will see two lists, one will say HD, UHD etc, the other one at the bottom will say \"PC\", (changing the first list will project your laptop screen to the second screen however your laptop is 60Hz and the monitor is 75Hz that is why its limited to 60Hz and colors are washed out, changing the second list will basically use your laptop to power up the monitor at full 75Hz 1080p with the right color calibration.)\n5. On list two \"PC\" change the resolution to 1080p and 75Hz\nAnd there you go, now you can use your 75Hz monitor for gaming, make sure to change the settings indvidually in games to 75Hz or they will still run at 60Hz and the colors will be washed out.\nNow onto the review\n*** REVIEW ***\nThe screen resolution is full 1920x1080p at 75Hz, the colors are very accurate, it looks no where near like a TN panel, I would say its in between a TN panel and an IPS panel but closer to IPS.\nIt comes with speakers which are ok for the price but I recommend headphones or your own speakers which are probably better if you got this for gaming.\nThis is what comes in the package\n- Monitor\n- 4 screws for mounting\n- Two screws for setting up the monitor (non adjustable height(\n- HDMI to VGA cable\n- VGA to VGA cable\nI really recommend this monitor even if not for gaming, its a great price for what you get and it even comes with two cables.\nHowever one thing to note is that the difference between 60Hz and 75Hz is hard to notice in games. Playing Witcher 3 and Rise of Tomb Raider at locked in 75FPS wasn't anything much more amazing than 60FPS. However it is still an improvement.\nOne last thing to confider if you’re debating on a 75Hz vs 144Hz monitor\n- If you have a graphics card such as the GTX 770,970,1060 Most games (witcher, call of duty, battlefield wont go back 80 fps on ultra / high graphics) so you wont be able to take advantage of a 144Hz monitor, so I suggest this one. UNLESS you play on medium/low settings.\n- If you have a graphics card such as a GTX 770,780,980,1070 and above, I suggest the 144Hz monitor since these can run most tiles at well above 100FPS so you can take advantage of the monitor.\n*** UPDATE ***\nEarlier on the review I said the difference between 60Hz and 75Hz was negligible, I take it back.\nI played on my laptop which is limited to 60Hz and it feels bad and slugish compared to 75Hz, once you go higher refresh rate you can never go back\nIts one of those things you dont realise until its taken away, great improvement.",
"publication_date": "2018-03-24 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "amazon_review_item",
"rank_group": 2,
"rank_absolute": 2,
"position": "right",
"xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[5]/div[3]/div[1]/div[2]/div[1]/div[1]",
"verified": true,
"subtitle": "Reviewed in the United States on May 16, 2018",
"helpful_votes": 364,
"images": null,
"videos": [
{
"type": "video_element",
"source": "https://images-na.ssl-images-amazon.com/images/I/A1FKvO7s9aS.mp4",
"preview": "https://images-na.ssl-images-amazon.com/images/I/71KG2tX0obS._SY256.png"
}
],
"user_profile": {
"name": "Krassodo",
"avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/9838d2ea-3833-4fff-b106-73ad2f27501d._CR0,0,500,500_SX48_.jpg",
"url": "https://amazon.com/gp/profile/amzn1.account.AFY4NJGGBIHRJE3A773RXALIYYPA",
"reviews_count": null,
"locations": null
},
"title": "I like it but I don't love it....for good reasons",
"url": "https://amazon.com/gp/customer-reviews/R1B458N58WNZA8?ASIN=B0773ZY26F",
"review_text": "The monitor is great for pc and console gaming. My PC pc is able to take advantage of the 75hz refresh rate, the auto power on and auto source switching is convenient. The audio out port also saves me a lot of effort with my setup. Where this device looses stars is the defects. There is an over brighten set of pixels, fortunately they are only visible on all white screens. There is also this mark that looks as though there is a piece of plastic on the screen. I am not some professional gamer or content creater so I don't want to go through the hassell or requesting a new one. Im still going to use it and appreciate the good things about it. 5 stars if it did not have these scars.",
"publication_date": "2018-05-16 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 3,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "amazon_review_item",
"rank_group": 3,
"rank_absolute": 3,
"position": "right",
"xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[5]/div[3]/div[1]/div[3]/div[1]/div[1]",
"verified": true,
"subtitle": "Reviewed in the United States on February 16, 2018",
"helpful_votes": 447,
"images": [
{
"type": "images_element",
"alt": "Customer image",
"url": null,
"image_url": "https://images-na.ssl-images-amazon.com/images/I/81A5TsfU3dL._SY88.jpg"
}
],
"videos": null,
"user_profile": {
"name": "JMinton",
"avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars/default._CR0,0,1024,1024_SX48_.png",
"url": "https://amazon.com/gp/profile/amzn1.account.AHSRKZ6ZKOK3MZ6PEH6B5KQTJ2MA",
"reviews_count": null,
"locations": null
},
"title": "My go-to for office monitors.",
"url": "https://amazon.com/gp/customer-reviews/R35YK7MY1BTNMK?ASIN=B0773ZY26F",
"review_text": "Needed two new monitors for a new PC in the office. Went with this because it was the best value in terms of size vs price. I'd also purchased these for clients in the past and heard they were happy with them. After seeing the complaints about the colors being washed out, I gave my monitors away and decided if there were any problems with these I'd either live with it or fix it.\nOut of the box the monitors were fine. The only complaint I can come up with is that the VESA mounts are lower on the back due to the slim design. After looking at settings, I determined that for me as an IT manager I didn't need to recalibrate the screens at all. Granted, I spend most of my time looking at text documents, configuration pages for network equipment, and the accounting software my company uses. I couldn't speak to color calibration for individuals doing video or photo production.\nOne thought on the others experiencing washed out colors - HDMI out on a computer kind of expects a TV. Televisions and Monitors will sometimes have different ranges for black levels, which can cause the screen to look washed out. If you're experiencing this, check the control panel for your graphics driver. You should be able to adjust black levels and fix the issue. This has been a driving factor in my preference for just about anything over HDMI. (Display Port is king, for what it's worth.)",
"publication_date": "2018-02-16 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "amazon_review_item",
"rank_group": 4,
"rank_absolute": 4,
"position": "right",
"xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[5]/div[3]/div[1]/div[4]/div[1]/div[1]",
"verified": true,
"subtitle": "Reviewed in the United States on April 19, 2020",
"helpful_votes": 163,
"images": null,
"videos": null,
"user_profile": {
"name": "tevepaugh",
"avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/b9027d72-c686-4770-8463-ba207b7f2282._CR0,0,374,374_SX48_.jpg",
"url": "https://amazon.com/gp/profile/amzn1.account.AEOD5DMP55ZOAGWTE5FK537PT4RA",
"reviews_count": null,
"locations": null
},
"title": "Just calm down, It's was only $104.",
"url": "https://amazon.com/gp/customer-reviews/R248A153YA65JK?ASIN=B0773ZY26F",
"review_text": "If you are rating this like you ordered a $500 top of the line gaming monitor, then it's YOU that has issues, not the product. For under $120 this monitor well surpassed my expectations initially, as for longevity, we'll see. Great picture quality, thin appearance, and pretty small bezels. Came with HDMI cord (wasn't expecting that) and spacers for wall mounts/other mounting kits. Usable UI for adjustments if that's your thing. I honestly just set it up, plugged it in and bobs you're uncle. Again, it was only $104 when I ordered it, so this review is based on that. What else can be said? 24 inches is 24 inches, 75 hertz is 75 hertz, colors are colored and cords do cord things! For the price, it's definitely recommended and expectations where exceeded. Don't buy a monitor under $120 and try to review it like a $500 god-like gaming accessory.\nSo to recap, the monitor monitors, cords cord, and the stand stands. Cough into you elbow, stop driving 100mph and don't go to Walmart just to browse the electronics during a pandemic.\nUpdate- Jan 2021-\nturns out that you shouldn't sit near anything valuable while in vr. Still worked great even after I had smacked/punched it accidentally in vr......well at least the first 8 or 9 times anyway. The last hit did it in for good unfortunately but clearly not at all any fault of the brand. So, don't tell yourself you'll not do something again(sit to close to the monitor) but then repeatedly do it again and again expecting a different outcome. Wait, what's the definition of insanity again? 🤔",
"publication_date": "2020-04-19 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "amazon_review_item",
"rank_group": 5,
"rank_absolute": 5,
"position": "right",
"xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[5]/div[3]/div[1]/div[5]/div[1]/div[1]",
"verified": true,
"subtitle": "Reviewed in the United States on April 20, 2018",
"helpful_votes": 199,
"images": null,
"videos": null,
"user_profile": {
"name": "Michael Molter",
"avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars/default._CR0,0,1024,1024_SX48_.png",
"url": "https://amazon.com/gp/profile/amzn1.account.AHAFM4X6HZA37TETVWKNPRVCCGEA",
"reviews_count": null,
"locations": null
},
"title": "Great for productive dual monitor setups",
"url": "https://amazon.com/gp/customer-reviews/R15W1WLL38CTL9?ASIN=B0773ZY26F",
"review_text": "When I bought these monitors, I was looking for something big enough, good enough and cheap enough. These were perfect.\nThey may not be best-in-class for color and contrast, but definitely not bad by any definition. I use them for programming, YouTube, and Office primarily, and they look great for that. If you a hard-core movie watcher/gamer and want the most superb image quality, maybe move on, but if you've just been thinking about doing a dual monitor setup, but didn't want to spend the money--just buy these. They're worth it.",
"publication_date": "2018-04-20 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 4,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "amazon_review_item",
"rank_group": 6,
"rank_absolute": 6,
"position": "right",
"xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[5]/div[3]/div[1]/div[6]/div[1]/div[1]",
"verified": true,
"subtitle": "Reviewed in the United States on March 21, 2018",
"helpful_votes": 196,
"images": null,
"videos": null,
"user_profile": {
"name": "Daniel Pena",
"avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/default._CR0,0,1024,1024_SX48_.png",
"url": "https://amazon.com/gp/profile/amzn1.account.AFRB3XBYHNIEPTBOOOQNBU3KE5AQ",
"reviews_count": null,
"locations": null
},
"title": "Just got two of these bad boys. pulled them out of the box added ...",
"url": "https://amazon.com/gp/customer-reviews/R2JKIF78B0AASA?ASIN=B0773ZY26F",
"review_text": "Just got two of these bad boys. pulled them out of the box added the thread extenders put them on my monitor tree. Set up was easy, resolution is perfect for my needs (Business). Did some initial setup with adjusting the view area of the screen but the auto adjustment made that very simple. I use the VGA connections so can't speak to the HDMI but for the Price these are amazing. One thing that I will mention is that they use a proprietary Power cord but that is more just for information it has a very large plug so you will need to account for that when planning your Power set up.",
"publication_date": "2018-03-21 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 5,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "amazon_review_item",
"rank_group": 7,
"rank_absolute": 7,
"position": "right",
"xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[5]/div[3]/div[1]/div[7]/div[1]/div[1]",
"verified": true,
"subtitle": "Reviewed in the United States on April 28, 2018",
"helpful_votes": 164,
"images": null,
"videos": null,
"user_profile": {
"name": "C D",
"avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/default._CR0,0,1024,1024_SX48_.png",
"url": "https://amazon.com/gp/profile/amzn1.account.AEV3JX5DPKFZGHKV4FY6BCFRZKKA",
"reviews_count": null,
"locations": null
},
"title": "This is a poor quality product",
"url": "https://amazon.com/gp/customer-reviews/R2K49LAQ53HS0T?ASIN=B0773ZY26F",
"review_text": "The first monitor I got had a few bright spots in it, I figured it was just fluke and asked to have a new one sent to me. The new one they sent me has 3 really apparent bright spots and 5 that the average user might not immediately notice. I work in the laptop refurb business and look at screen regularly to asses their value. Based on the standards we use these screens are the lowest level you can rate.",
"publication_date": "2018-04-28 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 1,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "amazon_review_item",
"rank_group": 8,
"rank_absolute": 8,
"position": "right",
"xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[5]/div[3]/div[1]/div[8]/div[1]/div[1]",
"verified": true,
"subtitle": "Reviewed in the United States on November 30, 2018",
"helpful_votes": 106,
"images": [
{
"type": "images_element",
"alt": "Customer image",
"url": null,
"image_url": "https://images-na.ssl-images-amazon.com/images/I/615n8jmVsAL._SY88.jpg"
},
{
"type": "images_element",
"alt": "Customer image",
"url": null,
"image_url": "https://images-na.ssl-images-amazon.com/images/I/71yROmFPOGL._SY88.jpg"
},
{
"type": "images_element",
"alt": "Customer image",
"url": null,
"image_url": "https://images-na.ssl-images-amazon.com/images/I/81VZhGsq5VL._SY88.jpg"
}
],
"videos": null,
"user_profile": {
"name": "Phil Mendoza",
"avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/default._CR0,0,1024,1024_SX48_.png",
"url": "https://amazon.com/gp/profile/amzn1.account.AGEGZNPH6R6KPPIBNRKYLAQCBMBQ",
"reviews_count": null,
"locations": null
},
"title": "Black line of dead pixels after 2 HOURS of use",
"url": "https://amazon.com/gp/customer-reviews/R30SVHA4AOV0XH?ASIN=B0773ZY26F",
"review_text": "PRO:\nThe built in speaker was a nice surprise. Not mind-blowing quality, but good. I enjoyed it for the two hours this monitor worked.\nCON:\nSee attached pictures. Extremely disappointed that this item has an \"Amazon's choice\" icon. After using this as a second monitor to watch youtube for only two hours, a black line appeared straight down the middle of the screen, top to bottom. Restarted the monitor and the PC, but the line is even in the monitor's \"SCEPTRE\" splash screen AND the \"Cannot detect input!\" screen.\nOverall would not recommend this.",
"publication_date": "2018-11-30 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 1,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "amazon_review_item",
"rank_group": 9,
"rank_absolute": 9,
"position": "right",
"xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[5]/div[3]/div[1]/div[9]/div[1]/div[1]",
"verified": true,
"subtitle": "Reviewed in the United States on July 28, 2020",
"helpful_votes": 23,
"images": [
{
"type": "images_element",
"alt": "Customer image",
"url": null,
"image_url": "https://images-na.ssl-images-amazon.com/images/I/71y29fxUh7L._SY88.jpg"
}
],
"videos": null,
"user_profile": {
"name": "Nancy",
"avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/default._CR0,0,1024,1024_SX48_.png",
"url": "https://amazon.com/gp/profile/amzn1.account.AHOOBOZ7FTZJFMIF6OKZNOC4ZJKA",
"reviews_count": null,
"locations": null
},
"title": "Cheap",
"url": "https://amazon.com/gp/customer-reviews/R2IZ034LTUN38R?ASIN=B0773ZY26F",
"review_text": "You get what you pay for and you don’t pay much for this monitor and that’s what you get is not much. Colors are dull and it is not a crisp picture. The picture compares the picture quality. This monitor is on the left",
"publication_date": "2020-07-28 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 2,
"votes_count": null,
"rating_max": 5
}
},
{
"type": "amazon_review_item",
"rank_group": 10,
"rank_absolute": 10,
"position": "right",
"xpath": "/html[1]/body[1]/div[1]/div[3]/div[1]/div[1]/div[1]/div[1]/div[5]/div[3]/div[1]/div[10]/div[1]/div[1]",
"verified": true,
"subtitle": "Reviewed in the United States on April 26, 2018",
"helpful_votes": 44,
"images": null,
"videos": null,
"user_profile": {
"name": "Luis Flores",
"avatar": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/default._CR0,0,1024,1024_SX48_.png",
"url": "https://amazon.com/gp/profile/amzn1.account.AHQOGXF77IZBLSDHZEW337633FMQ",
"reviews_count": null,
"locations": null
},
"title": "Stopped working within 15 minutes.",
"url": "https://amazon.com/gp/customer-reviews/R1U5GN8TBH38CV?ASIN=B0773ZY26F",
"review_text": "All of the positive reviews led me to believe this is a great monitor. However, within the first 15 minutes of setting up the monitor, the screen began flickering on and off. Then, it stopped working completely. Maybe I was given a defective model. This is very disappointing.",
"publication_date": "2018-04-26 00:00:00 +00:00",
"rating": {
"rating_type": "Max5",
"value": 1,
"votes_count": null,
"rating_max": 5
}
}
]
}
]
}
]
}
Get more specific results with additional POST parameters
The Amazon Reviews endpoints support various filtering and sorting parameters that you can set to receive more specific results.
1 First, you can sort reviews by recency or helpfulness with the sort_by parameter.
If you use the "sort_by": "helpful" parameter, the API will first provide the most helpful reviews, i.e., the reviews that received the most “helpful votes” from Amazon users. They’re called “Top Reviews” on Amazon.
If you use the "sort_by": "recent" parameter, the API will first provide the most recent reviews.
Default rule: helpful
2 You can also filter the results by reviewer type with the reviewer_type parameter.
Use "reviewer_type": "all_reviews" to receive reviews from all reviewers.
Use "reviewer_type": "avp_only_reviews" to receive reviews with the “Verified Purchase” mark only.
Default rule: all_reviews
3 Another way to filter reviews is by stars. You can do it with the filter_by_star parameter.
• "filter_by_star": "all_stars" — return reviews with any number of stars;
• "filter_by_star": "five_star" — return five-star reviews only;
• "filter_by_star": "four_star"— return four-star reviews only;
• "filter_by_star": "three_star" — return three-star reviews only;
• "filter_by_star": "two_star" — return two-star reviews only;
• "filter_by_star": "one_star" — return one-star reviews only;
• "filter_by_star": "positive" — return positive reviews only;
• "filter_by_star": "critical" — return critical reviews only.
Default rule: all_stars
4 You can collect reviews about a specific product modification by specifying the format_type filter.
Use "format_type": "all_format" to receive reviews for all possible product modifications.
Use "format_type": "current_format" to receive reviews for the current product modification only.
Note that ASINs vary depending on a product modification. Thus, two modifications of the same product will have two different ASINs. Make sure to specify the right ASIN when setting a task with the current_format parameter.
Default rule: all_format
5 And last, you can filter results by media type with the media_type filter.
Use "media_type": "all_contents" to receive text, image, and video reviews.
Use "media_type": "media_reviews_only" to receive image and video reviews only.
Default rule: all_contents