# 1688 Reviews Scraper | Product Ratings & Buyer Feedback (`zen-studio/1688-reviews-scraper`) Actor

Extract buyer reviews from 1688.com products. Each review includes star rating, review text, buyer location, purchased specs, order quantity, and buyer credibility stats. Accepts product URLs or IDs, paginates automatically, returns structured JSON.

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

## Pricing

from $2.39 / 1,000 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

## 1688 Product Reviews Scraper | Buyer Feedback, Ratings & Specs (2026)

![1688 Product Reviews Scraper](https://iili.io/C1CVmRs.png)

<blockquote style="border-left:4px solid #4C945E;background:#F0FDF4;padding:10px 16px;margin:14px 0">
<span style="font-size:15px;font-weight:700;color:#1C1917">19 fields per review, up to 500 per product</span><span style="font-size:15px;color:#57534E"> — star ratings, buyer location, purchased specs &amp; credibility stats.</span>
</blockquote>

<table>
<tr>
<td colspan="4" style="padding:8px 14px;background:#FF4700;border:none;border-radius:4px 4px 0 0;line-height:1.25">
<span style="color:#fff;font-size:13px;font-weight:700;letter-spacing:0.3px">1688.com Scraper Suite</span>
<span style="color:#FFD6C2;font-size:12px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;China wholesale and marketplace intelligence</span>
</td>
</tr>
<tr>
<td style="background:#FFF3EB;padding:9px 14px;border:1px solid #E7E5E4;border-radius:0 0 0 4px;border-right:none;border-top:none;vertical-align:top;width:25%;line-height:1.25">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/1688-wholesale-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">1688</a></span><br>
<span style="color:#78716C;font-size:11px">Wholesale, supplier data</span>
</td>
<td style="background:#FFF3EB;padding:9px 14px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:25%;line-height:1.25">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/taobao-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Taobao</a></span><br>
<span style="color:#78716C;font-size:11px">淘宝 + Tmall</span>
</td>
<td style="padding:9px 14px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:25%;line-height:1.25;background:#FFE4D6;">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-qiJM8oaLCfBelBxkP-ad7SxvAETZ-1688-wholesale-scraper-logo.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/1688-reviews-scraper" style="color:#FF4700;text-decoration:none;font-weight:700;font-size:13px">Reviews</a></span><br>
<span style="color:#FF4700;font-size:11px;font-weight:600">&#10148; You are here</span>
</td>
<td style="background:#FFF3EB;padding:9px 14px;border:1px solid #E7E5E4;border-radius:0 0 4px 0;border-top:none;vertical-align:top;width:25%;line-height:1.25">
<span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="20" height="20" style="vertical-align:middle;border-radius:4px"> &nbsp;<a href="https://apify.com/zen-studio/jd-com-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">JD.com</a></span><br>
<span style="color:#78716C;font-size:11px">京东 products</span>
</td>
</tr>
</table>

#### Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start building with this data.

````

1688 Product Reviews Scraper (zen-studio/1688-reviews-scraper) on Apify extracts buyer reviews from 1688.com products. 19 fields per review: offerId, reviewId, productTitle, sellerName, content, rating (1-5), reviewer, reviewerLevel, date, location, specs (purchased variant), quantity, unit, isAnonymous, isSystemDefault, isRepeatCustomer, isPlusUser, buyerRatingCount, buyerGoodRatingCount. Input: productUrls (array of URLs or numeric offer IDs), maxReviewsPerProduct (5-500, default 100). Output: flat JSON, one row per review. Pricing: $2.99 per 1,000 reviews (PPE). Apify token required.

````

### Key Features

- **19 fields per review** including rating, text, buyer location, purchased specs, and repeat-customer flag
- **Up to 500 reviews per product** with automatic pagination
- **Flexible input** accepts full 1688 URLs or just numeric offer IDs

### How to Scrape 1688 Product Reviews

#### Basic: single product

```json
{
    "productUrls": ["https://detail.1688.com/offer/993648470412.html"]
}
````

#### Multiple products by ID

```json
{
    "productUrls": ["993648470412", "990606521619"],
    "maxReviewsPerProduct": 50
}
```

#### Mixed URLs and IDs

```json
{
    "productUrls": [
        "https://detail.1688.com/offer/993648470412.html",
        "990606521619"
    ],
    "maxReviewsPerProduct": 200
}
```

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `productUrls` | array | *required* | 1688 product URLs or numeric offer IDs. Mix formats freely. |
| `maxReviewsPerProduct` | integer | `100` | Max reviews per product. Newest first. Range: 5-500. |

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

Every review includes:

- **Review content** with star rating (1-5) and unique review ID
- **Review photos**: buyer-uploaded images (when present)
- **Buyer details**: reviewer name, level, location, plus-user status
- **Buyer credibility**: total ratings given, good rating count
- **Purchase context**: exact specs ordered (color, size), quantity, unit
- **Flags**: anonymous, system-generated, repeat customer

#### Output Example

```json
[
  {
    "offerId": "927451550060",
    "reviewId": "39503416602",
    "productTitle": "纯亚麻阔腿裤女2025年夏季直筒休闲长裤时尚百搭宽松薄款棉麻",
    "sellerName": "简韵女裤批发",
    "content": "从没想过这么实惠的价格能买到这么好的裤子，给商家五星好评。",
    "rating": 5,
    "reviewer": "t**3",
    "reviewerLevel": "L0",
    "date": "2026-04-03 00:17:58",
    "location": "重庆市",
    "specs": "颜色: 麻本色长裤, 尺码: L【106-120斤】",
    "quantity": 1.0,
    "unit": "条",
    "reviewImages": [
      "https://img.alicdn.com/imgextra/i3/O1CN010s9w5M1WbCSe7zwtE_!!4611686018428148624-0-cib.jpg"
    ],
    "isAnonymous": false,
    "isSystemDefault": false,
    "isRepeatCustomer": false,
    "isPlusUser": false,
    "buyerRatingCount": 3,
    "buyerGoodRatingCount": 3
  },
  {
    "offerId": "927451550060",
    "reviewId": "39472915041",
    "productTitle": "纯亚麻阔腿裤女2025年夏季直筒休闲长裤时尚百搭宽松薄款棉麻",
    "sellerName": "简韵女裤批发",
    "content": "该用户觉得商品非常赞，给出了五星好评",
    "rating": 5,
    "reviewer": "t**5",
    "reviewerLevel": "L2",
    "date": "2025-10-20 17:26:26",
    "location": null,
    "specs": "颜色: 黑色长裤, 尺码: XXL【131-145斤】 | 颜色: 麻本色长裤, 尺码: XXL【131-145斤】",
    "quantity": 2.0,
    "unit": "条",
    "reviewImages": [],
    "isAnonymous": false,
    "isSystemDefault": false,
    "isRepeatCustomer": false,
    "isPlusUser": false,
    "buyerRatingCount": 12,
    "buyerGoodRatingCount": 11
  }
]
```

### Advanced Usage

#### Supplier quality audit

Scrape reviews for several products from the same supplier. Compare ratings, review authenticity (check `isSystemDefault`), and repeat buyer rates across their catalog.

```json
{
    "productUrls": ["993648470412", "990606521619"],
    "maxReviewsPerProduct": 100
}
```

#### Quick sample check

Pull a small batch to validate product quality before placing a bulk order.

```json
{
    "productUrls": ["993648470412"],
    "maxReviewsPerProduct": 10
}
```

#### Full review dump

Extract all available reviews for deep analysis, sentiment scoring, or translation.

```json
{
    "productUrls": ["993648470412"],
    "maxReviewsPerProduct": 500
}
```

### Pricing

**$2.99 per 1,000 reviews** (pay per event).

| Reviews | Cost |
|---------|------|
| 10 | ~$0.03 |
| 100 | ~$0.30 |
| 1,000 | ~$2.99 |

### FAQ

**How many reviews can I extract per product?**
Up to 500 per product. Most 1688 listings have 20-200 reviews.

**What language are reviews in?**
Chinese (Simplified). Use any translation service or LLM to translate the `content` field.

**What does `isSystemDefault` mean?**
1688 auto-generates a default positive review when a buyer doesn't leave one manually. These show generic text like "该用户觉得商品非常赞". Filter them out for genuine feedback.

**What does `isRepeatCustomer` mean?**
The buyer has ordered from this seller before. A high repeat-customer ratio suggests reliable supplier quality.

**What are the `specs` values?**
The exact product variant the buyer purchased, decoded from 1688's internal format. Example: "颜色: 黑色长裤, 尺码: XXL" means color: black pants, size: XXL.

**Are reviews sorted?**
Yes, newest first. The most recent reviews are returned first.

**What if a product has no reviews?**
The actor moves to the next product. No error, no empty rows.

**Can I scrape reviews for products found with the Wholesale Scraper?**
Yes. Copy the `offerId` values from the Wholesale Scraper output and paste them into `productUrls`.

**What happens if I hit the budget limit?**
The actor stops and saves all reviews collected so far. No data is lost.

### More Zen Studio scrapers for Chinese platforms

**🛒 E-commerce**

- <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)
- <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 Reviews Scraper](https://apify.com/zen-studio/shopee-product-reviews-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-TASViBigl6dEv1GaH-RjnHoxkrmo-alibaba-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Alibaba 阿里巴巴**
  - [Alibaba Scraper](https://apify.com/zen-studio/alibaba-scraper)
  - [Alibaba Supplier Review Scraper](https://apify.com/zen-studio/alibaba-supplier-review-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)
  - [Goofish (Xianyu) Reverse Image Search Scraper](https://apify.com/zen-studio/goofish-xianyu-visual-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-0hS9yNh3RU8DC6puG-LozxRJkdHN-coupang-review-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Coupang 쿠팡**
  - [Coupang Review Scraper](https://apify.com/zen-studio/coupang-review-scraper)
  - [Coupang Search Scraper](https://apify.com/zen-studio/coupang-search-scraper)
  - [Coupang Product Detail Scraper](https://apify.com/zen-studio/coupang-detail-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 data. Users must comply with 1688.com terms and data protection regulations (GDPR, CCPA).

***

*Extract buyer reviews from 1688.com products with ratings, specs, and buyer intelligence.*

# Actor input Schema

## `productUrls` (type: `array`):

1688 product URLs or numeric offer IDs.<br><br>Accepts any format:<br>- Full URL: <code>https://detail.1688.com/offer/993648470412.html</code><br>- Just the ID: <code>993648470412</code><br><br>Mix and match freely.

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

Maximum number of reviews to scrape per product. Reviews are fetched newest-first.

## Actor input object example

```json
{
  "productUrls": [
    "https://detail.1688.com/offer/993648470412.html"
  ],
  "maxReviewsPerProduct": 100
}
```

# 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 = {
    "productUrls": [
        "https://detail.1688.com/offer/993648470412.html"
    ],
    "maxReviewsPerProduct": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/1688-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 = {
    "productUrls": ["https://detail.1688.com/offer/993648470412.html"],
    "maxReviewsPerProduct": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/1688-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 '{
  "productUrls": [
    "https://detail.1688.com/offer/993648470412.html"
  ],
  "maxReviewsPerProduct": 100
}' |
apify call zen-studio/1688-reviews-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "1688 Reviews Scraper | Product Ratings & Buyer Feedback",
        "description": "Extract buyer reviews from 1688.com products. Each review includes star rating, review text, buyer location, purchased specs, order quantity, and buyer credibility stats. Accepts product URLs or IDs, paginates automatically, returns structured JSON.",
        "version": "0.0",
        "x-build-id": "g46PH8xK85tb7dISe"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/zen-studio~1688-reviews-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-zen-studio-1688-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~1688-reviews-scraper/runs": {
            "post": {
                "operationId": "runs-sync-zen-studio-1688-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~1688-reviews-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-zen-studio-1688-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",
                "required": [
                    "productUrls"
                ],
                "properties": {
                    "productUrls": {
                        "title": "Product URLs or IDs",
                        "type": "array",
                        "description": "1688 product URLs or numeric offer IDs.<br><br>Accepts any format:<br>- Full URL: <code>https://detail.1688.com/offer/993648470412.html</code><br>- Just the ID: <code>993648470412</code><br><br>Mix and match freely.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxReviewsPerProduct": {
                        "title": "Max reviews per product",
                        "minimum": 5,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum number of reviews to scrape per product. Reviews are fetched newest-first.",
                        "default": 100
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```