Core APIs
...
Results
Customer Feedback

Reviews

3min

Reviews Results

When making a request with the type parameter set to type=reviews Rainforest API will return all Customer Reviews for the product specified in either the asin and amazon_domain parameters or the url parameter.

Reviews are retrieved from the customer reviews page for a single product on Amazon.

Customer Reviews Page
Customer Reviews Page


An example of the JSON object returned from a Reviews request is shown below:

JSON


Rainforest API returns the following properties for Reviews requests:

Paginating Results Amazon returns 10 reviews per page. To request more reviews issue additional requests incrementing the page parameter.

Property

Type

Description

reviews

array

An array of Review objects, containing each of the Customer Reviews shown on the Customer Reviews page. The Review object has the following properties:

  • id
  • string
  • The unique, Amazon-assigned, ID of the customer review. This can be used by your app to flag whether you have previously processed this review on a prior request.



  • title
  • string
  • The title of the review.



  • body
  • string
  • The body text of the review. Note it's possible for a review to contain only a title , and no body . In this case the body property will be absent.



  • body_html
  • string
  • The HTML of the review body, useful if you wish to preserve HTML formatting.



  • images
  • array
  • An array of customer image objects containing a link property to the customer-supplied review image.



  • videos
  • array
  • An array of customer video objects containing a image property (linking to the video thumbnail image) and a video property (a link to the customer video file).



  • link
  • string
  • The link to the review. Note that in the case of Global Reviews (identified by having a review_country other than that of the target Amazon domain and is_global_review=true ) no link is published.



  • rating
  • number
  • The product rating given by the reviewer, out of 5.



  • helpful_votes
  • number
  • The number of helpful votes this review has received from other Amazon customers.



  • comments
  • number
  • The number of comments this review has received.



  • review_country
  • string
  • The country the review was written in (in the case of Amazon Global Reviews). Expressed as a two-letter ISO country-code.



  • is_global_review
  • boolean
  • True/false depending on whether this review is a Global Review (i.e. a review from another Amazon domain), or not. Note that Global Reviews do not have a link property. The home country of the Global Review can be found in the review_country property.



  • verified_purchase
  • boolean
  • Whether this reviewer is an Amazon-verified purchaser of the product.



  • vine_program
  • boolean
  • Whether this reviewer reviewed this product under the Amazon Vine program.



  • vine_program_free_product
  • boolean
  • Whether the Amazon Vine program "Vine Customer Review of Free Product" badge is shown. Only populated when vine_program=true .
    • 

      Document image
      



  • attributes
  • array
  • Attributes Array The attributes array contains details of the product attributes as shown underneath the product title on the customer reviews page.
    • 
      1. name
      2. string
      3. The name of the product attribute i.e. "Capacity".
    • 
      1. value
      2. string
      3. The value of the product attribute i.e. "128 GB".



Date Object The date object contains details about the date of the review.

  • raw
  • string
  • The raw date as retrieved from the Amazon page.



  • utc
  • string
  • The date of the review, parsed from the raw date, in ISO 8601 format. If Rainforest API cannot parse the raw date then this property will be null.



Profile Object The profile object contains details of the profile of the reviewer.

  • name
  • string
  • The reviewer's profile name.



  • link
  • string
  • A link to the reviewer's profile page on the Amazon domain.



  • id
  • string
  • The reviewer profile ID. Can be specified as a request parameter to a type=reviewer_profile request to view this reviewers public profile.



Manufacturer Reply Object The Manufacturer Reply object contains details of product manufacturer's reply to the customer review.

  • body
  • string
  • Any further comments about the product being reviewed, i.e. "Item will come repackaged."



  • date
  • object
  • Date Object The date object contains details about the date of the manufacturer's reply.
    • 
      1. raw
      2. string
      3. The raw date as retrieved from the Amazon page.
    • 
      1. utc
      2. string
      3. The date of the manufacturer's reply, parsed from the raw date, in ISO 8601 format. If Rainforest API cannot parse the raw date then this property will be null.



  • profile
  • object
  • Profile Object The profile object contains details about the manufacturer's profile on the Amazon domain.
    • 
      1. name
      2. string
      3. The manufacturer's profile name.
    • 
      1. link
      2. string
      3. A link to the manufacturer's profile page on the Amazon domain.
    • 
      1. id
      2. string
      3. The manufacturer profile ID. Can be specified as a request parameter to a type=reviewer_profile request to view this manufacturers public profile.

top_positive

object

The most helpful positive customer review.

The properties of the top_positive object are identical to the Review object above.

top_critical

object

The most helpful critical customer review.

The properties of the top_critical object are identical to the Review object above.

product

object

An object containing details of the product (in so far as those details are shown on the Customer Reviews page). For full product details you should issue a request with type=product to retrieve details from the product page .

  • title
  • string
  • The product name.



  • link
  • string
  • The product page link.



  • is_prime
  • boolean
  • Determines whether the product is Prime-eligible or not.



  • image
  • string
  • A link to the image of the product.



  • asin
  • string
  • The Amazon product ID (ASIN) for the product.



  • sub_title
  • object
  • Subtitle Object The subtitle object contains details of the information shown in the subtitle directly underneath the product title.
    • 
      1. text
      2. string
      3. The text of the subtitle - typically the brand name of the product i.e. "Samsung".
    • 
      1. link
      2. string
      3. The link of the subtitle - typically to the manufacturers page on the Amazon domain.



  • attributes
  • array
  • Attributes Array The attributes array contains details of the product attributes as shown underneath the product title on the Customer Reviews page.
    • 
      1. name
      2. string
      3. The name of the product attribute i.e. "Capacity".
    • 
      1. value
      2. string
      3. The value of the product attribute i.e. "128 GB".



  • attributes_flat
  • string
  • A comma seperated representation of the attributes array, useful when using CSV output using output=csv where the nested attributes array cannot be represented in CSV format.



  • price
  • object
  • Price Object The price object contains details about the products pricing, as shown underneath the product title on the Customer Reviews page.
    • 
      1. symbol
      2. string
      3. The currency symbol, i.e. $ for USD.
    • 
      1. value
      2. number
      3. The price of the Offer.
    • 
      1. currency
      2. string
      3. The currency of the Offer as a ISO 4217 currency code.
    • 
      1. raw
      2. string
      3. The raw price as displayed on the Offer listing.



  • shipping
  • object
  • Shipping Object The shipping object contains details about the products shipping, as shown underneath the product title on the Customer Reviews page.
    • 
      1. raw
      2. string
      3. The raw shipping text as shown on the customer reviews page.

summary

object

An object containing a summary of all reviews for the product, as shown at the top-left of the Customer Reviews page.

  • rating
  • number
  • The overall rating of the product, out of 5.



  • ratings_total
  • number
  • The total number of customer ratings the product has received.



  • reviews_total
  • number
  • The total number of customer reviews the product has received.



  • reviews_positive
  • number
  • The total number of positive reviews the product has received.



  • reviews_critical
  • number
  • The total number of critical reviews the product has received.



  • rating_breakdown
  • object
  • An object containing the total number of customer ratings the product has received, per star rating.

pagination

object

An object containing details of the current Reviews page and the total number of Reviews pages that are available. To paginate you should specify the page number in your request's page parameter .

  • current_page
  • number
  • The current page number.



  • total_pages
  • number
  • The total number of pages available.



  • reviews_total
  • number
  • The total number of reviews across all pages.



  • start
  • number
  • The starting index of reviews returned in this request.



  • end
  • number
  • The ending index of reviews returned in this request.


Next Steps      Reviews Parameters