Skip to main content
GET
List product reviews
Call this endpoint from the configured storefront origin when the shopper wants the underlying reviews. Each item can include its stars, full text, purchased options, customer photos or videos, reported measurements, and extracted fit signals. Results are limited to 50 reviews per page. Pass the returned next_cursor unchanged to load the next page. Optional variant_id and size filters help surface evidence that matches the shopper’s current selection.

Path Parameters

site_key
string
required

Public Custom JavaScript site key.

Maximum string length: 255

Query Parameters

product_id
string
required

Stable merchant product ID used during catalog sync.

Maximum string length: 255
variant_id
string

Optional stable merchant variant ID.

Maximum string length: 255
size
string

Optional exact source size label or size signature.

Maximum string length: 255
cursor
string

Opaque next_cursor value from the previous response.

Maximum string length: 2048
limit
integer
default:20

Reviews per page.

Required range: 1 <= x <= 50

Response

Paginated reviews for the product.

items
object[]
required
Maximum array length: 50
next_cursor
string

Opaque cursor for the next page. Omitted on the last page.