v1

latestOpenAPI 3.0.02026-07-24283460.8 KB
Legacy
Reviews and Questions

Retrieve Product Reviews

get/product/review

Query parameters

storestring required

Your REVIEWS.io public store key

apikeystring

Your REVIEWS.io private api key. This will add additional private data to the API response such as reviewer email addresses.

skustring

Product SKUs, seperated by semi colons

mpnstring

Product MPNs, seperated by semi colons

pagenumber

Page of results to return

per_pagenumber

How many items to return per page

photosboolean

Only return reviews with photos

verified_onlyboolean

Include image of the reviewed product

comments_onlyboolean

Only return reviews with comments

minRatingnumber

Return reviews with rating higher than minRating.

include_unpublished_imagesboolean

Return images that haven't been published

include_moderatedboolean

Include reviews that have been moderated

min_datestring date

Return reviews newer than min_date.

max_datestring date

Return reviews older than max_date.

min_updatedstring date

Return reviews updated since min_updated.

max_updatedstring date

Return reviews before than max_updated.

Response

OK

Example response

{
  "store": {
    "name": "Demo Store",
    "logo": "https://s3-eu-west-1.amazonaws.com/reviewscouk/assets/demo-16648/demo-logo.png"
  },
  "stats": {
    "average": "4.7",
    "count": "6"
  },
  "reviews": {
    "total": "6",
    "per_page": "15",
    "current_page": "1",
    "last_page": "1",
    "from": "1",
    "to": "1",
    "data": [
      {
        "review": "Great product, use it everynight!",
        "sku": "1234",
        "rating": "4",
        "date_created": "2016-02-27 15:53:59",
        "reviewer": {
          "first_name": "Mavis",
          "last_name": "Beacon",
          "verified_buyer": "yes"
        },
        "product": {
          "sku": "1234",
          "name": "Amazon Kindle Paperwhite",
          "description": "E-Reader",
          "image_url": "http://www.testshop.com/image/test.jpg",
          "mpn": "1445",
          "brand": "amazon",
          "category": "tablets"
        }
      }
    ]
  }
}