Core APIs
...
Results
Customer Feedback

Reviews v2

2min

Reviews Results

When you make a request to the Rainforest API with the type parameter set to type=reviews_v2, along with the asin and amazon_domain parameters, the API will retrieve the most recent reviews from the specified product page.

Reviews are retrieved from the product page on Amazon.

Document image


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

JSON


Rainforest API returns the following properties for reviews_v2 / most_recent reviews on the product page:

Property

Type

Description

reviews_header

string

The string of the most_recent reviews header

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.



  • 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.



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



  • 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.
    • 
      1. image
      2. string
      3. An image URL for the profile



  • 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.



  • 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".


Next Steps      Reviews Parameters