Get Product Reviews
Retrieve a paginated list of reviews and ratings for a specific product.
Endpoint
GET /api/shop/products/{productId}/reviewsRequest Headers
| Header | Required | Description |
|---|---|---|
Content-Type | Yes | application/json |
X-STOREFRONT-KEY | Yes | Your storefront API key |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
productId | integer | Yes | Product ID |
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number |
limit | integer | 10 | Reviews per page |
sort | string | latest | Sort by (latest, oldest, helpful, rating) |
rating | integer | - | Filter by rating (1-5) |
status | string | approved | Filter by status (approved, pending, rejected) |
Response Fields (200 OK)
| Field | Type | Description |
|---|---|---|
id | integer | Review ID |
productId | integer | Product ID reviewed |
title | string | Review title |
comment | string | Review comment/content |
rating | integer | Rating (1-5 stars) |
authorName | string | Reviewer name |
authorEmail | string | Reviewer email |
status | string | Review status (approved, pending, rejected) |
helpful | integer | Number of helpful votes |
unhelpful | integer | Number of unhelpful votes |
createdAt | string | Review creation date |
updatedAt | string | Last update date |
Pagination
| Field | Type | Description |
|---|---|---|
total | integer | Total reviews for product |
perPage | integer | Reviews per page |
currentPage | integer | Current page |
Use Cases
- Display product reviews on detail pages
- Show review ratings and statistics
- Filter reviews by rating
- Load recent reviews
- Build review management interfaces