Shopify Product Review Summary API
The aggregate rating and star breakdown for one product.
GET /v1/shopify/products/{handle}/reviews/summary1 credit Failed requests are free
About this endpoint
GET /v1/shopify/products/{handle}/reviews/summary?store=… returns data.reviewsAvailable and data.summary. The summary has rating, ratingCount, a distribution with one to five counts, recommendedCount and mediaCount.
summary is null when the store publishes no supported review widget. reviewsAvailable is false in that case, and also when a widget exists but gives no aggregate.
Shopify Product Review Summary API FAQ
Why is summary null?
The store did not publish a review summary for this product. Check reviewsAvailable: false means the store has no supported review widget.
What is in distribution?
The number of ratings at each star, from one to five. Each star count can be null when the widget does not publish it.
Do I need this route if I already list reviews?
The summary is cheaper to read when you only need the average and star counts. Use the review list when you need the text.
How do I name the store?
The store is the domain, for example allbirds.com, www.allbirds.com or weareallbirds.myshopify.com. A full URL is reduced to its host.
How is it billed?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
What does lookupStatus mean?
found means the lookup succeeded. not_found means the store or entity does not exist or is not a Shopify store. private means the storefront is password-protected. restricted means it is paused or frozen. HTTP 200 only means the request finished, so branch on lookupStatus.