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.
Warning
As of November 5th, 2024, Amazon now requires users to be logged in to view product reviews. To continue scraping reviews, you'll need to provide your Amazon account's cookie with your API requests.
Tip
We've updated our API to support authenticated requests. Simply provide your Amazon account's cookie and continue scraping reviews as before. See the cookie section below for detailed instructions on how to obtain and use your cookie.
Example
To scrape customer reviews for the this product, 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
Product listing's URL on Amazon. Remove unnecessary query parameters and encode the URL.
Tip
Need help getting the cookie from your Amazon account? Follow this step-by-step guide.
Note
The cookie must be from an Amazon account registered in the same country as the Amazon domain you're accessing. For example, to scrape amazon.co.uk, use a cookie from a UK Amazon account.
Info
If getting the cookie from your Amazon account is not an option for you, you can use the Amazon Product Data API to get the 8 top reviews for any product.
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.
Note
Even when the response mentions the no_of_pages as greater than 10, the maximum page number for which you can query reviews with the API is 10. This is because Amazon does not let users view reviews beyond page 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 helpful.
Filter By Star
filter_by_star
Optional
This parameter allows you to filter reviews by star rating. Since Amazon now limits review pages to 10, using star filters is an effective way to access more than 100 reviews for a product. Supported values are: all_stars, five_star, four_star, three_star, two_star, one_star, positive and negative. The default value is all_stars.
Media Type
media_type
Optional
The type of media you want to filter by. Supported values are all_contents and media_reviews_only. The default value for this parameter is all_contents.
Other Required Parameters
platform
Required
Specifies the scraping engine to use. For this API endpoint, set this parameter to amazon_reviews.
api_key
Required
Your API key token, which you can obtain by signing up here.
Note
The value of the query parameter url must be URL encoded (also known as percent encoding). If you're using Python, you can use the urllib.parse.quote() function to properly encode the URL.
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 |
| review_video | string | Link to video, if any |
| meta_data | dict | Dict containing meta data. For e.g. verified purchase status and variant info |
| 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/essence-Princess-Effect-Mascara-Cruelty/dp/B00T0C9XRK",
"sort_by": "helpful",
"filter_by_star": "positive",
"media_type": "media_reviews_only",
"page": 1,
"total_results": 1885,
"no_of_pages": 189,
"result_count": 10,
"reviews": [
{
"id": "R305S38CCCID0D",
"date": "2024-08-05",
"author_name": "Natalie",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AFF6IK7EQMGDEVFVLWIJ7NKXFQWA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "5.0 out of 5 stars\nSuch a good product!! And OMG I found the best hack with this mascara!!!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R305S38CCCID0D/",
"review_text": "This mascara lives up to its name. It gave me dramatic, false lash-like results without the hassle of applying fake lashes. As someone who values both convenience and high-impact results, I found this mascara to be a game-changer in my daily makeup routine. Here are the things I liked:Dramatic Lash EffectThe mascara created a bold, voluminous lash look that mimics the effect of false lashes. With just a few coats, my lashes appeared significantly longer, fuller, and more defined. I liked the brush too. It felt like it perfectly separated and coated each lash making sure there was no clumping or flaking throughout the day.Long-LastingIt stayed put all day without smudging or losing its intensity, even in humid conditions. Great for long workdays, nights out, or any occasion where you need your makeup to last. Surprisingly it was easy to remove though…😂HACK: Pairing with Tan Maxxed (Tanning Supplement)Okay, hear me out. I paired this with the Tan Maxxed Supplement and it changed my life!These create the ultimate combination. While the mascara enhances your eyes, giving you a captivating and alluring look, the tanning supplement works from within to give your skin a healthy, sun-kissed glow. You feel good ALL AROUND.Tan Maxxed is designed to support and enhance your natural tan, giving your skin a radiant and attractive appearance. It contains astaxanthin, which helps protect the skin from damage while promoting a beautiful, even tan. When you combine the dramatic lash effect of the mascara with the glowing skin provided by the supplement, you create a look that exudes confidence and charisma.I found a holistic approach to beauty and self-assuredness. The mascara gives me striking eye enhancement, meanwhile, the Tan Maxxed gives you a healthy, radiant complexion that complements your enhanced lashes. This combination boosts your confidence, making you feel more attractive and self-assured in any setting.",
"review_imgs": [
"https://m.media-amazon.com/images/I/91APA6HpZXL._SL1600_.jpg"
],
"review_video": null,
"meta_data": {
"variant_info": "Size: 0.4 Fl Oz (Pack of 1)Color: Black",
"verified_purchase": true
},
"location": "United States"
},
{
"id": "RDVDV1Z0YC93P",
"date": "2024-09-08",
"author_name": "Amazon Customer",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AEW62L52BKZJQIH22VVOQFUI3THA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 4,
"review_title": "4.0 out of 5 stars\nGreat color wish it was a true drk brown",
"review_url": "https://www.amazon.com/gp/customer-reviews/RDVDV1Z0YC93P/",
"review_text": "As a MUA, dark brown or brown/black, black/brown is needed for many people even if you have dark lashes. A TRUE dark brown would be best but can't find it. 4 stars simply because the brush needs to be the one I have added. The brush that comes with this product is too compact and holds a lot of mascara. Separate bristle like I have pictured is optimal in my opinion. This brand does stay on well for me. I do not use on bottom lashes so I cannot comment as to how it holds on bottom lashes. I have to use my trusty wand as pictured to get the outcome I want.",
"review_imgs": [
"https://m.media-amazon.com/images/I/61DohInKxoL._SL1600_.jpg"
],
"review_video": null,
"meta_data": {
"variant_info": "Size: 0.4 Fl Oz (Pack of 1)Color: Brown",
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R2N6B7586JLK5S",
"date": "2024-09-17",
"author_name": "victoria crain",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AFOX6QP6X6NBYRHFXT34XSMH3I6Q/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "5.0 out of 5 stars\nEye Lash Effect",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2N6B7586JLK5S/",
"review_text": "I definitely recommend this eye lash mascara it’s amazing 10/10 definitely recommend. I will be buying more today! It last all day and it doesn’t make it feel like you have a ton on your eye lids. It comes off very easy with warm water as well but it definitely last all day. It definitely makes it feel like you have eye lashes on. I’ve gotten many compliments wearing this and i love it. The price is amazing!",
"review_imgs": [
"https://m.media-amazon.com/images/I/71+BdfZkmeL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/717gQAwTljL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/71u8yBguYeL._SL1600_.jpg"
],
"review_video": null,
"meta_data": {
"variant_info": "Size: 0.4 Fl Oz (Pack of 1)Color: Black",
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R2MIJLA3KPWCVQ",
"date": "2024-09-10",
"author_name": "Sarah Mason",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGZZVYNNB7ZHL3TD6JMEVU7IZWYQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "5.0 out of 5 stars\nWow! Lashes look amazing!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2MIJLA3KPWCVQ/",
"review_text": "I would highly recommend this mascara! It's an affordable product that looks great. I've posted a pic of the mascara on one of my eyes for comparison.The product stayed put and looking great for 8+ hours. NO flaking or running and didn't bother my dry, sensitive eyes at all. As other reviewers have mentioned the, it does tend to clump on application and I'd highly recommend having a spoolie on hand to separate lashes and remove excess product.I will definitely buy this again!",
"review_imgs": [
"https://m.media-amazon.com/images/I/71wggrZ6r3L._SL1600_.jpg"
],
"review_video": null,
"meta_data": {
"variant_info": "Size: 0.4 Fl Oz (Pack of 1)Color: Black",
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R37DNEGNBFJXT6",
"date": "2024-08-31",
"author_name": "Ginger",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AFBS2SAIPVLDKUJADEFKCZKOE3HA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 4,
"review_title": "4.0 out of 5 stars\nBeautiful but creates Racoon eyes",
"review_url": "https://www.amazon.com/gp/customer-reviews/R37DNEGNBFJXT6/",
"review_text": "I love the way it makes my lashes look but after 4+ hours it smudges under eyes and doesn't look great. It would probably be fine for an evening going to dinner but doesn't stay put all day.",
"review_imgs": [
"https://m.media-amazon.com/images/I/71dNgH+3H8L._SL1600_.jpg"
],
"review_video": null,
"meta_data": {
"variant_info": "Size: 0.4 Fl Oz (Pack of 1)Color: Black",
"verified_purchase": true
},
"location": "United States"
},
{
"id": "RLM9P6T2S7ZZC",
"date": "2024-08-21",
"author_name": "Bling Me Up Scotty",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AEWPGCERKXC2RCWU3FZSCBUZUIQQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "5.0 out of 5 stars\nWOW!! Ladies, this is IT!!",
"review_url": "https://www.amazon.com/gp/customer-reviews/RLM9P6T2S7ZZC/",
"review_text": "I’ve seen this mascara before and thought “ehhh”. I have quite the collection of mascara and fake lashes that have not done my lashes any justice & after brain surgery, I stopped trying. But OMGOSH (I can’t bring myself to use His name in vain lol)Ladies, ladies, ladies!! (and guys 🤗) When I tell you one coat made my eyelashes “pop”, I kid you not! I am old and so are my eyelashes, but if you want to get your “groove back”, this is definitely going to help you be a Queen. This is real talk; not a paid endorsement. Pics are one eye/one coat/no enhancement & I think it’s working!",
"review_imgs": [
"https://m.media-amazon.com/images/I/61CoApYQlYL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/61E7fACm61L._SL1600_.jpg",
"https://m.media-amazon.com/images/I/61kh+dXmrZL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/716cjRuzfcL._SL1600_.jpg"
],
"review_video": null,
"meta_data": {
"variant_info": "Size: 0.4 Fl Oz (Pack of 1)Color: Black",
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R18TUN46DTV65P",
"date": "2024-09-06",
"author_name": "Jill Ingenito",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGG3GSYXMUERRFLVYP53RTTHMJVQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "5.0 out of 5 stars\nHONEST review of the false lash effect mascara",
"review_url": "https://www.amazon.com/gp/customer-reviews/R18TUN46DTV65P/",
"review_text": "The media could not be loaded.\n \n\n\n\nI am absolutely in love with the Essence Lash Princess False Lash Effect Mascara! It delivers everything it promises—volumizing, lengthening, and giving you that coveted false lash effect. Here’s what I adore about it: • Volume & Length: With just a few coats, my lashes looked significantly fuller and longer without any clumping. The formula really adds an impressive lift to the lashes, making my eyes pop. • False Lash Look: It lives up to the “false lash effect” claim. This mascara gives my lashes a dramatic, bold look that’s perfect for both daytime wear and evening occasions. • Easy Application: The brush is designed perfectly to grab every single lash, even the tiny ones, and the curved shape makes it easy to apply the product from root to tip without much effort. • Cruelty-Free & Paraben-Free: Knowing that this product is cruelty-free and free from harmful parabens is a huge plus for me. It’s gentle on the eyes, making it ideal even for sensitive skin. • Staying Power: The mascara stays put all day without flaking or smudging, even through long hours. Yet, it’s easy to remove with makeup remover at the end of the day. • Price: For such a high-performing product, the price is incredibly affordable. You’re getting premium quality without breaking the bank.",
"review_imgs": [],
"review_video": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/5a197cec-1f35-4124-b6ef-97d1875d2940/default.vertical.jobtemplate.hls.m3u8",
"meta_data": {
"variant_info": "Size: 0.4 Fl Oz (Pack of 1)Color: Black",
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R23B4H306762H4",
"date": "2024-08-28",
"author_name": "Rachel Friedman",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGCOMM357ICNY7LDPUF6O42LSQXQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "5.0 out of 5 stars\nExpensive doesn’t mean better!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R23B4H306762H4/",
"review_text": ". A few years ago Bailey Sarian talked all about this mascara and she sold it so well I knew I needed some. Her lashes looked amazing and it wasn’t just falsies. So for 3+ years I’ve been using this mascara and finally decided to switch to the brown black which made my blue eyes pop much more so then the black did. I love this color. Excellent formula. Maybe the brown color is waterproof? Is that a possibility?",
"review_imgs": [
"https://m.media-amazon.com/images/I/61LPtt1FtpL._SL1600_.jpg"
],
"review_video": null,
"meta_data": {
"variant_info": "Size: 0.4 Fl Oz (Pack of 1)Color: Brown",
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R14SO1KCR3IPTS",
"date": "2024-09-11",
"author_name": "Sahar",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGVJYVN53U2PNJ4UTUGKYZNHWNSQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "5.0 out of 5 stars\nGreat value",
"review_url": "https://www.amazon.com/gp/customer-reviews/R14SO1KCR3IPTS/",
"review_text": "I was surprised with the quality. First photo is without mascara and second photo after applying one application. Effortless and even better that my eyelashes shows longer and thicker without looking dramatic and instead is very natural",
"review_imgs": [
"https://m.media-amazon.com/images/I/710TLhrpwCL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/71zjA4PblLL._SL1600_.jpg"
],
"review_video": null,
"meta_data": {
"variant_info": "Size: 0.4 Fl Oz (Pack of 1)Color: Black",
"verified_purchase": true
},
"location": "United States"
},
{
"id": "R1R5ASE4UML7XE",
"date": "2019-03-13",
"author_name": "Precise Disarray",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AF2BLE54TEMGZ546U763ZHZRXC4A/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 4,
"review_title": "4.0 out of 5 stars\nVisible difference, some good, some not so good",
"review_url": "https://www.amazon.com/gp/customer-reviews/R1R5ASE4UML7XE/",
"review_text": "--I have used many different kinds of mascara over the years. I typically wear little to no make up, but when I do, I love mascara. Unfortunately most eye products irritate my eyes. The get itchy, red, and feel tired (even though I am not). Sometimes it is within a very short period of time, sometimes a few hours later. Either way, it sucks trying to find a mascara that doesn't make my eyes feel terrible. I don't recall what brought me to this product, but I gave it a try based on the write up and the budget friendly price (less than $5).--Well, after initial use, I could tell that it was going to be one of the few mascaras that doesn't highly irritate my eyes. --YAY! Another annoying thing about trying to find a good mascara- finding one that doesn't smear. Not just flaking, but actual smudges and smears. It is terrible to perfectly apply eye make up, look great upon completion, only to find later that the mascara didn't dry, and I've been walking around with racoon eyes. This formula doesn't seem to smear. YAY! (for other mascaras that I didn't want to throw out, I just made sure to lightly powder my lashes to help the mascara to stick).--Lengthening. Who doesn't want some added length? This formula clearly adds some length. See included pics! I didn't apply it to heavy, I didn't have another product added in. I just did a couple of quick swipes then took a picture. One with one eye done, one with both. Clearly a difference. I imagine if I were more careful and methodical in my application, I get more length or volume. YAY! BUT, that brings me to..--Now, the one other thing that bothers me about mascara, is that some will clump quickly, so it can be difficult to apply carefully when the product wants to bulk up in spots. Sometimes it can be helped by wiping off some of the product from the wand before application, but that can hinder layering it on. It is a fine line between applying it thick and having it clump. This product is quick to clump and/or deposit too much at once in haphazard way. Some people LIKE the look of clumpy lashes, or lashes that look like they are clearly mascara caked. I am not judging, and it is totes cool if that is the look you want because this mascara will help you achieve it. I am kind of in the middle. I want to look like I am wearing mascara, but I don't want it to be glommed on to to where it looks dry and spidery. Hard to describe, but look at other peoples review pics to determine if this mascara will do what you want it to in terms of looks. With a light touch, it can look like basic lash darkening mascara, it is just trickier to get the dark/thick/and length without it going into clump/stick/harsh look.--While I don't often bring price into my review, I do want to say that at the <$5 price point, I would consider buying this again. More than that, probably not so much. It works well enough, and doesn't bother my eyes.--For those that ask about the packaging, it is sent as a loose tube without wrap or extraneous packaging. it has a sticker where wand meets the body of container. Simple.",
"review_imgs": [
"https://images-na.ssl-images-amazon.com/images/I/71NyyQuI8HL._SL1600_.jpg",
"https://images-na.ssl-images-amazon.com/images/I/71egG2EWeUL._SL1600_.jpg"
],
"review_video": null,
"meta_data": {
"variant_info": "Size: 0.4 Fl Oz (Pack of 1)Color: Black",
"verified_purchase": true
},
"location": "United States"
}
],
"meta_data": {
"total_ratings": 1885,
"rating_distribution": {},
"cookie": "session-token=1234567890abcdef....."
},
"remaining_credits": 859613
}
Request Cost
1 credit per request.
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