ShopEazydevelopers
API referenceMerchant API BetaReviews

Shopper reviews, newest first

Beta
Credentials
  • OAuth access token
Scopes
marketing:write
GET
/v1/merchant/stores/{storeId}/reviews

Access: OAuth scope marketing:write; not write-gated.

Paged: { items, nextCursor }, limit (default 30, at most 100) and an opaque cursor. It pages through the newest 100.

Authorization

merchantOAuth marketing:write
headerAuthorizationBearer <token>

OAuth 2.1 (authorization code + PKCE S256, public clients, dynamic registration) for connected AI apps. Effective power is scopes granted AND the person's role today AND the plan. orders:refund, billing:write and team:write are opt-in on the consent screen. Write implies read for marketing:read and messages:read, so a grant holding marketing:write passes a marketing:read check, and messages:send passes messages:read.

Scope: marketing:write

Path Parameters

storeId*string

A store the person can reach. Any other id answers 404, never 403.

Query Parameters

itemId?string

Only reviews of this listing.

status?string
Value in"published""hidden"
cursor?string

The nextCursor of the previous page, unchanged. A cursor that is not one we gave you is 400 bad_request.

limit?integer

Page size: default 30, at most 100 (more is 100; a missing or unusable value is 30).

Range1 <= value <= 100
Default30

Response Body

OK

application/json
  1. response
data*
Example Request
curl -X GET 'https://api.shopeazy.co/v1/merchant/stores/<storeId>/reviews' \  -H 'Authorization: Bearer <access_token>'
Example Response
{  "data": {    "items": [],    "nextCursor": null  }}