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.
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.
Filtering Most Recent Unavailable without Cookie
Starting, 26th February 2025, Amazon has disabled the ability to view the 8 most recent reviews without a cookie. If you want to scrape the recent reviews for your product, you'll need to provide your Amazon account's cookie.
The Amazon Reviews API without cookie was briefly working but Amazon has now disabled it again. It appears that they have removed this option from their site altogether.
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, format_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.
Format Type
format_type
Optional
Specifies the variants for which you want to retrieve reviews. Supported values are all_formats and current_format. The default value for this parameter is all_formats.
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.
Reviewer Type
reviewer_type
Optional
The type of reviews you want to retrieve. Supported values are all_reviews and avp_only_reviews (Verified Purchase only). The default value is all_reviews.
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 |
| variant.asin | string | ASIN of the product variant |
| variant.size | string | Size of the product variant |
| variant.color | string | Color of the product variant |
| meta_data.variant_info | list | List of variant details as strings |
| meta_data.verified_purchase | boolean | Whether the review is from a verified purchase |
| meta_data.helpful_vote_count | int | Number of helpful votes for the review |
| meta_data.is_vine_voice | boolean | Whether the review is from a Vine Voice |
| 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": "recent",
"reviewer_type": "all_reviews",
"filter_by_star": "all_stars",
"media_type": "all_content",
"format_type": "all_formats",
"filter_by_keyword": null,
"page": 1,
"total_results": 52115,
"no_of_pages": 5212,
"result_count": 10,
"reviews": [
{
"id": "R30F2261LLQX0N",
"date": "2025-03-18",
"author_name": "Sarah Sigler",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AFDXIYJLUGN45C7MQ7SJKB676HZQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Must buy!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R30F2261LLQX0N/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "Love it! Picture is simply one coat!",
"review_imgs": [
"https://m.media-amazon.com/images/I/51ccjuFl0LL._SL1600_.jpg"
],
"review_videos": [],
"variant": {
"asin": "B00T0C9XRK",
"size": "0.4 Fl Oz (Pack of 1)",
"color": "Black"
},
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 0,
"is_vine_voice": false
},
"location": "United States"
},
{
"id": "R1KGGBS1GDTNNQ",
"date": "2025-03-18",
"author_name": "Amazon Customer",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AFY4CDRHLT6JVSJPR4GCNDC23DMA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Best mascara!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R1KGGBS1GDTNNQ/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "Best I have ever used!!",
"review_imgs": [],
"review_videos": [],
"variant": {
"asin": "B00T0C9XRK",
"size": "0.4 Fl Oz (Pack of 1)",
"color": "Black"
},
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 0,
"is_vine_voice": false
},
"location": "United States"
},
{
"id": "R2VE5PL5ZDQ0LH",
"date": "2025-03-18",
"author_name": "Dasha McGee",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGONZKNDG4AM4A6A3JLQWOGIZUIA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Im inlove! Complete game changer!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2VE5PL5ZDQ0LH/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "I don't ever write reviews, but this product is THAT good, i have to put yall on. I've never had a mascara that truly gave me the look I was going for, so I used to use two mascaras- one to separate my eyelashes, and another one to add volume. This one does both, and makes me feel like everyday is a good makeup day, and it only takes like less than 2 minutes for me to do my makeup, since I don't wear anything other than mascara. It goes on so smoothly, and I rarely have to fix it up much after applying. It stays on for a decent amount of time too. I definitely recommend this!",
"review_imgs": [
"https://m.media-amazon.com/images/I/61ddWmSMj2L._SL1600_.jpg"
],
"review_videos": [],
"variant": {
"asin": "B00T0C9XRK",
"size": "0.4 Fl Oz (Pack of 1)",
"color": "Black"
},
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 0,
"is_vine_voice": false
},
"location": "United States"
},
{
"id": "R2XI6SOER0ZZCL",
"date": "2025-03-18",
"author_name": "Lynn",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHWLQW7BC2V7TFNGT4XUNZLDBWHQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "Don't waste your money",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2XI6SOER0ZZCL/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "Should have listened to the 1 star reviews already written. Does not lengthen well, goes on clumpy and flakes off after a few hours. For me, it was a bust!",
"review_imgs": [],
"review_videos": [],
"variant": {
"asin": "B00T0C9XRK",
"size": "0.4 Fl Oz (Pack of 1)",
"color": "Brown"
},
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Brown"
],
"verified_purchase": true,
"helpful_vote_count": 0,
"is_vine_voice": false
},
"location": "United States"
},
{
"id": "R141XO8NIHO2WD",
"date": "2025-03-18",
"author_name": "Amazon Customer",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AFHFTM47EINFR2UR4Y5FTPJ4DCTQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Best mascara",
"review_url": "https://www.amazon.com/gp/customer-reviews/R141XO8NIHO2WD/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "This is so affordable and great for sensitive eyes. I recently had an eye infection and had to toss all mascara. I love my $20 mascara too. I researched mascara for sensitive eyes and this had great ratings. Not only does it not make my eyes water but it's just as lenghing and thinking as my favorite expensive ones. I was using Eastee Lauder and Rare Beauty. Great mascara but so pricey. This is my new favorite replacement and completely affordable.",
"review_imgs": [],
"review_videos": [],
"variant": {
"asin": "B00T0C9XRK",
"size": "0.4 Fl Oz (Pack of 1)",
"color": "Black"
},
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 0,
"is_vine_voice": false
},
"location": "United States"
},
{
"id": "R1URRRKOMV3GYE",
"date": "2025-03-18",
"author_name": "Brittany LeBlanc",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AH4VDKCM7AZNBXUALRLWSTJ2G4JA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "Clumpy messy & no volume",
"review_url": "https://www.amazon.com/gp/customer-reviews/R1URRRKOMV3GYE/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "Terrible mascara it's soooooo clumpy & falls off quickly. Ew",
"review_imgs": [],
"review_videos": [],
"variant": {
"asin": "B00T0C9XRK",
"size": "0.4 Fl Oz (Pack of 1)",
"color": "Black"
},
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 0,
"is_vine_voice": false
},
"location": "United States"
},
{
"id": "R3I14UYVKI65UB",
"date": "2025-03-18",
"author_name": "Laylay ",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHZZNHBMFAJ24X7WGNFNUSAWTXUQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Highly recommend",
"review_url": "https://www.amazon.com/gp/customer-reviews/R3I14UYVKI65UB/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "Amazing I love this brand I highly recommend",
"review_imgs": [],
"review_videos": [],
"variant": {
"asin": "B00T0C9XRK",
"size": "0.4 Fl Oz (Pack of 1)",
"color": "Black"
},
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 0,
"is_vine_voice": false
},
"location": "United States"
},
{
"id": "R1P8MKBT0829A3",
"date": "2025-03-18",
"author_name": "TPS",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHGN5HDROPPR6WSQHTQRL45NPSTA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Longer lashes",
"review_url": "https://www.amazon.com/gp/customer-reviews/R1P8MKBT0829A3/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "I was very hesitant about the color but it is fantastic. I have never worn brown mascara but it looks so much better than black. I have short curly lashes and this mascara really adds some length for me. My lashes look longer and fuller and I look more awake. I definitely recommend.",
"review_imgs": [],
"review_videos": [],
"variant": {
"asin": "B00T0C9XRK",
"size": "0.4 Fl Oz (Pack of 1)",
"color": "Brown"
},
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Brown"
],
"verified_purchase": true,
"helpful_vote_count": 0,
"is_vine_voice": false
},
"location": "United States"
},
{
"id": "R2D0IIPF8D9O1Q",
"date": "2025-03-18",
"author_name": "Daniel Jensen",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AF5D2JSUVVBYRHPWD2MCIEXB6IQA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "Clumpy and smeary",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2D0IIPF8D9O1Q/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "Clumpy mess! Don't feel like it extended lashes but sure clumped them together. Everytime I used it smeared onto my skin in different places around my eyes!",
"review_imgs": [],
"review_videos": [],
"variant": {
"asin": "B00T0C9XRK",
"size": "0.4 Fl Oz (Pack of 1)",
"color": "Black"
},
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 0,
"is_vine_voice": false
},
"location": "United States"
},
{
"id": "R3B058Y0OCEKC3",
"date": "2025-03-17",
"author_name": "Jessica",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGIVWRWNTJPWB7ZH2PEIFBD3TYDQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 5,
"review_title": "Could not love more",
"review_url": "https://www.amazon.com/gp/customer-reviews/R3B058Y0OCEKC3/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "This mascara will forever be my favorite! Nothing compares",
"review_imgs": [],
"review_videos": [],
"variant": {
"asin": "B00T0C9XRK",
"size": "0.4 Fl Oz (Pack of 1)",
"color": "Black"
},
"meta_data": {
"variant_info": [
"Size: 0.4 Fl Oz (Pack of 1)",
"Color: Black"
],
"verified_purchase": true,
"helpful_vote_count": 0,
"is_vine_voice": false
},
"location": "United States"
}
],
"meta_data": {
"total_ratings": 386492,
"rating_distribution": {
"5 star": "66%",
"4 star": "14%",
"3 star": "10%",
"2 star": "4%",
"1 star": "6%"
},
"cookie": "updated_cookie_value"
},
"remaining_credits": 5825061.5
}
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.