Shopify Store Reviews API
Reviews the store publishes about itself, not tied to one product.
GET /v1/shopify/store/reviews1 credit Failed requests are free
About this endpoint
GET /v1/shopify/store/reviews?store=… returns data.reviewsAvailable, data.reviews and data.page. Review rows use the same fields as product reviews: id, rating, title, body, author, verified, recommended, helpfulCount, language, createdAt, updatedAt, reply, media and customQuestions.
The route finds the widget on the store's home page. A store that publishes reviews only on product pages returns reviewsAvailable: false with an empty list. Use sort and rating to narrow, and limit and cursor to page.
Shopify Store Reviews API FAQ
Why is reviewsAvailable false?
The store did not publish a supported store-wide review widget. A widget that appears only on product pages is not visible to this route.
How do store reviews differ from product reviews?
Store reviews are about the merchant. Product reviews are tied to one product and are available on the product review route.
How do I page?
Read page.hasMore and pass page.nextCursor back as cursor with the same filters.
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. Each paginated page is a separate billed request.
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.