Get Reviews

Product reviews and rating summary, with star and media filters.

Path Parameters

shop_id · integer · required

The Shopee shop ID of the product.

item_id · integer · required

The Shopee item ID to fetch reviews for.

Query Parameters

market · string · default: "sg"

Shopee storefront code where the product is listed.

Examples: sg, my, th

limit · integer · default: 20

Number of reviews to return per page.

offset · integer · default: 0

Number of reviews to skip (offset-based pagination).

rating · integer · default: 0

Star-rating filter.

Value	Description
0	All ratings (default)
1 - 5	Only reviews with that exact star rating

filter · integer · default: 0

Content-type filter.

Value	Description
0	All reviews (default)
1	Only reviews with a comment
2	Only reviews with media (photo/video)
3	Only local-market reviews

Response

shop_id · integer

The shop the reviews belong to.

item_id · integer

The item the reviews belong to.

market · string

Storefront code.

summary · object

Aggregate rating summary.

Show Summary object

rating_total · integer

Total number of reviews.

rating_star · number

Average star rating.

count_by_star · object

Review count per star (5 … 1).

with_media_count · integer

Number of reviews containing photos/videos.

reviews · array

Array of reviews.

Show Review object

comment_id · integer

Review ID.

rating_star · integer

Star rating left by the reviewer (1-5).

comment · string

Review text.

author_username · string

Reviewer username.

author_portrait · string

Reviewer avatar CDN URL.

images · array

Review photo CDN URLs.

videos · array

Review video URLs.

like_count · integer

Number of likes on the review.

reply · object

Seller’s reply to the review (nullable).

ctime_utc · integer

Review time (Unix).

created_at · string

Review time (ISO 8601 UTC).

pagination · object

Pagination metadata with limit, offset, total.

Example Response

{
  "shop_id": 345678,
  "item_id": 23456789012,
  "market": "sg",
  "summary": {
    "rating_total": 9450,
    "rating_star": 4.8,
    "count_by_star": { "5": 8100, "4": 900, "3": 250, "2": 120, "1": 80 },
    "with_media_count": 3120
  },
  "reviews": [
    {
      "comment_id": 778899001,
      "rating_star": 5,
      "comment": "Great sound and battery life. Fast shipping!",
      "author_username": "shopper_sg",
      "author_portrait": "https://cf.shopee.sg/file/avatar123",
      "images": ["https://cf.shopee.sg/file/review1"],
      "videos": [],
      "like_count": 18,
      "reply": { "comment": "Thank you for your support!", "ctime_utc": 1717050000 },
      "ctime_utc": 1717046400,
      "created_at": "2026-05-30T04:00:00Z"
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "total": 9450 }
}

Each reviews request costs 5 credits. Failed requests are not charged.