Amazon Product Reviews API
Scrape Amazon product reviews instantly with a simple API call
A GET request to our /api/getter/?platform="amazon_reviews" endpoint allows you to scrape customer reviews for any product listing URL on Amazon.com in real-time.
Amazon Login Required
As of November 5th, 2024, Amazon now requires users to be logged in to view product reviews. To continue scraping more than the 8 most recent reviews, you'll need to provide your Amazon account's cookie with your API requests.
Scrape Reviews with Cookie
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.
Get 8 Most Recent Reviews without Cookie
You can now retrieve the 8 most recent reviews without providing your Amazon account's cookie. This is perfect for quick access to the latest feedback on a product.
Example
Here's how you can scrape reviews for this product with our API — with its URL and your account's cookie:
1 | |
1 2 3 4 5 | |
1 2 3 | |
1 2 3 4 5 6 | |
1 2 3 4 5 6 | |
In this example, we're scraping reviews that have images or videos and are sorted by helpfulness. To make the request, we've provided the product's URL. Alternatively, you can provide the product's ASIN instead.
Query Parameters
Our endpoint accepts the following query parameters:
Product URL
url
Required if asin not provided
Product listing's URL on Amazon. Remove unnecessary query parameters and encode the URL.
Getting the Cookie
Need help getting the cookie from your Amazon account? Follow this step-by-step guide.
Cookie Country
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.
8 Most Recent Reviews without Cookie
If getting the cookie from your Amazon account is not an option for you, you can still retrieve the 8 most recent reviews without the cookie. For the 8 top reviews, consider using the Amazon Product Data API.
404 Error
If you receive a 404 error, this usually means the product is no longer available on Amazon. When using the API without a cookie, instead of a 404 error, you'll receive an empty response - but a credit will still be deducted from your account. To avoid unnecessary credit usage, we recommend first verifying the product's availability using our Amazon Product Data API before making a review request.
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
Required if asin provided, otherwise 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.
When not providing a cookie, you can only access the first page.
Please note that Amazon removed the ability to view reviews beyond page 10 starting July 2023.
Page Limit
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.
Restrictions without Cookie
When not providing a cookie, the page parameter defaults to 1 and cannot be changed and the following parameters are not supported: sort_by, filter_by_star, media_type and filter_by_keyword.
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.
*Note:* When not providing a cookie, the `sort_by` parameter defaults to `recent` and cannot be changed.
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_content and media_reviews_only. The default value for this parameter is all_content.
Filter By Keyword
filter_by_keyword
Optional
Filter reviews that contain a specific keyword or phrase. The search is case-insensitive and matches partial words. For example, "ship" will match "shipping", "shipped", etc.
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.
URL Encoding
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.
How to get maximum reviews
Want to get ALL reviews for a product? Combine different page numbers, filters, and sort options to maximize your review collection. Our step-by-step tutorial shows you how you can scrape the complete review history for any product.
Results
The response will include the following attributes for each review:
| 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_videos | list | Links to reviewer's videos, if any |
| meta_data | dict | Dict containing meta data. For e.g., verified purchase status and variant info |
| meta_data.verified_purchase | boolean | Whether the review is from a verified purchase |
| meta_data.variant_info | list | List of variant details for the reviewed product |
| meta_data.helpful_vote_count | int | Number of helpful votes for the review |
| location | string | Country-level location of reviewer |
| rating_distribution | dict | Distribution of ratings for the product |
Rating Distribution
Please note that the rating_distribution attribute is only available when a cookie is provided.
Response Example
Each request returns up to 10 results (or 8 when no cookie is provided). 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": "all_stars",
"media_type": "media_reviews_only",
"filter_by_keyword": null,
"page": 1,
"total_results": 2471,
"no_of_pages": 248,
"result_count": 10,
"reviews": [
{
"id": "RMSJ7PLBYUD86",
"date": "2024-11-24",
"author_name": "Mimi",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AEN7KBRODHQTMSP64SGGOWKB75KQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 4,
"review_title": "Good length",
"review_url": "https://www.amazon.com/gp/customer-reviews/RMSJ7PLBYUD86/",
"review_text": "I tried it as soon as it arrived. I placed it on top of my Maybeline Great Lash mascara I put on this morning. I wanted to see reviews comparing the before and after before I bought and didn’t find many so I figured I’d provide a comparison. I think it looks pretty good. Better than thrive causemetics lash formula which is $20 more. It feels creamy and easy to wipe from the skin if it gets smeared on application. I have to try it all day to see how it does but so far seems great for the price.",
"review_imgs": [
"https://m.media-amazon.com/images/I/61fQ809-p3L._SL1600_.jpg"
],
"review_videos": [],
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 5
},
"location": "United States"
},
{
"id": "R3DHTTN38NVWVX",
"date": "2024-11-22",
"author_name": "Kimberly Zittlow",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AFD76QZUUTSEL3YDCJY22ZS6GNRQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Essence Lash Princess Mascara",
"review_url": "https://www.amazon.com/gp/customer-reviews/R3DHTTN38NVWVX/",
"review_text": "I’m blown away by this mascara—it’s an absolute game-changer! Lash Princess has earned its name, delivering dramatic volume and length that rivals high-end mascaras for a fraction of the cost. I love how effortlessly it glides on, coating every lash without clumping. The wand design is perfect for grabbing even the tiniest lashes, giving a full, fanned-out effect.What impressed me most was how long-lasting it is. I’ve worn it through long days, and it holds up beautifully without smudging or flaking. The formula is lightweight, so my lashes never feel weighed down, yet the effect is bold and eye-catching.It’s my go-to mascara for both everyday wear and special occasions. Honestly, I’ve spent triple the price on other brands that don’t deliver half the results. If you’re looking for a mascara that makes your lashes pop and stays put all day, this is the one! Highly recommend—don’t let the price fool you; it’s worth every penny.",
"review_imgs": [
"https://m.media-amazon.com/images/I/21UtbKb1CdL._SL1600_.jpg"
],
"review_videos": [],
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 2
},
"location": "United States"
},
{
"id": "R1F2VMWPCRCFYF",
"date": "2024-11-23",
"author_name": "Chase & Ash",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AF5S4ZG6SM6XJRLON4FY7XOCHPZQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Great mascara!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R1F2VMWPCRCFYF/",
"review_text": "I ordered this not knowing what to expect because of the low price point. Needless to say, I am pleasantly surprised by the quality of this mascara. I have been using an almost $15 “ name brand” mascara that was decent, but not great. Well, look no further because this stuff is great. It doesn’t smear smudge on my eye lids as the $15 one does. It’s nice dark black and it actually contains more product than my $15 mascara does and has little rubber designs on the handle so it doesn’t slip out of your fingers while applying! It also doesn’t make my very sensitive skin itch either which is a huge bonus to not feel like I have something in my eye all day! I will definitely be buying the brown too! Do yourselves the favor & try it! For $5 what can it hurt?",
"review_imgs": [
"https://m.media-amazon.com/images/I/61Qta21O4yL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/61maS4FxRvL._SL1600_.jpg"
],
"review_videos": [],
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 4
},
"location": "United States"
},
{
"id": "R19LTV2RGRS6FU",
"date": "2024-10-17",
"author_name": "Natalie Guillory",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AG3BOYWTYOVRFY7377ESKN2MMMVQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 4,
"review_title": "Really good for the price",
"review_url": "https://www.amazon.com/gp/customer-reviews/R19LTV2RGRS6FU/",
"review_text": "I've been on a natural high since 2020. Natural hair, Natural Nails and Natural lashes. Since I've stopped wearing false lashes I've been in search or a good mascara. I wanted one that didn't cost $30 plus and this one is currently doing the trick. I like the fullness and the length it gives my lashes. It clumped a little but here's a trick I learned. Put a couple of drops of clear eyes or visine or your eye drop of choice. Heck, you can drip some contact solution in it too. Any liquid that's safe for eyes. This thins it out a bit and then it's perfect. You can even use this trick if you're running out and your in a pinch but still need those lashes on point. Bottom line, TRY IT! It' so cheap, why not?",
"review_imgs": [
"https://m.media-amazon.com/images/I/618Xo1L2lWL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/61SKJNfPy+L._SL1600_.jpg"
],
"review_videos": [],
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 122
},
"location": "United States"
},
{
"id": "RZI8R6MDNDK85",
"date": "2024-10-12",
"author_name": "Jessie",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AEZFGA67GC2RJEFMKECLJZFCUC2A/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "#1 Mascara!!!!",
"review_url": "https://www.amazon.com/gp/customer-reviews/RZI8R6MDNDK85/",
"review_text": "Okay this mascara is absolutely bonkers!!! I remember using it as a teenager, but I've used so many mascaras from then to now that I don't remember which ones gave what results. (If that makes any sense!) Fast forward many years, I've used ALL the mascaras trying to find my holy grails again. Only a few (((OUT OF HUNDREDS!))) have truly made my lashes POP. Who knows why I ever wanted to try new ones, but now so many years later I don't remember which those few bangers were anymore. I seriously should have wrote them down. So as of lately, I have been on the hunt to find those mascaras again!! I saw that this mascara has gone viral and I remembered \"hey, I used to use that a long time ago!\" I had forgotten how I liked it, or if I even did. No harm in trying it out again though!Let me tell you, I was already in disbelief about the price. And the moment of clarity and instant recollection I felt when I realized that THIS was one of my long lost holy grails; I felt like I had been reconnected to a lost love.This mascara is unbelievable. For like $5 you get the most amazing lashes you have ever seen on yourself! I always like to coat and coat and coat my mascara, and usually have to with most mascaras anyways to get the results I like, but honestly you can already see a mega difference after just one coat with this mascara. The image I provided is definitely not only one coat, because I got carried away adding more coats and feeling straight ecstasy while I did. But you can see the volume and length power that this mascara holds. I used the essence false lash effect mascara in combination with the essence mascara primer. I am completely blown away, and obssesed, and won't use another brand again. Also worthy to mention that I just dropped $30 on Too Faced Better Than Sex mascara, and I seriously prefer this $5 Lash Princess by a longshot.Ladies, this Lash Princess mascara will have you actually looking, and feeling, like a freaking lash princess.",
"review_imgs": [
"https://m.media-amazon.com/images/I/711mJLC7bGL._SL1600_.jpg"
],
"review_videos": [],
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 161
},
"location": "United States"
},
{
"id": "R27JFPL1TG3EYG",
"date": "2024-11-12",
"author_name": "Niki Marrow Image Consulting",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHBP3JV3RCX2KYDC6QCE3FFHPP2Q/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Makes your lashes look long like extensions",
"review_url": "https://www.amazon.com/gp/customer-reviews/R27JFPL1TG3EYG/",
"review_text": "I’m now 50. I’ve tried every name brand, price point high and low and all in between. There have been quit a few descent formulas. This is the best mascara I’ve tried hands down . It doesn’t clump, or shed. It’s not heavy on the eyes. It doesn’t smudge. I was an active law enforcement officer for years. This mascara stood the test of very long days. It’s the only one I will use now. It’s the one my daughter uses. We’re both Cosmetologists and absolutely favor this mascara",
"review_imgs": [
"https://m.media-amazon.com/images/I/618FAi+9WzL._SL1600_.jpg"
],
"review_videos": [],
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 3)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 9
},
"location": "United States"
},
{
"id": "RE61R4UCNJSI3",
"date": "2024-10-20",
"author_name": "Hannah E Bartley",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGNRLDXHW4ARWFD7XIAV3BEZFEXQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 4,
"review_title": "Solid mascara for the price!",
"review_url": "https://www.amazon.com/gp/customer-reviews/RE61R4UCNJSI3/",
"review_text": "I am on a lash health journey since I got rid of my lash extensions. I had them on for about two years. I didn’t want to splurge on something crazy expensive and I heard a lot of hype about this mascara. It is amazing for the price! If you aren’t super careful about putting it on it will clump up, but for the most part I love it and will buy again. No different from the $30+ mascaras from Sephora.",
"review_imgs": [
"https://m.media-amazon.com/images/I/61LTbcacUAL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/61XOSahj-2L._SL1600_.jpg"
],
"review_videos": [],
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 8
},
"location": "United States"
},
{
"id": "RUG10CUMIF2WH",
"date": "2024-11-21",
"author_name": "Meem79",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHGCRISX3KDWJOYSRED5AY6HP5GQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Best mascara!!",
"review_url": "https://www.amazon.com/gp/customer-reviews/RUG10CUMIF2WH/",
"review_text": "I have been paying $20+ for some name brand good quality telescopic fiber mascara and this is $5 and does the job and with way less coats! Stock up on this one!!!The pic is 1 coat on one eye and naked lashes on the other.",
"review_imgs": [
"https://m.media-amazon.com/images/I/61r2jncU+6L._SL1600_.jpg"
],
"review_videos": [],
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 2
},
"location": "United States"
},
{
"id": "R37N85UH44CJ5A",
"date": "2024-11-11",
"author_name": "Rahrah",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHFJ7NE6UUQCUACGTZTNMH7AS6WA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Shockingly GOOD",
"review_url": "https://www.amazon.com/gp/customer-reviews/R37N85UH44CJ5A/",
"review_text": "I have been a loyal Lancôme mascara user for years. I love hypnose. Though this mascara is not AS good as Lancôme, but is it ever CLOSE. I have worn it for a few days before I left a review to truly see. It does not flake, smear, wear off, or slide down your eyes. Best “drug store” mascara I’ve ever used. Hands down. It’s going on my subscribe & save right now!",
"review_imgs": [
"https://m.media-amazon.com/images/I/7153eWQV29L._SL1600_.jpg",
"https://m.media-amazon.com/images/I/81d2xwSGtxL._SL1600_.jpg"
],
"review_videos": [],
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 9
},
"location": "United States"
},
{
"id": "R1L7R0YVI1287O",
"date": "2024-11-13",
"author_name": "Maddie Randazzo",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHUUSTCLZXYKF7NYKBUKJ5FANAKA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Thick black lifted lashes for cheap!!!!!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R1L7R0YVI1287O/",
"review_text": "I always buy this mascara when I run out of my expensive mascara or I loosen and I question why I buy anything else other than this five dollar mascara. It works miracles but keep in mind. You must remove with make up remover.",
"review_imgs": [
"https://m.media-amazon.com/images/I/711hOVL+LgL._SL1600_.jpg"
],
"review_videos": [],
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 0
},
"location": "United States"
}
],
"meta_data": {
"total_ratings": 379445,
"rating_distribution": {
"5 star": "66%",
"4 star": "14%",
"3 star": "10%",
"2 star": "5%",
"1 star": "6%"
},
"cookie": "<updated_cookie_here>"
},
"remaining_credits": 1908419
}
Request Cost
• 1 credit is deducted for each successful request to Amazon USA
• 2.5 credits are deducted for each successful request to all other Amazon marketplaces
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.com.au | au |
| India | Amazon.in | in |
| Brazil | Amazon.com.br | br |
| Italy | Amazon.it | it |
| Belgium | Amazon.com.be | be |
Support
If you don't see the country you need data from, want to add a parameter to our response, or have any questions or feedback, please contact us at support@unwrangle.com.