Product Reviews

Gets the reviews associated with a product. (Default sorting is by review id, from lowest to highest.)

GET /stores/{store_hash}/v2/products/{id}/reviews

Filters

There are no filter parameters specific to product reviews.

Pagination

Parameters can be added to the URL query string to paginate the collection. The maximum limit is 250. If a limit isn’t provided, up to 50 product_reviews are returned by default.

Response

Example JSON returned in the response:

[
  {
    "id": 190,
    "product_id": 5310,
    "author": "John Doe",
    "date_created": "Wed, 12 Dec 2012 06:00:00 +0000",
    "title": "My experience with the widget",
    "review": "This widget worked for me, but might not work for everyone.",
    "rating": 4,
    "status": 1
  },
  {
    "id": 191,
    "product_id": 5310,
    "author": "Jane Doe",
    "date_created": "Tue, 12 Nov 2013 06:00:00 +0000",
    "title": "Great product, slow shipping",
    "review": "Took two weeks to arrive",
    "rating": 3,
    "status": 1
  },
  {
    "id": 192,
    "product_id": 5310,
    "author": "Jimmy Doe",
    "date_created": "Fri, 14 Dec 2012 06:00:00 +0000",
    "title": "Worked for me!",
    "review": "I thought this product was pretty good",
    "rating": 5,
    "status": 1
  }
]

Gets a product review.

GET /stores/{store_hash}/v2/products/{product_id}/reviews/{id}

Response

Example JSON returned in the response:

{
  "id": 190,
  "product_id": 5310,
  "author": "John Doe",
  "date_created": "Wed, 12 Dec 2012 06:00:00 +0000",
  "title": "My experience with the widget",
  "review": "This widget worked for me, but might not work for everyone.",
  "rating": 4,
  "status": 1
}

Creates a new product review.

Note

The review property is the review’s text. The rating property must be a whole number between 1–5. If the optional date_created property is not specified, it defaults to the current date/time. If the optional “status” property is not specified, it defaults to 0 [Pending]. Other allowable values are 1 [Approved] or 2 [Disapproved].)

POST /stores/{store_hash}/v2/products/{product_id}/reviews

Read-only Properties

The following properties of the product review are read-only. If one or more of these properties are included in the request, it will be rejected.

• id
• product_id

Requirements

The following properties of the product review are required. The request won’t be fulfilled unless these properties are valid.

• author
• title
• review
• rating

Response

Example JSON returned in the response:

{
  "id": 8,
  "product_id": 32,
  "author": "Jimmy Doe",
  "date_created": "Tue, 05 Mar 2013 06:00:00 +0000",
  "title": "Worked for me!",
  "review": "I thought this product was pretty good",
  "rating": 5,
  "status": 0
}

Updates an existing product review. Your request may update any of the properties that are writable for the Create (POST) operation.

PUT /stores/{store_hash}/v2/products/{product_id}/reviews/{id}

Read-only Properties

The following properties of the product review are read-only. If one or more of these properties are included in the request, it will be rejected.

• id
• product_id

Response

Example JSON returned in the response:

{
  "id": 8,
  "product_id": 32,
  "author": "Jimmy Doe",
  "date_created": "Tue, 05 Mar 2013 06:00:00 +0000",
  "title": "Worked for me!",
  "review": "I thought this product was pretty good",
  "rating": 5,
  "status": 1
}

Deletes a specified product review. (If successful, this will typically return a 204 No Content.)

DELETE /stores/{store_hash}/v2/products/{product_id}/reviews/{id}

Deletes all reviews for the specified product. (If successful, this will typically return a 204 No Content.)

DELETE /stores/{store_hash}/v2/products/{product_id}/reviews