Get Reviews

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.

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.

Overview

Search

Products

Categories

Reference

Path Parameters

Query Parameters

Response

Example Response

​Path Parameters

​Query Parameters

​Response

​Example Response

Path Parameters

Query Parameters

Response

Example Response