Skip to main content

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.
ValueDescription
0All ratings (default)
1 - 5Only reviews with that exact star rating
filter
integer
default:0
Content-type filter.
ValueDescription
0All reviews (default)
1Only reviews with a comment
2Only reviews with media (photo/video)
3Only 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.
reviews
array
Array of reviews.
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.