shop.reviews.list(productId, limit?)
Returns approved reviews for a product, ordered by newest first.
Parameters
| Param | Type | Default | Description |
|---|
productId | string | — | The product’s UUID |
limit | number | 50 | Max reviews to return (max 100) |
Response
Example — Review list with star rating
shop.reviews.submit(params)
Submits a new review for a product. Reviews require seller approval before appearing publicly.
Parameters
| Param | Type | Required | Description |
|---|
product_id | string | ✅ | UUID of the product being reviewed |
rating | number | ✅ | Integer between 1 and 5 |
review_text | string | ❌ | Written review |
customer_name | string | ❌ | Reviewer’s name |
customer_email | string | ❌ | Reviewer’s email |
image_url | string | ❌ | URL of an attached image |
Response
Submitted reviews are not immediately visible. They require manual approval from the shop owner in their seller dashboard.