Reviews
Shopify reviews — accepted parameters and what comes back.
GET|POST /v1/shopify/reviewsPrice $0.001 per call, plus $0.001 for each extra call it makes — at most 6 more, so $0.007 in total. A first page normally costs one unit more than the base. A cursor page costs only the base. List price; the rate steps down above 1,000 calls a day.
| Parameter | Type | Required | Notes |
|---|---|---|---|
id | string | yes | The composite Shopify shop/handle — the same id product takes, not a global identifier. This is the one Shopify operation whose cost varies: a first page can cost more than 1, while a page fetched with cursor costs 1. |
cursor | string | Opaque cursor from the previous response; the only paging knob that works on every shop, and it wins if page is sent too. A page fetched with a cursor costs 1. | |
page | integer | 1-based starting page. Not every shop supports jumping to a page number; cursor works on every shop, so prefer it for paging. |
A reviews call can cost more than one unit; the range is shown above. Shops differ in how their reviews are served, and that shows in a few ways:
- Use
cursor.pageis not supported on every shop;cursoralways works. - No reviews is an answer, and it says zero. A product with no reviews returns
200withreviews: []andpage.total: 0. This is common on Shopify — most products have none — and the zero is only sent when that is really the case. - Star ratings without text count as zero reviews. Some shops hold star-only ratings separately
from written reviews. A product with three star ratings and no text answers
total: 0— there is no review to return — even though its page may show stars. - A 501 means the reviews exist but are not available.
REVIEW_APP_UNSUPPORTED— this shop's reviews are not available.REVIEWS_UNREACHABLE— a review count or an average is reported, or the page shows reviews, but none came back. Both are deliberately not a zero and not a 404: the reviews exist.
Reviews are frequently grouped: a merchant can answer one colour's page with the whole family's rows.
Check grouped on the response before computing a per-product rating.