Skip to main content
GET
/
shopee
/
product
/
reviews
Shopee Product Reviews
curl --request GET \
  --url https://api.example.com/shopee/product/reviews

​
Overview

The /shopee/product/reviews endpoint retrieves product reviews from Shopee Indonesia (shopee.co.id) including reviewer information, ratings, comments, images, and seller replies.
Currently only Indonesia (country=id) is supported. More Southeast Asian markets will be added in future updates.

​
Credits

25 credits per successful request.

​
Parameters

​
Query Parameters

​
slug
string
Product slug containing the shop and item IDs (e.g., Product-Name-i.SHOPID.ITEMID).If provided, itemId and shopId are extracted automatically.
​
itemId
string
The Shopee product item ID (e.g., “22133637031”). Required if slug is not provided.
​
shopId
string
The Shopee shop/seller ID (e.g., “12651109”). Required if slug is not provided.
​
country
string
required
Country code. Currently only id (Indonesia) is supported.
​
limit
number
default:"20"
Number of reviews to return (max 50).
​
offset
number
default:"0"
Offset for pagination. Use this to fetch additional reviews.
​
rating
number
Filter by star rating (1-5). Leave empty or 0 to get all ratings.
​
filter
number
default:"0"
Filter type:
  • 0 = All reviews
  • 1 = Reviews with comments only
  • 2 = Reviews with media (images/videos) only
Either slug OR both itemId and shopId must be provided.

​
Example Requests

curl -X GET "https://api.scrapengine.io/api/v1/shopee/product/reviews?slug=Gantungan-Handphone-Kristal-Ungu-i.12651109.22133637031&country=id&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Get Reviews by IDs with Filters

curl -X GET "https://api.scrapengine.io/api/v1/shopee/product/reviews?shopId=12651109&itemId=22133637031&country=id&rating=5&filter=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Paginated Reviews

# First page
curl -X GET "https://api.scrapengine.io/api/v1/shopee/product/reviews?shopId=12651109&itemId=22133637031&country=id&limit=20&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Second page
curl -X GET "https://api.scrapengine.io/api/v1/shopee/product/reviews?shopId=12651109&itemId=22133637031&country=id&limit=20&offset=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
Success Response (200)

Returns product reviews with metadata: 
{
  "itemId": "22133637031",
  "shopId": "12651109",
  "reviews": [
    {
      "id": "1234567890",
      "author": {
        "userId": "98765432",
        "username": "buyer_123",
        "avatar": "https://down-id.img.susercontent.com/file/avatar.jpg"
      },
      "rating": 5,
      "comment": "Produk bagus, sesuai deskripsi. Pengiriman cepat!",
      "createdAt": 1706400000,
      "createdAtDisplay": "28 Januari 2024",
      "images": [
        "https://down-id.img.susercontent.com/file/review-image-1.jpg",
        "https://down-id.img.susercontent.com/file/review-image-2.jpg"
      ],
      "videos": [],
      "likeCount": 5,
      "productVariant": "Type-C",
      "isAnonymous": false,
      "sellerReply": "Terima kasih sudah berbelanja!"
    }
  ],
  "totalReviews": 116,
  "ratingAverage": 4.78,
  "ratingBreakdown": {
    "oneStar": 2,
    "twoStar": 0,
    "threeStar": 4,
    "fourStar": 9,
    "fiveStar": 101
  },
  "hasMore": true,
  "offset": 0,
  "limit": 20,
  "country": "id"
}

​
Response Headers

HeaderDescription
x-remaining-creditsNumber of API credits remaining
x-trace-idUnique identifier for the request

​
Error Responses

StatusDescription
400Bad Request - Missing slug or itemId/shopId, or unsupported country
401Unauthorized - Invalid or missing API key
404Not Found - Product not found
429Too Many Requests - Rate limit exceeded
500Internal Server Error

​
Use Cases

  • Sentiment analysis: Analyze customer feedback and satisfaction
  • Product quality monitoring: Track reviews to identify quality issues
  • Competitive analysis: Compare review quality across similar products
  • Review aggregation: Collect and display reviews in your own system
  • Customer insights: Understand what buyers like or dislike about products

​
Notes

  • This endpoint uses renderless scraping (direct API call), making it very fast
  • Reviews are returned in chronological order (newest first by default)
  • Anonymous reviews will have limited author information
  • The hasMore field indicates if pagination should continue
  • Seller replies are included when available