Products API

List Products

GET /api/v1/products

Returns all products with review statistics.

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number
per_page	integer	20	Results per page (max 50)

Response

{
  "data": [
    {
      "id": 1,
      "shopifyProductId": "7654321098",
      "title": "Classic T-Shirt",
      "handle": "classic-t-shirt",
      "imageUrl": "https://cdn.shopify.com/...",
      "averageRating": 4.6,
      "reviewCount": 42,
      "ratingDistribution": { "1": 1, "2": 2, "3": 3, "4": 12, "5": 24 }
    }
  ],
  "page": 1,
  "perPage": 20,
  "total": 15,
  "hasMore": false
}

Get Product Summary

GET /api/v1/products/:shopifyProductId/summary

Returns aggregate review data for a single product.

Response

{
  "averageRating": 4.6,
  "reviewCount": 42,
  "ratingDistribution": { "1": 1, "2": 2, "3": 3, "4": 12, "5": 24 }
}