ScrapeIN Amazon Reviews API Response Description
When making a request with the /reviews
endpoint ScrapeIN returns results from the Amazon domain specified in either the asin
and amazon_domain
parameters or the url
parameter.

ScrapeIN retrieves results from the customer reviews page for a single product on Amazon with the following properties:
JSON Example
{
"request_parameters": {
"amazon_domain": "amazon.com",
"asin": "B08WGFKSMW",
"output": "json",
"type": "reviews"
},
"request_metadata": {
"created_at": "2023-06-30T19:25:31.524Z",
"processed_at": "2023-06-30T19:25:32.796Z",
"total_time_taken": 1.27,
"amazon_url": "https://www.amazon.com/product-reviews/B08WGFKSMW/"
},
"product": {
"title": "LG OLED C1 Series 77\" Alexa Built-in 4k Smart TV, 120Hz Refresh Rate, AI-Powered, Dolby Vision IQ and Dolby Atmos, WiSA Ready, Gaming Mode (OLED77C1PUB, 2021)",
"link": "https://www.amazon.com/LG-OLED77C1PUB-Alexa-Built-Smart/dp/B08WGFKSMW/ref=cm_cr_arp_d_product_top?ie=UTF8",
"sub_title": {
"text": "LG",
"link": "https://www.amazon.com/stores/LGElectronicsSTG/page/E8585304-4D77-4965-9D22-B5F2CF409E38?ref_=ast_bln"
},
"image": "https://m.media-amazon.com/images/I/51mfefisnwS._AC_US60_SCLZZZZZZZ__.jpg",
"asin": "B08WGFKSMW",
"attributes": [
{
"name": "Size",
"value": "77 inch"
},
{
"name": "Style",
"value": "TV Only"
}
]
},
"summary": {
"rating": 4.7,
"ratings_total": 6982,
"ratings_total_filtered": 6982,
"reviews_total_filtered": 1419,
"reviews_total": 1419,
"rating_breakdown": {
"five_star": {
"percentage": 87,
"count": 6074
},
"four_star": {
"percentage": 7,
"count": 488
},
"three_star": {
"percentage": 2,
"count": 139
},
"two_star": {
"percentage": 1,
"count": 69
},
"one_star": {
"percentage": 3,
"count": 209
}
}
},
"top_positive": {
"id": "R35SI7CJF7V00J",
"title": "Fantastic TV And Actually A Great Value At 83\"",
"body": "Got the C1 in November 2021 and absolutely adore. As is well known, the black levels are amazing in a light-controlled room. The picture and the ability to customize it just how you want it is spectacular.The apps and OS are fine, if not a bit slow (I use the Amazon FireTV Cube for entertainment apps). And as a gaming TV? Peerless. The VRR is awesome and the Gaming UI is very handy.My ONLY complaint is that 83\" is the biggest size. I want a 98\"-100\" TV.",
"asin": "B08WGFKSMW",
"body_html": "<span class=\"a-size-base\">Got the C1 in November 2021 and absolutely adore. As is well known, the black levels are amazing in a light-controlled room. The picture and the ability to customize it just how you want it is spectacular.<br><br>The apps and OS are fine, if not a bit slow (I use the Amazon FireTV Cube for entertainment apps). And as a gaming TV? Peerless. The VRR is awesome and the Gaming UI is very handy.<br><br>My ONLY complaint is that 83\" is the biggest size. I want a 98\"-100\" TV.</span>",
"link": "https://www.amazon.com/gp/customer-reviews/R35SI7CJF7V00J/ref=cm_cr_arp_d_viewpnt?ie=UTF8&ASIN=B08WGFKSMW#R35SI7CJF7V00J",
"rating": 5,
"date": {
"raw": "Reviewed in the United States on June 19, 2023",
"utc": "2023-06-19T00:00:00.000Z"
},
"profile": {
"name": "Aaron T Starks",
"link": "https://www.amazon.com/gp/profile/amzn1.account.AFFCU44TNQOLKPLMRGUEUNLMOVQA/ref=cm_cr_arp_d_gw_lft?ie=UTF8",
"id": "AFFCU44TNQOLKPLMRGUEUNLMOVQA"
},
"vine_program": false,
"verified_purchase": false,
"review_country": "us",
"is_global_review": false
},
"top_critical": {
"id": "R29L1J6ZRV9MU3",
"title": "A quarter in, I have 2400+ words of thoughts on the LG C1",
"body": "[This is adapted from my review on code.Antrikshy.com]I put off writing this review for so long because my thoughts on this TV are not easy to compile into words. This review is the culmination of very heavy use over a whole quarter, me ruminating over all aspects of this product, and several conversations I've had with different people about this purchase.To help set the stage, perhaps I should start with my profile as a consumer. In summary:- I am very discerning about picture quality. many hours over days to get picture modes and settings *just* right on a new TV.- I am extremely particular about user experience in software. Part of my professional work happens to involve some UX design.- I watch a lot of movies. And I mean... A LOT. Hundreds per year.- I tend to use my TVs very heavily. In the work-from-home world, I have this TV on for more than half of my waking hours of an average work day.When my 2016 Vizio P-Series gave up after 5 years of heavy use, I set off on my journey of picking just the right successor. I settled on what many reviewers consider the absolute best TV for movies (thanks Rtings, Digital Trends, others). This excludes exorbitantly expensive models, and the Sony A80J. That one was significantly more expensive at the time of my purchase. As a bonus, the LG C1 came with cutting edge gaming features like modern VRR support, new HDMI standards, low input latency and whatnot.I briefly considered buying one of those newfangled mini-LED models from LG and Samsung for their benefits - no risk of burn-in, extremely high brightness (for my sometimes bright living room). I decided against them as:- Mini-LED new and I'd rather let the market settle and develop before committing. Speaking of new panel tech, I have fingers crossed for micro-LED panels.- I saw an LG mini-LED (aka QNED) in person at Best Buy and I wasn't blown away by it, even in comparison with their standard LED-lit LCD panels.- Samsung doesn't support Dolby Vision at all, so I dropped them from consideration entirely. I find DV very noticeably better than HDR10, and I happen to consume a lot of DV content from Netflix, Disney+ etc.- I was sort of envious of OLED panels after hearing people rave about them for years.- My usage patterns don't have me that concerned about OLED burn-in.",
"asin": "B08WGFKSMW",
"body_html": "<span class=\"a-size-base\">[This is adapted from my review on code.Antrikshy.com]<br><br>I put off writing this review for so long because my thoughts on this TV are not easy to compile into words. This review is the culmination of very heavy use over a whole quarter, me ruminating over all aspects of this product, and several conversations I've had with different people about this purchase.<br><br>To help set the stage, perhaps I should start with my profile as a consumer. In summary:<br><br>- I am very discerning about picture quality. many hours over days to get picture modes and settings *just* right on a new TV.<br>- I am extremely particular about user experience in software. Part of my professional work happens to involve some UX design.<br>- I watch a lot of movies. And I mean... A LOT. Hundreds per year.<br>- I tend to use my TVs very heavily. In the work-from-home world, I have this TV on for more than half of my waking hours of an average work day.<br><br>When my 2016 Vizio P-Series gave up after 5 years of heavy use, I set off on my journey of picking just the right successor. I settled on what many reviewers consider the absolute best TV for movies (thanks Rtings, Digital Trends, others). This excludes exorbitantly expensive models, and the Sony A80J. That one was significantly more expensive at the time of my purchase. As a bonus, the LG C1 came with cutting edge gaming features like modern VRR support, new HDMI standards, low input latency and whatnot.<br><br>I briefly considered buying one of those newfangled mini-LED models from LG and Samsung for their benefits - no risk of burn-in, extremely high brightness (for my sometimes bright living room). I decided against them as:<br><br>- Mini-LED new and I'd rather let the market settle and develop before committing. Speaking of new panel tech, I have fingers crossed for micro-LED panels.<br>- I saw an LG mini-LED (aka QNED) in person at Best Buy and I wasn't blown away by it, even in comparison with their standard LED-lit LCD panels.<br>- Samsung doesn't support Dolby Vision at all, so I dropped them from consideration entirely. I find DV very noticeably better than HDR10, and I happen to consume a lot of DV content from Netflix, Disney+ etc.<br>- I was sort of envious of OLED panels after hearing people rave about them for years.<br>- My usage patterns don't have me that concerned about OLED burn-in.<br><br>
"link": "https://www.amazon.com/gp/customer-reviews/R29L1J6ZRV9MU3/ref=cm_cr_arp_d_viewpnt?ie=UTF8&ASIN=B08WGFKSMW#R29L1J6ZRV9MU3",
"rating": 3,
"date": {
"raw": "Reviewed in the United States on January 2, 2022",
"utc": "2022-01-02T00:00:00.000Z"
},
"profile": {
"name": "Antriksh Yadav",
"link": "https://www.amazon.com/gp/profile/amzn1.account.AEOIBKCQL2QYZ6SIT62C6IWHK34Q/ref=cm_cr_arp_d_gw_rgt?ie=UTF8",
"id": "AEOIBKCQL2QYZ6SIT62C6IWHK34Q",
"image": "https://images-na.ssl-images-amazon.com/images/S/amazon-avatars-global/08022cf5-c40c-4cfb-946a-5a444186066f._CR0,0,2629,2629_SX48_.jpg"
},
"vine_program": false,
"verified_purchase": false,
"helpful_votes": 247,
"review_country": "us",
"is_global_review": false
},
"reviews": [
{
"id": "R35SI7CJF7V00J",
"title": "5.0 out of 5 stars\n\n\n\n\n\n\n\n \n \n Fantastic TV And Actually A Great Value At 83\"",
"body": "Got the C1 in November 2021 and absolutely adore. As is well known, the black levels are amazing in a light-controlled room. The picture and the ability to customize it just how you want it is spectacular. The apps and OS are fine, if not a bit slow (I use the Amazon FireTV Cube for entertainment apps). And as a gaming TV? Peerless. The VRR is awesome and the Gaming UI is very handy. My ONLY complaint is that 83\" is the biggest size. I want a 98\"-100\" TV.",
"asin": "B08WG3243Z",
"body_html": "<span>Got the C1 in November 2021 and absolutely adore. As is well known, the black levels are amazing in a light-controlled room. The picture and the ability to customize it just how you want it is spectacular.<br><br>The apps and OS are fine, if not a bit slow (I use the Amazon FireTV Cube for entertainment apps). And as a gaming TV? Peerless. The VRR is awesome and the Gaming UI is very handy.<br><br>My ONLY complaint is that 83\" is the biggest size. I want a 98\"-100\" TV.</span>",
"link": "https://www.amazon.com/gp/customer-reviews/R35SI7CJF7V00J/ref=cm_cr_arp_d_rvw_ttl?ie=UTF8&ASIN=B08WGFKSMW",
"rating": 5,
"date": {
"raw": "Reviewed in the United States on June 19, 2023",
"utc": "2023-06-19T00:00:00.000Z"
},
"profile": {
"name": "Aaron T Starks",
"link": "https://www.amazon.com/gp/profile/amzn1.account.AFFCU44TNQOLKPLMRGUEUNLMOVQA/ref=cm_cr_arp_d_gw_btm?ie=UTF8",
"id": "AFFCU44TNQOLKPLMRGUEUNLMOVQA"
},
"vine_program": false,
"verified_purchase": true,
"attributes": [
{
"name": "Size",
"value": "83 inch"
},
{
"name": "Style",
"value": "TV Only"
}
],
"attributes_flat": "Size: 83 inch, Style: TV Only",
"review_country": "us",
"is_global_review": false,
"position": 1
},
],
"pagination": {
"ratings_total_filtered": 6982,
"reviews_total_filtered": 1419,
"reviews_total": 1419,
"total_results": 1419,
"total_pages": 142,
"message": "There are a high number of reviews for this product. It is likely Amazon will not allow pagination through all of the review pages. Please check the API response for presence of the 'reviews' array before continuing to the next page.",
"current_page": 1,
"start": 1,
"end": 10
}
}
ScrapeIN returns the following properties for requests with the /reviews
endpoint:
JSON Structure
The JSON structure returned by the Amazon Customers Feedback API includes required elements, such as request_parameters
, request_metadata
, pagination
, as described in the Results Amazon Data API section, as well as those specific to Amazon Reviews data, which are described below.
reviews
An array of objects containing customers reviews. Each object has the following properties:
id
: The unique ID of the customer review.title
: The title of the review.body
: The body text of the review. In some cases, a review may only have a title and no body text. When this happens, thebody
property will be missing from the review.body_html
: The HTML version of the review body.images
: An array of customer image objects.videos
: An array of customer video objects.link
: The link to the review.
Note on Global Reviews
Please note that Global Reviews, which can be identified by having a
review_country
property is different from the target Amazon domain and ifis_global_review=true
, nolink
is published.
rating
: The product rating that is given by the reviewer, out of 5.helpful_votes
: The number of helpful votes the review has received.comments
: The number of comments the review has received.review_country
: The country where the review was written. Expressed as a two-letter ISO country code.is_global_review
: True/false indicating if the review is a Global Review from another Amazon domain.
Note on Global Reviews
Global Reviews don't have a review
link
. However, you can find the home country of the Global Review in thereview_country
property.
verified_purchase
: Specifies if the reviewer is an Amazon-verified purchaser.vine_program
: Indicates if the reviewer reviewed the product is under the Amazon Vine program.vine_program_free_product
: Indicates if the Amazon Vine program "Vine Customer Review of Free Product" badge is shown. Only populated whenvine_program=true
.attributes
: An array of product attributes as displayed below the product title on the customer reviews page.name
: The name of the product attribute.value
: The value of the product attribute.
date object
: Contains details about the date of the review.raw
: The raw date as retrieved from the Amazon page.utc
: The date of the review in ISO 8601 format. If ScrapeIN cannot parse the raw date, then this property will be null.
profile object
: Contains details about the reviewer's profile.name
: The reviewer's profile name.link
: A link to the reviewer's profile page on the Amazon domain.id
: The reviewer's profile ID can be specified as a request parameter with the/reviewer_profile
endpoint to view the public profile of this reviewer.
manufacturer reply object
: Contains details of the product manufacturer's reply to the customer review.body
: Any further comments about the product being reviewed.date
: An object contains details about the date of the manufacturer's reply.raw
: The raw date as retrieved from the Amazon page.utc
: The date of the manufacturer's reply in ISO 8601 format. If ScrapeIN cannot parse the raw date, then this property will be null.
profile
: Contains details about the manufacturer's profile.name
: The manufacturer's profile name.link
: A link to the manufacturer's profile page on the Amazon domain.id
: The manufacturer's profile ID.
top_positive
The most helpful positive customer review. It has the same properties as the Review object.
top_critical
The most helpful critical customer review. It has the same properties as the Review object.
product
An object containing details of the product that is shown on the Customer Reviews page. It includes:
title
: The product name.link
: The product page link.is_prime status
: Indicates if the product is eligible for Prime (true/false).image link
: A link to the image of the product.asin
: The Amazon product ID for the product.sub_title
: An object contains details about the subtitle displayed directly beneath the product title. It is represented as an object with the following properties:text
: Represents the text of the subtitle. It typically corresponds to the brand name of the product.link
: Represents the link associated with the subtitle. It usually directs to the manufacturer's page on the Amazon domain, providing additional information about the product.
attributes
: An array containing details of the product attributes shown underneath the product title. Each attribute consists of aname
and its correspondingvalue
.attributes_flat
: A representation of the attributes array in a comma-separated format. This format is useful when using CSV output (output=csv
), as the nestedattributes
array cannot be represented directly in CSV format.price
: An object contains details about the product's pricing, including thecurrency
,symbol
,value
, andraw
price.shipping
: An object contains details about the product's shipping, including theraw
shipping text as shown on the customer reviews page.
summary
An object containing a summary of all reviews for the product, including
overall rating
: Out of 5.ratings_total
: The total number of customer ratings the product has received.reviews_total
: The total number of customer reviews the product has received.reviews_positive
: The total number of positive reviews the product has received.reviews_critical
: The total number of critical reviews the product has received.rating_breakdown
: An object containing the total number of customer ratings the product has received, per star rating.
pagination
Note on Paginating Results
To retrieve more reviews from Amazon, you can issue additional requests by increasing the
page
parameter. Amazon normally returns 10 reviews per page.
Contains details of the current Reviews page and the total number of Reviews pages available. It includes the current page
number, total pages
available, total reviews
, number of reviews across all pages, and the indexing of the start
and end
numbers for the reviews returned in this request.