Reviews API

List Product Reviews

GET /api/v1/products/:shopifyProductId/reviews

Returns paginated approved reviews for a product.

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number
per_page	integer	10	Results per page (max 50)
sort	string	newest	Sort order: newest, oldest, highest, lowest, most_helpful

Response

{
  "data": [
    {
      "id": 123,
      "customerName": "Jane D.",
      "rating": 5,
      "title": "Love this product!",
      "body": "Great quality and fast shipping.",
      "photos": ["https://images.swiftreviews.app/reviews/..."],
      "verifiedPurchase": true,
      "helpfulCount": 3,
      "replyBody": "Thank you for your review!",
      "repliedAt": "2025-01-20T10:00:00Z",
      "createdAt": "2025-01-15T14:30:00Z"
    }
  ],
  "page": 1,
  "perPage": 10,
  "total": 42,
  "hasMore": true
}

Get Single Review

GET /api/v1/reviews/:id

Returns a single review by ID.

Submit a Review

POST /api/v1/reviews

Request Body

{
  "productId": "7654321098",
  "customerEmail": "jane@example.com",
  "customerName": "Jane D.",
  "rating": 5,
  "title": "Love this product!",
  "body": "Great quality and fast shipping."
}

Response (201)

{
  "id": 124,
  "status": "pending"
}

The status will be "approved" if the shop has auto-approve enabled.