List Shopify product reviews
List a Shopify product's reviews, ratings and review media the store publishes.
Headers
Get your API keyAPI key (`sfk_...`)
The product handle, as it appears in its URL.
min 1 chars · max 255 chars · pattern: ^[^\s/?#]+$
The store's domain, for example `allbirds.com`, `www.allbirds.com` or `weareallbirds.myshopify.com`. A full URL is accepted and reduced to its host. Only public storefront hosts are accepted.
Reviews per page, 1 to 250. Default: 25.
≥ 1 · ≤ 250
Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
min 1 chars · max 4096 chars
`newest` (default), `rating`, `helpful` or `with_photos`. A sort the store's reviews do not support is ignored.
one of: newest, rating, helpful, with_photos
Only reviews with this star rating, 1 to 5.
≥ 1 · ≤ 5
Endpoint-specific response payload.
`found` on success; `not_found` when it does not exist or is not a Shopify store; `private` when the storefront is password-protected; `restricted` when the store is paused or frozen.
one of: found, not_found, private, restricted
The store host that was requested.
The product handle that was requested.
False when the store publishes reviews in a form this endpoint does not support, so `reviews` is empty because none are available, not because there are no reviews.
Reviews on this page.
The review id.
Numeric product id.
Product handle the review names, where the store publishes one.
Star rating, 1 to 5.
Review title.
Review text.
The reviewer's public display name.
Display name.
Reviewer location where published.
Reviewer country where published.
Verified buyer.
Would recommend.
Received a incentive.
Helpful votes.
Unhelpful votes where the store publishes them.
The store's moderation status where it publishes one.
Review language code.
Created, ISO 8601 UTC.
Updated, ISO 8601 UTC.
Variant the review is about.
Variant SKU.
The merchant's public reply.
Attached images.
Full-size URL.
Alt text.
Width.
Height.
Sentiment score where exposed.
Answers to the vendor's custom questions.
Question.
Answer.
Pagination state for the current page.
Whether another page is available.
Cursor for the next page; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/shopify/products/bae-eyeshadow/reviews?store=colourpop.com" \
-H "x-api-key: YOUR_API_KEY"Responses
A page of Shopify product reviews.