Reviews
Recent reviews across the whole store with the overall rating — for a homepage testimonials section.
Authorization
clientKey The connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.
In: header
Query Parameters
Which reviews to show: vendor (default) the whole store, product one product (send product_slug), or ids hand-picked reviews (send ids).
Value in
- "vendor"
- "product"
- "ids"
- null
With scope=product: the slug of the product whose reviews to show. An unknown slug returns no reviews.
length <= 255With scope=ids: the ids of the reviews to show (UUIDs, at most 24).
uuidOnly reviews with at least this star rating, 1 to 5.
Value in
- "1"
- "2"
- "3"
- "4"
- "5"
- null
Only reviews from verified purchases. Defaults to true; send false to include the rest.
When true, only reviews that include photos or video.
When true, only reviews the store has featured.
Number of reviews to return, 1 to 24 (default 6).
1 <= value <= 24Order of the reviews: newest (default), highest rated first, or featured (highest rated, verified purchases first).
Value in
- "newest"
- "highest"
- "featured"
- null
Header Parameters
Your connection's key (Dashboard → Channels → Headless API; keys are also listed in Settings → Connections). pk_… public keys are for browser code and only work from a website listed on the connection (a website connection never accepts *; a development connection on a dev store also allows localhost); sk_… private keys are for servers and native apps and need no Origin.
Your own correlation id (8–128 chars, ^[A-Za-z0-9_.:-]+$). Echoed back on the response and on every log line of the request; one is generated when you omit it.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/store/reviews?scope=vendor&min_rating=4&limit=6&sort=newest" \ -H "X-Client-Key: {{clientKey}}"{ "status": "success", "message": "Storefront reviews block retrieved", "data": { "scope": "vendor", "vendor_id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c01", "summary": { "average_rating": 4.5, "total_reviews": 132, "rating_breakdown": { "1": 3, "2": 4, "3": 9, "4": 27, "5": 89 } }, "reviews": [ { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c55", "rating": 5, "title": "Perfect fit, rich fabric", "description": "The M fits exactly like the size guide says and the cotton is thick, not the thin stuff you find elsewhere. Wore it to a wedding.", "media": [], "vendor_response": "Thank you Alex — you wore it so well! Send us pictures next time.", "vendor_response_at": "2026-09-21T09:05:00.000000Z", "is_verified_purchase": true, "is_featured": false, "created_at": "2026-09-20T17:44:00.000000Z", "edited_at": null, "submitted_at": null, "source": null, "author_display_name": null, "user": { "name": "Alex Morgan", "avatar": "https://media.usequeek.com/uploads/avatars/alex-morgan.jpg" }, "product": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c11", "slug": "cotton-midi-dress", "title": "Cotton Midi Dress", "thumbnail": "https://media.usequeek.com/uploads/stores/2207/cotton-midi-dress.jpg" } }, { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c56", "rating": 4, "title": "Lovely, delivery took a while", "description": "Dress is beautiful and well finished. Took four days to reach Chicago, so order early.", "media": [], "vendor_response": null, "vendor_response_at": null, "is_verified_purchase": true, "is_featured": false, "created_at": "2026-09-22T10:20:00.000000Z", "edited_at": null, "submitted_at": null, "source": null, "author_display_name": null, "user": { "name": "Priya Shah", "avatar": "https://media.usequeek.com/uploads/avatars/priya-shah.jpg" }, "product": { "id": "019b0c4d-5e6f-7a8b-9c0d-1e2f3a4b5c11", "slug": "cotton-midi-dress", "title": "Cotton Midi Dress", "thumbnail": "https://media.usequeek.com/uploads/stores/2207/cotton-midi-dress.jpg" } } ] }, "has_more": false, "next_cursor": null}