# Shopee Product Reviews Scraper: Full History & Filters (`zen-studio/shopee-product-reviews-scraper`) Actor

Scrape full Shopee product reviews by URL: complete review history with text, star and per-aspect sub-ratings, buyer photos and videos, the variant purchased, and seller replies. Filter by star or by media/comments. Works across all 8 Shopee markets.

- **URL**: https://apify.com/zen-studio/shopee-product-reviews-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.99 / 1,000 customer reviews

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Shopee Product Reviews Scraper | Full Review History, Star Filters & Buyer Photos by URL (2026)

<blockquote style="border-left:4px solid #4C945E;background:#F0FDF4;padding:12px 16px">
<span style="font-size:16px;font-weight:700;color:#1C1917">27 fields per review: the only Shopee scraper on Apify with full review history and star filtering.</span> <span style="font-size:15px;color:#57534E">One row per review: text, per-aspect sub-ratings, buyer photos and videos, the variant purchased, and seller replies. Up to 14,000 reviews per product across all 8 Shopee markets.</span>
</blockquote>

![Shopee product reviews: star ratings, sub-ratings, photos, purchased variant, seller replies](https://iili.io/Cu6kU8v.png)

<table>
<tr>
<td colspan="4" style="padding:10px 14px;background:#4C945E;border:none;border-radius:4px 4px 0 0">
<span style="color:#FAFAF9;font-size:14px;font-weight:700;letter-spacing:0.5px">Zen Studio · Marketplace Scrapers</span>
<span style="color:#E8F5E9;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Product data across Asia's top marketplaces</span>
</td>
</tr>
<tr>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 0 4px;border-right:none;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-LwARSYSMWLBZfXfdr-FrDaNbQarB-shopee-scraper-logo.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/shopee-product-reviews-scraper" style="color:#4C945E;text-decoration:none;font-weight:700;font-size:14px">Shopee Reviews</a><br>
<span style="color:#4C945E;font-size:12px;font-weight:600">&#10148; You are here</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-LwARSYSMWLBZfXfdr-FrDaNbQarB-shopee-scraper-logo.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/shopee-product-detail-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Shopee Detail</a><br>
<span style="color:#78716C;font-size:12px">72 fields: price, stock, variants</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/1688-wholesale-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">1688 Wholesale</a><br>
<span style="color:#78716C;font-size:12px">B2B wholesale supplier data</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 4px 0;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="24" height="24" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/taobao-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Taobao Search</a><br>
<span style="color:#78716C;font-size:12px">Search Taobao products</span>
</td>
</tr>
</table>

#### Copy to your AI assistant

````

zen-studio/shopee-product-reviews-scraper on Apify. Scrapes full Shopee product reviews by URL: complete review history with text, star and per-aspect sub-ratings, buyer photos and videos, the variant purchased, and seller replies. Filter by star rating (1-5) or by content type (with comments, with media, local). One row per review, 27 fields: reviewId, itemId, shopId, ratingStar, comment, createdAt, editedAt, author, authorId, authorPortrait, authorLoyaltyTier, isAnonymous, isRepeatPurchase, likeCount, status, region, detailedRating (productQuality/sellerService/deliveryService/driverService), variations (variant bought), images, videos, shopReply, followUp, templateTags, overallFit, sizeInfoTags, authorMeasurements, scrapedAt. Market is auto-detected from each URL; mix markets freely. Call ApifyClient("TOKEN").actor("zen-studio/shopee-product-reviews-scraper").call(run\_input={...}), then client.dataset(run\["defaultDatasetId"]).list\_items().items. Required: startUrls (Shopee product page URLs containing -i.<shop>.<item>). Optional: starFilter (all/1-5), contentFilter (all/with comments/with media/local), maxReviewsPerProduct (default 1000, 0=full history up to ~14000). PPE: $3.99 per 1000 reviews (FREE plan); paid Apify plans pay less (BRONZE $3.79, SILVER $3.29, GOLD+ $2.99). Free tier: 500 reviews lifetime. Token: https://console.apify.com/account/integrations

````

### Key Features

- **27 fields per review**: star rating, per-aspect sub-ratings (product quality, seller service, delivery), review text, buyer photos and videos, the exact variant purchased, seller reply, follow-up review, apparel fit data and reviewer measurements, author loyalty tier, and like count.
- **Full review history**: collect the complete available review history per product, up to approximately 14,000 reviews on high-volume listings, not just the most recent sample.
- **Star and content filtering**: narrow to any single star rating (1 through 5) or to reviews with a written comment, with photos or video, or local ratings only.
- **All 8 Shopee markets**: Singapore (SGD), Indonesia (IDR), Malaysia (MYR), Philippines (PHP), Thailand (THB), Taiwan (TWD), Vietnam (VND), and Brazil (BRL). Market is auto-detected from each URL; mix markets in one run.
- **Free tier**: 500 lifetime reviews free, no credit card required.

### How to Scrape Shopee Product Reviews

#### Basic: all reviews for one product

```json
{
    "startUrls": [
        { "url": "https://shopee.sg/product-i.131198971.6646421738" }
    ]
}
````

#### Filter to 5-star reviews only

```json
{
    "startUrls": [
        { "url": "https://shopee.sg/product-i.131198971.6646421738" }
    ],
    "starFilter": "5"
}
```

#### Reviews with photos or video, up to 500 per product

```json
{
    "startUrls": [
        { "url": "https://shopee.com.my/product-i.131198971.6646421738" },
        { "url": "https://shopee.co.id/product-i.445275287.25305315701" }
    ],
    "contentFilter": "with media",
    "maxReviewsPerProduct": 500
}
```

#### Full review history (0 = no limit)

```json
{
    "startUrls": [
        { "url": "https://shopee.sg/product-i.131198971.6646421738" }
    ],
    "maxReviewsPerProduct": 0
}
```

Set `maxReviewsPerProduct` to `0` to collect every available review. On popular products this can reach tens of thousands; reviews are returned most-recent first.

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `startUrls` | array | *required* | Shopee product page URLs containing `-i.<shop>.<item>`. One product per URL. The market and currency are auto-detected from each URL's hostname, so you can mix markets in one run. |
| `starFilter` | string | `"all"` | Collect only reviews with this star rating: `"all"`, `"5"`, `"4"`, `"3"`, `"2"`, or `"1"`. |
| `contentFilter` | string | `"all"` | Collect only reviews matching a content type: `"all"`, `"with comments"`, `"with media"`, or `"local"`. |
| `maxReviewsPerProduct` | integer | `1000` | How many reviews to collect per product. Set to `0` for the full available history (up to approximately 14,000 on large products). Reviews are returned most-recent first. |

`starFilter` and `contentFilter` can be combined: for example, `starFilter: "1"` with `contentFilter: "with comments"` returns only 1-star reviews that include written text.

### What Data Can You Extract from Shopee Reviews?

Every row includes:

**Rating:** overall star (1-5) and per-aspect sub-ratings for product quality, seller service, delivery service, and driver service.

**Review content:** written comment, template tags (e.g. "Product Quality", "Packaging"), buyer photos (full CDN URLs), and buyer videos (playable URL, cover thumbnail, duration).

**Purchase context:** the exact variant bought (name, options, model ID, variant image), and whether this was a repeat purchase.

**Seller response:** the seller's reply text and timestamp, and any follow-up review the buyer added later (with its own comment, photos, videos, and days-after-purchase marker).

**Apparel fit:** overall fit rating, size tags, and the reviewer's self-reported measurements (height, weight, etc.) when provided.

**Author:** display name, user ID, avatar URL, loyalty tier (e.g. "Member Gold"), region, and anonymous flag.

**Metadata:** review ID, item ID and shop ID (join keys back to the product), like count, status, created and edited timestamps, and scrape timestamp.

#### Output Example

```json
{
  "reviewId": 41823956710,
  "itemId": 6646421738,
  "shopId": 131198971,
  "ratingStar": 4,
  "comment": "Sound quality is great and fits comfortably. Battery life could be slightly better but overall very happy with the purchase. 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": 4,
    "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",
    "https://down-sg.img.susercontent.com/file/sg-11134103-7s5qa-mq8bn0yztpft2a",
    // ... 2 more photos
  ],
  "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're glad the sound quality met your expectations. See you again soon.",
    "createdAt": "2026-05-15T02:18:00+00:00"
  },
  "followUp": null,
  "templateTags": ["Product Quality", "Packaging", "Value for Money"],
  "overallFit": 0,
  "sizeInfoTags": [],
  "authorMeasurements": [],
  "scrapedAt": "2026-06-25T09:14:22.318740+00:00"
}
```

### Advanced Usage

Ready-made configurations for voice-of-customer research, negative sentiment mining, media collection, and cross-market review comparison.

#### Voice of customer: written reviews only

```json
{
    "startUrls": [
        { "url": "https://shopee.sg/product-i.131198971.6646421738" }
    ],
    "contentFilter": "with comments",
    "maxReviewsPerProduct": 1000
}
```

#### Negative review mining: 1-star with written comments

```json
{
    "startUrls": [
        { "url": "https://shopee.co.id/product-i.131198971.6646421738" }
    ],
    "starFilter": "1",
    "contentFilter": "with comments",
    "maxReviewsPerProduct": 500
}
```

#### Media collection: buyer photos and videos only

```json
{
    "startUrls": [
        { "url": "https://shopee.com.my/product-i.445275287.25305315701" },
        { "url": "https://shopee.com.my/product-i.131198971.6646421738" }
    ],
    "contentFilter": "with media",
    "maxReviewsPerProduct": 1000
}
```

#### Full history across multiple products

```json
{
    "startUrls": [
        { "url": "https://shopee.sg/product-i.131198971.6646421738" },
        { "url": "https://shopee.co.th/product-i.167068287.21641277130" }
    ],
    "maxReviewsPerProduct": 0
}
```

### Pricing: Pay Per Event (PPE)

**$3.99 per 1,000 reviews** on the FREE Apify plan. Paid Apify plans receive a lower per-review rate.

<table>
<thead>
<tr>
<th style="text-align:left;padding:8px 12px;background:#F0FDF4;border:1px solid #E7E5E4">Reviews collected</th>
<th style="text-align:left;padding:8px 12px;background:#F0FDF4;border:1px solid #E7E5E4">Cost (FREE plan)</th>
</tr>
</thead>
<tbody>
<tr>
<td style="padding:8px 12px;border:1px solid #E7E5E4">100</td>
<td style="padding:8px 12px;border:1px solid #E7E5E4"><span style="color:#4C945E;font-weight:700">$0.40</span></td>
</tr>
<tr>
<td style="padding:8px 12px;border:1px solid #E7E5E4">1,000</td>
<td style="padding:8px 12px;border:1px solid #E7E5E4"><span style="color:#E67E22;font-weight:700">$3.99</span></td>
</tr>
</tbody>
</table>

Paid Apify plans pay less per review: BRONZE $3.79, SILVER $3.29, GOLD and above $2.99 per 1,000 reviews. There is no per-product fee; you are billed only for the reviews actually delivered.

**Free tier:** 500 reviews lifetime, no credit card required.

### FAQ

**What is Shopee?**
Shopee is the largest e-commerce marketplace in Southeast Asia, also operating in Taiwan and Brazil. It spans Singapore, Indonesia, Malaysia, the Philippines, Thailand, Taiwan, Vietnam, and Brazil, with millions of listings across electronics, fashion, home goods, and groceries. This actor collects buyer reviews from any publicly visible Shopee product page, one row per review.

**How is this actor different from the Shopee Product Detail Scraper?**
The [Shopee Product Detail Scraper](https://apify.com/zen-studio/shopee-product-detail-scraper) delivers the full product record (price, stock, variants, specifications) plus an optional bounded sample of up to 1,000 recent reviews alongside it.

This actor is a dedicated reviews collector: it delivers the complete available review history (up to approximately 14,000 reviews on large products via per-star depth splitting), supports filtering by star rating and content type, and writes one row per review with no product fields mixed in.

Use the detail actor when you need the product record. Use this actor when you need the full review dataset.

**How many reviews can I collect per product?**
The default is 1,000. Set `maxReviewsPerProduct` to `0` to collect everything available. Popular products with 26,000+ total reviews typically yield up to approximately 14,000 via full-history mode. Reviews are returned most-recent first.

**How do star and content filters work together?**
Each filter narrows the set independently. `starFilter: "1"` with `contentFilter: "with comments"` returns only 1-star reviews that also contain written text. Combine freely.

**How do I get a Shopee product URL?**
Open the product on Shopee and copy the page URL from your browser. It contains the pattern `-i.<shopId>.<itemId>` (for example `https://shopee.sg/product-i.131198971.6646421738`). Paste one or more into `startUrls`. The market is detected automatically, so you can mix markets in one run.

**How fresh is the data?**
Every run collects live data at the moment you start it.

**Do I need a Shopee account or cookies?**
No. Provide product URLs and hit Start; no Shopee account, cookie export, or login is involved.

**How do I export the data?**
Open the run's Storage tab and download JSON, CSV, Excel, or XML, or use the Apify API. JSON preserves all nested fields (variant arrays, sub-ratings, measurement objects, photo arrays). Each row is one review.

**Can I join reviews back to product data?**
Yes. Every review row carries `itemId` and `shopId` as join keys. These match the `itemId` and `shopId` fields in the [Shopee Product Detail Scraper](https://apify.com/zen-studio/shopee-product-detail-scraper) output.

**Is it legal to scrape Shopee reviews?**
This actor collects publicly visible review data. Users are responsible for complying with Shopee's Terms of Service and applicable data protection regulations, including GDPR, CCPA, PDPA laws across Southeast Asia, and LGPD (Brazil). Reviews contain personal data such as reviewer usernames, avatars, body measurements, and purchase history; handle them accordingly.

**What is the free tier?**
500 reviews lifetime at no cost. No credit card required.

### More Zen Studio scrapers

**🛒 E-commerce**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-LwARSYSMWLBZfXfdr-FrDaNbQarB-shopee-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Shopee**
  - [Shopee Product Detail Scraper](https://apify.com/zen-studio/shopee-product-detail-scraper)
  - [Shopee Product Scraper](https://apify.com/zen-studio/shopee-product-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Taobao 淘宝**
  - [Taobao Search Scraper](https://apify.com/zen-studio/taobao-search-scraper)
  - [Taobao Product Detail Scraper](https://apify.com/zen-studio/taobao-detail-scraper)
  - [Taobao Seller Products Scraper](https://apify.com/zen-studio/taobao-seller-products-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **JD.com 京东**
  - [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **1688 阿里巴巴**
  - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper)
  - [Alibaba Scraper](https://apify.com/zen-studio/alibaba-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-5QcLc4BHaLMBUKYs3-f3CWQ60Row-goofish-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Goofish 闲鱼**
  - [Goofish (Xianyu) Search Scraper](https://apify.com/zen-studio/goofish-xianyu-search-scraper)
  - [Goofish (Xianyu) Seller Scraper](https://apify.com/zen-studio/goofish-xianyu-seller-scraper)
  - [Goofish (Xianyu) Item Detail Scraper](https://apify.com/zen-studio/goofish-xianyu-item-detail-scraper)
  - [Goofish (Xianyu) Item Comments & Q\&A Scraper](https://apify.com/zen-studio/goofish-xianyu-item-comments-scraper)

**🎬 Short-video & social**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Douyin 抖音**
  - [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper)
  - [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper)
  - [Douyin Video Scraper](https://apify.com/zen-studio/douyin-video-scraper)
  - [Douyin Comments Scraper](https://apify.com/zen-studio/douyin-comments-scraper)
  - [Douyin Transcripts Scraper](https://apify.com/zen-studio/douyin-transcripts-scraper)
  - [Douyin Creator Rankings Scraper](https://apify.com/zen-studio/douyin-xingtu-rankings-scraper)
  - [Douyin Live Recorder](https://apify.com/zen-studio/douyin-live-recorder)
  - [Douyin Hot Search Scraper](https://apify.com/zen-studio/douyin-hot-search-scraper)
  - [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-mHKEEgoDqr6btQQer-fUs5ZquIeN-xiaohongshu-search-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **RedNote 小红书**
  - [RedNote User Profile Scraper](https://apify.com/zen-studio/rednote-user-profile-scraper)
  - [RedNote Search Scraper](https://apify.com/zen-studio/rednote-search-scraper)
  - [RedNote Comments Scraper](https://apify.com/zen-studio/rednote-comments-scraper)
  - [RedNote Product Search Scraper](https://apify.com/zen-studio/rednote-product-search-scraper)
  - [RedNote Note Detail Scraper](https://apify.com/zen-studio/rednote-note-detail-scraper)
  - [RedNote Product Reviews Scraper](https://apify.com/zen-studio/rednote-product-reviews-scraper)
  - [RedNote Live Recorder](https://apify.com/zen-studio/rednote-live-recorder)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-dexCSKEZtKS8hg4fT-lD4weyiYga-shigua-____-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Xigua 西瓜视频**
  - [Xigua Video Search Scraper](https://apify.com/zen-studio/xigua-video-search-scraper)
  - [Xigua Video Detail Scraper](https://apify.com/zen-studio/xigua-video-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-oSxuPDE1h3HAsHZSu-x3uV98mgTe-bilibili-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Bilibili 哔哩哔哩**
  - [Bilibili Video Scraper](https://apify.com/zen-studio/bilibili-video-scraper)
  - [Bilibili Danmaku Scraper](https://apify.com/zen-studio/bilibili-danmaku-scraper)

**🏠 Real estate & autos**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-1tAzNSf8Kz0v7Q2Lr-AINJ7FsZVU-anjuke-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Anjuke 安居客**
  - [Anjuke For-Sale Listings Scraper](https://apify.com/zen-studio/anjuke-real-estate-scraper)
  - [Anjuke New-Home Scraper](https://apify.com/zen-studio/anjuke-new-home-scraper)
  - [Anjuke Rental Listings Scraper](https://apify.com/zen-studio/anjuke-rent-scraper)
  - [Anjuke Listing Detail Scraper](https://apify.com/zen-studio/anjuke-sale-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-32OkWqsiUywoq2ci3-7JhFlW1qg3-58__-real-estate-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **58.com 58同城**
  - [58.com Real Estate Scraper](https://apify.com/zen-studio/58-real-estate-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ytaE4YpSmjXDmibPv-L1UMPHa2bO-che168-autohome-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Autohome 汽车之家**
  - [Autohome (Che168) Used-Car Scraper](https://apify.com/zen-studio/che168-car-scraper)

### Support

- **Bugs**: Issues tab
- **Features**: Issues tab

### Legal Compliance

Extracts publicly available review data. Users must comply with Shopee's Terms of Service and applicable data protection regulations (PDPA across Southeast Asia, GDPR, CCPA, and LGPD for Brazil). Reviews contain personal data including reviewer usernames, avatars, body measurements, and purchase history.

***

*Full Shopee product review history by URL: star ratings, review text, buyer photos and videos, variant purchased, and seller replies across all 8 Shopee markets.*

# Actor input Schema

## `startUrls` (type: `array`):

Paste Shopee <b>product page</b> URLs (the links that contain <code>-i.\<shop>.\<item></code>). One product per URL. The market is detected automatically from each URL, so you can mix markets in a single run.<br><br>Example: <code>https://shopee.sg/product-i.131198971.6646421738</code>

## `maxReviewsPerProduct` (type: `integer`):

How many reviews to collect per product. Leave at <b>0</b> to collect the full available history (can be many thousands on popular products). The most recent reviews are returned first.

## `starFilter` (type: `string`):

Collect only reviews with this star rating, or all.

## `contentFilter` (type: `string`):

Collect only reviews matching this content type, or all.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://shopee.sg/product-i.131198971.6646421738"
    }
  ],
  "maxReviewsPerProduct": 20,
  "starFilter": "all",
  "contentFilter": "all"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://shopee.sg/product-i.131198971.6646421738"
        }
    ],
    "maxReviewsPerProduct": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/shopee-product-reviews-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://shopee.sg/product-i.131198971.6646421738" }],
    "maxReviewsPerProduct": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/shopee-product-reviews-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://shopee.sg/product-i.131198971.6646421738"
    }
  ],
  "maxReviewsPerProduct": 20
}' |
apify call zen-studio/shopee-product-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zen-studio/shopee-product-reviews-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Shopee Product Reviews Scraper: Full History & Filters",
        "description": "Scrape full Shopee product reviews by URL: complete review history with text, star and per-aspect sub-ratings, buyer photos and videos, the variant purchased, and seller replies. Filter by star or by media/comments. Works across all 8 Shopee markets.",
        "version": "0.0",
        "x-build-id": "H51dxTa2nNojnXbr5"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/zen-studio~shopee-product-reviews-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-zen-studio-shopee-product-reviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/zen-studio~shopee-product-reviews-scraper/runs": {
            "post": {
                "operationId": "runs-sync-zen-studio-shopee-product-reviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/zen-studio~shopee-product-reviews-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-zen-studio-shopee-product-reviews-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "startUrls": {
                        "title": "Shopee product URLs",
                        "type": "array",
                        "description": "Paste Shopee <b>product page</b> URLs (the links that contain <code>-i.&lt;shop&gt;.&lt;item&gt;</code>). One product per URL. The market is detected automatically from each URL, so you can mix markets in a single run.<br><br>Example: <code>https://shopee.sg/product-i.131198971.6646421738</code>",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "maxReviewsPerProduct": {
                        "title": "Max reviews per product",
                        "minimum": 0,
                        "type": "integer",
                        "description": "How many reviews to collect per product. Leave at <b>0</b> to collect the full available history (can be many thousands on popular products). The most recent reviews are returned first.",
                        "default": 1000
                    },
                    "starFilter": {
                        "title": "Star rating",
                        "enum": [
                            "all",
                            "5",
                            "4",
                            "3",
                            "2",
                            "1"
                        ],
                        "type": "string",
                        "description": "Collect only reviews with this star rating, or all.",
                        "default": "all"
                    },
                    "contentFilter": {
                        "title": "Content",
                        "enum": [
                            "all",
                            "with comments",
                            "with media",
                            "local"
                        ],
                        "type": "string",
                        "description": "Collect only reviews matching this content type, or all.",
                        "default": "all"
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```