Shopee Product Reviews Scraper: Full History & Filters

A high-performance, HTTP-only Apify Actor for scraping complete Shopee product reviews, sub-ratings, buyer photos and videos, purchased variants, and seller responses across 7 Southeast Asian and Latin American markets.

---

Key Features

• Fast & Lightweight: Pure HTTP requests using TLS impersonation (curl_cffi with chrome124) — zero headless browser or Puppeteer overhead.
• 27 Fields per Review: Star rating, aspect sub-ratings (Product Quality, Seller Service, Delivery, Driver), review text, high-res photos, buyer videos, variant purchased, seller replies, buyer tags, and likes.
• Per-Product Rating Summary: Dedicated aggregated summary row per product (star breakdown [1★, 2★, 3★, 4★, 5★], review counts with media/comments, local vs oversea buyers) delivered to the default dataset and a companion summary dataset.
• Star & Content Filters: Filter by star rating (1 to 5 or all) and content type (with comments, with media, local, or all).
• Resilient Dual-Tier Architecture: First extracts rich product metadata directly from Shopee's Server-Side Rendered (SSR) Micro-Frontend (text/mfe-initial-data), followed by the paginated reviews API stream. If Shopee Server Gateway (SGW) challenges the stream, the Actor outputs the product summary profile without failing or crashing.
• Multi-Market SEA Support: Auto-detects marketplace from URL: Indonesia (shopee.co.id), Singapore (shopee.sg), Malaysia (shopee.com.my), Philippines (shopee.ph), Thailand (shopee.co.th), Vietnam (shopee.vn), and Brazil (shopee.com.br).

---

Input Parameters

Parameter	Type	Default	Description
startUrls	Array	["https://shopee.co.id/product-i.241308147.25992970267"]	Shopee product page URLs containing -i.<shop>.<item> or /product/<shop>/<item>.
maxReviewsPerProduct	Integer	1000	How many reviews to collect per product. Set to 0 to collect all available reviews.
starFilter	String	"all"	Collect only reviews with this star rating: "all", "5", "4", "3", "2", or "1".
contentFilter	String	"all"	Filter by review content: "all", "with comments", "with media", or "local".
includeSummary	Boolean	true	Include a per-product rating summary row.
requestDelayMs	Integer	350	Politeness delay in milliseconds between pagination requests.
proxyConfiguration	Object	{ "useApifyProxy": false }	Apify Residential proxy configuration (recommended for high volume).
shopeeCookies	String	""	Optional raw Cookie header string or session cookies for authenticated requests.
extraHeaders	Object	{}	Optional dictionary of dynamic headers (e.g. af-ac-enc-dat).

---

Sample Output

Review Record (recordType: "review")

{
  "recordType": "review",
  "reviewId": 41823956710,
  "itemId": 6646421738,
  "shopId": 131198971,
  "ratingStar": 5,
  "comment": "Sound quality is great and fits comfortably. Battery life is amazing. Packaging was neat and delivery was fast.",
  "createdAt": "2026-05-14T13:22:08+00:00",
  "editedAt": "2026-05-15T07:04:31+00:00",
  "author": "s*****n",
  "authorId": 2048193746,
  "authorPortrait": "https://down-sg.img.susercontent.com/file/sg-11134233-7s4b1-mprq9a1vxk7e2c",
  "authorLoyaltyTier": "Member Silver",
  "isAnonymous": false,
  "isRepeatPurchase": true,
  "likeCount": 34,
  "status": 2,
  "region": "SG",
  "detailedRating": {
    "productQuality": 5,
    "sellerService": 5,
    "deliveryService": 5,
    "driverService": null
  },
  "variations": [
    {
      "name": "Colors",
      "options": ["White"],
      "modelId": 50598177670,
      "image": "https://down-sg.img.susercontent.com/file/cn-11134207-7ras8-m98i19fzx5zm92"
    }
  ],
  "images": [
    "https://down-sg.img.susercontent.com/file/sg-11134103-7s5qa-mq8bn0yztpft19"
  ],
  "videos": [
    {
      "id": "sg-11110103-7s4b1-mprqoakbz1wf8c",
      "url": "https://down-tx-sg.vod.susercontent.com/api/v4/11110103/mms/sg-11110103-7s4b1-mprqoakbz1wf8c.mp4",
      "coverUrl": "https://down-zl-sg.img.susercontent.com/sg-11110103-7s4b1-mprqoakbz1wf8c_cover",
      "durationMs": 18450
    }
  ],
  "shopReply": {
    "comment": "Thank you for your detailed feedback! We are glad you love the product.",
    "createdAt": "2026-05-15T02:18:00+00:00"
  },
  "followUp": null,
  "templateTags": ["Product Quality", "Packaging"],
  "overallFit": 0,
  "sizeInfoTags": [],
  "authorMeasurements": [],
  "scrapedAt": "2026-09-23T13:10:09+00:00"
}

Product Summary Record (recordType: "summary")

{
  "recordType": "summary",
  "total": 4201,
  "starBreakdown": [18, 4, 8, 54, 4117],
  "withComment": 966,
  "withImage": 603,
  "withMedia": 737,
  "localReviews": 4201,
  "overseaReviews": 0,
  "repeatPurchases": 0,
  "fitBreakdown": { "fit": 0, "large": 0, "small": 0 },
  "fitPercent": { "fit": null, "large": null, "small": null },
  "itemId": 25992970267,
  "shopId": 241308147,
  "region": "ID",
  "title": "Apple iPhone 16",
  "url": "https://shopee.co.id/product-i.241308147.25992970267",
  "ratingStar": 4.95,
  "historicalSold": 1540,
  "scrapedAt": "2026-09-23T13:10:09+00:00"
}

---

Anti-Bot & WAF Considerations

Shopee uses a proprietary Server Gateway (SGW) protection layer that challenges API calls when client-side JavaScript telemetry headers (af-ac-enc-dat, x-sap-sec) are absent or when calling from datacenter IPs:

• Apify Residential Proxies: Set proxyConfiguration: { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } with the target country code.
• Dual-Tier Resilient Fallback: The scraper automatically parses the product page SSR micro-frontend (text/mfe-initial-data) to extract core product details and rating metrics even if the live stream is challenged.