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
The ratings breakdown for each request is returned inside the meta_data.rating_distribution object.
Two additional top‑level fields help you understand how many records match your query:
• filtered_total_reviews – total number of reviews that satisfy the current filters.
• filtered_total_ratings – total number of ratings that satisfy the current filters.
filtered_total_ratings is updated only when filter_by_star is set to a specific star value (one_star through five_star). It remains unchanged for the other filter values (positive, negative, or all_stars) and is omitted entirely when filter_by_keyword is used (i.e. the value will be same as total_results).
Another detail worth noting is that the format_type parameter also affects the filtered_total_ratings value. For example, if you set format_type to current_format, the filtered_total_ratings value will be the number of ratings for the current format of the product, which may be different from the total number of ratings for the product.
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,
"platform": "amazon_reviews",
"url": "https://www.amazon.com/essence-Princess-Effect-Mascara-Cruelty/dp/B00T0C9XRK",
"sort_by": "recent",
"reviewer_type": "all_reviews",
"filter_by_star": "one_star",
"media_type": "media_reviews_only",
"format_type": "current_format",
"filter_by_keyword": null,
"page": 1,
"total_results": 322,
"filtered_total_reviews": 322,
"filtered_total_ratings": 322,
"no_of_pages": 33,
"result_count": 10,
"reviews": [
{
"id": "R1JJ71G3RVPU89",
"date": "2025-04-18",
"author_name": "H Stovall",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AEIDR5CQWHNSAJXZVPNA7XYTVTAQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "You get what you pay for!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R1JJ71G3RVPU89/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "Only purchase this cheap mascara if you have lots of time to remove the clumps and comb your lashes apart. It dries out super quickly and flakes a lot too. You get what you pay for here. I have long lashes to begin with so mascaras really have to suck for me to take notice.",
"review_imgs": [
"https://m.media-amazon.com/images/I/71mZtBGxwCL._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": "R3A9LBFVZAH8ZY",
"date": "2025-04-05",
"author_name": "Francine Nunez",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AG2MDD5HKVKUGQHNQDGYPUYKHIRA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "thickness must be less ...",
"review_url": "https://www.amazon.com/gp/customer-reviews/R3A9LBFVZAH8ZY/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "WOMEN DONT BE TELLING UNTRUTH , ITS DOESNT DO WHAT THESE LADIES SAY, NO LONG LASHES BUT FEELS LIKE CAKE FROSTY ON MY EYES ,SO THICK AND HORRIBLE AM RETURNING IT AND GOING BACK TO MY MASCARA❤️my hair long them my eyelashes lol 😁",
"review_imgs": [
"https://m.media-amazon.com/images/I/61HXQhGnCXL._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": "R3O2YU0TUFZCDF",
"date": "2025-03-19",
"author_name": "Cyndi Gonzalez",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGDMZUYIVWPRHH5NKZN4ZA3PGVKQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "Won’t waste my money",
"review_url": "https://www.amazon.com/gp/customer-reviews/R3O2YU0TUFZCDF/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "The and was completely bent. I could barely pull it out. Was not able to use at all. Tried to return it but shipping was more than I paid for it.",
"review_imgs": [
"https://m.media-amazon.com/images/I/71X5Lh7ODaL._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": "R3H59SDE6KYPQF",
"date": "2025-03-12",
"author_name": "Shanice Lynn",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHAQENCC2NF4V57PEOS3FKGYM6OQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "Came broken",
"review_url": "https://www.amazon.com/gp/customer-reviews/R3H59SDE6KYPQF/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "My spolie came broken very disappointing. The return process isn’t worth it for a 5 dollar mascara",
"review_imgs": [
"https://m.media-amazon.com/images/I/51WVXiz+PVL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/51fLoiAv7iL._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": "R1R7S3BCD3S045",
"date": "2025-03-09",
"author_name": "Amazon Customer",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AEWXM6O7FDVNEM35YX53XLCYU4NQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "Smudges like crazy!",
"review_url": "https://www.amazon.com/gp/customer-reviews/R1R7S3BCD3S045/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "Based on all the awesome reviews, I had high hopes for this mascara. Unfortunately it smudged so badly on me. 30 minutes after I applied it, I looked like a raccoon. I wiped it off undermy eye and applied fresh makeup. Within 20 minutes it smudged badly again. Good thing it was only $5. Buyer beware.",
"review_imgs": [
"https://m.media-amazon.com/images/I/71v3XFJ9AyL._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": "R2YVUGL5RNP4YA",
"date": "2025-01-02",
"author_name": "Leigh tyrell",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AEFRY57O5RT7EZY4K7FL7F7SSCSA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "Smudges easily",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2YVUGL5RNP4YA/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "This mascara is all under your eyes before you can grab a tissue",
"review_imgs": [
"https://m.media-amazon.com/images/I/51FZNDW5b+L._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": "R2O3F02J5CB92K",
"date": "2025-01-01",
"author_name": "kary R.",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AG6JSHDSD5DY3ECVZNRNDMNC5E4A/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "Dry, no product inside.",
"review_url": "https://www.amazon.com/gp/customer-reviews/R2O3F02J5CB92K/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "I'm so upset. I love this mascara. I got it from essence website last time and was good and my eyelash got beautiful with product. But this one from Amazon it seems like there's no product inside. A rip off.",
"review_imgs": [
"https://m.media-amazon.com/images/I/615TCpyZOJL._SL1600_.jpg",
"https://m.media-amazon.com/images/I/61oVSupnnDL._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": "R1KJD1661OR76F",
"date": "2024-12-30",
"author_name": "Esther",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHCB6EQMJ3VDS5PM24B4X2F267VQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "Defective",
"review_url": "https://www.amazon.com/gp/customer-reviews/R1KJD1661OR76F/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "The media could not be loaded.\n \n\n\n\nThe item didn't have the stopper so every bit of mascara comes out at once rendering it unusable. Because it was purchased via Essence on Amazon their customer service said they could do nothing that it was up to Amazon to refund or replace the item.",
"review_imgs": [],
"review_videos": [
"https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/02031853-20d7-4b95-9c74-fcb89a3c6ad9/embedded.cc.default.vertical.jobtemplate.hls.m3u8"
],
"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": "RAWSV2IDVLXXU",
"date": "2024-12-18",
"author_name": "Maigan Vicencio",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AHIEDFVGWJGDY5ENU5JBOHPVK7WA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "No volume",
"review_url": "https://www.amazon.com/gp/customer-reviews/RAWSV2IDVLXXU/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "This mascara doesn’t do anything but clump up. It doesn’t give you full or long eyelashes. It just has one of those skinny little brushes that doesn’t do much.",
"review_imgs": [
"https://m.media-amazon.com/images/I/61NSc77PIRL._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": "R3OMLQFR206CL4",
"date": "2024-12-09",
"author_name": "Amazon Customer",
"author_url": "https://www.amazon.com/gp/profile/amzn1.account.AGWN2RISDO7UTE2SJYA3OEY5KZKQ/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"rating": 1,
"review_title": "Thick, clumpy, not useable.",
"review_url": "https://www.amazon.com/gp/customer-reviews/R3OMLQFR206CL4/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B00T0C9XRK",
"review_text": "Not useable, clumpy",
"review_imgs": [
"https://m.media-amazon.com/images/I/818ZlTwi+mL._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"
}
],
"meta_data": {
"total_ratings": 387988,
"rating_distribution": {
"5 star": "66%",
"4 star": "14%",
"3 star": "10%",
"2 star": "4%",
"1 star": "6%"
},
"cookie": "<Updated cooke value>"
},
"credits_used": 1,
"remaining_credits": 9617337.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.