# 1688 Product Details Scraper — SKUs, Stock, Supplier · $4/1k (`memo23/1688-product-details-scraper`) Actor

Get 1688 product details by link, offer ID, search URL or keyword: price tiers in CNY and USD, MOQ, stock, units sold, every SKU with stock and image, specs, reviews, shipping and the supplier profile, with English copies. Schedule a named monitor for new listings only. $4 per 1,000 products.

- **URL**: https://apify.com/memo23/1688-product-details-scraper.md
- **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community)
- **Categories:** E-commerce, Agents, Automation
- **Features:** Limited permissions
- **Stats:** 31 total users, 12 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 1688 Product Details Scraper & API — SKUs, Stock, Prices & Supplier

<p align="center">
  <img src="https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/1688-product-details-logo.png" alt="1688 Product Details Scraper logo" width="220" />
</p>

Paste 1688.com product links or offer IDs and get each product's full listing as one clean row: price tiers in **CNY and USD**, **minimum order quantity**, **stock**, **units sold**, **every SKU** with its stock, image and own price where the supplier sets one, the full **specification table**, the **reviews summary**, **shipping and dispatch time**, and the **supplier profile** with factory stats. Every Chinese field you filter on gets an **English copy** next to the original. No 1688 account needed.

| Input | Row(s) emitted |
| --- | --- |
| `https://detail.1688.com/offer/787646790056.html` | One product row |
| `https://m.1688.com/offer/926325393607.html` | One product row |
| `1001538323188` (bare offer ID) | One product row |
| `https://s.1688.com/selloffer/offer_search.htm?keywords=…` (search link) | One row per top product, up to "Products per search" |
| Keyword `蓝牙耳机` or `yoga mat` | One row per top product, up to "Products per search" |

### Why Use This Scraper?

- **Everything a sourcing decision needs, in one row.** Price breaks by quantity, MOQ, stock, units sold, variants, specs, ship-from city, dispatch promise, carrier, package size and unit weight.
- **Every SKU listed.** Each variant comes with its options (color, size, model…), stock and image, plus its own price in CNY and USD when the supplier prices by variant (otherwise the quantity tiers apply), so you can compare variants without opening the page.
- **Supplier vetting built in.** Company name, years on 1688, repeat-purchase rate, response rate, fulfilment rate, staff count, plant area, equipment count, certifications and inspection reports where the supplier publishes them, plus the storefront link.
- **English copies, Chinese kept.** Title, category, spec names and values, SKU options, review tags, services, supplier name and shipping text get an English copy; the original stays in the row.
- **USD next to every CNY price.** Converted at the day's reference rate, for the headline price, every quantity tier and every SKU that has its own price.
- **Links, search links or keywords.** Paste product links, a 1688 search results link, or just type keywords; English keywords are translated to Chinese before searching.
- **Only-new monitoring.** Name a monitor and schedule the run: each run returns only products it has not delivered before, and skipped products cost nothing.
- **You pay only for products delivered.** A product that cannot be read (removed, private or unavailable) is listed in the log and never charged.

### Overview

1688.com is Alibaba's domestic wholesale marketplace and the factory-direct source behind a large share of products sold on Amazon, Shopify, TikTok Shop and AliExpress. Its product pages carry the data sourcing teams need, but in Chinese, in CNY and spread across tabs.

This actor turns a list of 1688 product links or offer IDs into structured rows. Paste the links you collected from search, from a supplier's store, or from a spreadsheet, and each product comes back as one flat record with the same fields every time.

### Supported Inputs

- **Desktop product pages:** `https://detail.1688.com/offer/<id>.html`
- **Mobile product pages:** `https://m.1688.com/offer/<id>.html`, tracking parameters included
- **Bare offer IDs:** the 9–15 digit number from the link
- **Search results links:** `https://s.1688.com/selloffer/offer_search.htm?keywords=…` (Chinese keywords in either encoding) or the mobile search link; the best-matching products are looked up
- **Keywords** in "Search keywords": Chinese, or English (translated to Chinese first; model numbers such as ESP32-C3 are kept as typed)
- **Start URLs:** the Console, integrations and MCP clients send `startUrls`; it is read together with Product URLs (same shapes, duplicates dropped)
- Lists pasted from a spreadsheet work; duplicates are removed before anything is looked up. Lines that are none of the above are skipped and listed in the log.

Each keyword or search link adds up to 100 products, best matches first. For deeper keyword search, filters or photo search, use [1688 Wholesale Scraper](https://apify.com/memo23/1688-wholesale-scraper) and paste its links here for the full details. Supplier storefront links (`shopname.1688.com`) are not supported as input: paste the products' links instead.

### Use Cases

| Who | What they use it for |
| --- | --- |
| **Dropshippers & Amazon/Shopify sellers** | Compare suppliers for a product: price per tier, MOQ, stock, dispatch time, repeat-purchase rate. |
| **Sourcing agents & importers** | Build a shortlist with specs, package dimensions and unit weight for freight quotes. |
| **Brand & product teams** | Track a competitor's factory listings: price changes, stock, units sold, new variants. |
| **Market researchers** | Collect structured category data in English and USD for pricing studies. |
| **AI agents & automations** | Feed clean, English-annotated product records into sourcing assistants and procurement tools. |

### How It Works

![How the 1688 Product Details Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-1688-product-details.png)

1. **Paste products.** Add 1688 product links or offer IDs; duplicates and non-1688 lines are filtered out.
2. **Read each listing.** Every product's page data is collected: prices, SKUs, stock, specs, reviews summary, shipping and supplier profile. Products are read in parallel, about a minute and a half each, so 20 at a time handle roughly 800 products an hour.
3. **Export.** Each product becomes one row with English copies and USD prices, ready as JSON, CSV or Excel, or through the API.

### Input Configuration

| Field | Type | Description |
| --- | --- | --- |
| `productUrls` | array | 1688 product links, search results links or bare offer IDs, one per line. `startUrls` in the `{ "url": … }` format is accepted too. |
| `searchQueries` | array | Keywords to search on 1688; each adds its best-matching products. |
| `maxProductsPerSearch` | integer | Products each keyword or search link adds (1–100). Default `20`. |
| `translateKeywords` | boolean | Translate English keywords to Chinese before searching. Default `true`. |
| `translateToEnglish` | boolean | Add English copies of the Chinese text. Default `true`. |
| `monitoringStoreName` | string | Name a monitor to return only products not delivered in earlier runs with the same name. Empty = normal run. |
| `maxItems` | integer | Stop after this many products. Default `1000`. |
| `maxConcurrency` | integer | Products looked up in parallel (1–50). Default `20`. |

#### Example input

```json
{
  "productUrls": [
    "https://detail.1688.com/offer/787646790056.html",
    "926325393607"
  ],
  "translateToEnglish": true,
  "maxItems": 100
}
```

#### Example: only newly listed products, every day

```json
{
  "searchQueries": ["瑜伽垫"],
  "maxProductsPerSearch": 100,
  "monitoringStoreName": "yoga-mats"
}
```

Schedule this daily. The first run returns the current top 100; every later run returns only products that were not in an earlier result, and charges only for those.

### Output Overview

One flat JSON object per product. Lists (SKUs, specs, images, review tags, price tiers) are arrays; groups (shipping, supplier stats, package dimensions) are objects. When 1688 does not show a field for a product (a listing with no reviews yet, a supplier with no published certification), it comes back `null` or empty. Download as JSON, CSV, Excel, XML or JSONL, or read it through the Apify API.

### Output Sample

A real row, trimmed (long lists shortened):

```json
{
  "offerId": "926325393607",
  "url": "https://detail.1688.com/offer/926325393607.html",
  "title": "Athena lulu 抗菌运动长裤女宽松垂感显瘦直筒裤裸感瑜伽阔腿裤",
  "titleEn": "Athena lulu Antibacterial Sports Pants Women's Loose Drape Slim Straight Pants Nude Yoga Wide Leg Pants",
  "priceMin": 65,
  "priceMax": 69,
  "currency": "CNY",
  "priceMinUsd": 9.75,
  "priceMaxUsd": 10.35,
  "minOrderQuantity": 1,
  "stock": 19945,
  "rating": 5,
  "reviewCount": 1671,
  "categoryPath": "运动户外 > 瑜伽/健身服 > 瑜伽服",
  "categoryPathEn": "Sports and Outdoors > Yoga/Fitness Wear > Yoga Wear",
  "skus": [
    {
      "name": "蒸馏咖啡 Espresso > S",
      "options": { "颜色": "蒸馏咖啡 Espresso", "尺码": "S" },
      "optionsEn": { "color": "Espresso", "size": "S" },
      "stock": 1301
    }
  ],
  "specs": [
    { "name": "面料名称", "value": "锦纶", "nameEn": "Fabric name", "valueEn": "Nylon" },
    { "name": "功能", "value": "吸湿排汗", "nameEn": "Function", "valueEn": "Moisture wicking" }
  ],
  "shipping": {
    "logisticsText": "预计8小时发货，承诺7天发货",
    "dispatchHours": 8,
    "deliveryDays": 7,
    "fee": 4.9,
    "isFreeShipping": false,
    "shipFrom": "山东潍坊"
  },
  "supplierName": "诸城倚宁供应链管理有限公司",
  "supplierNameEn": "Zhucheng Yining Supply Chain Management Co., Ltd.",
  "supplierStats": {
    "employeeCount": 49,
    "plantAreaSqm": 3000,
    "equipmentCount": 50,
    "productCount": 260,
    "repeatRate": 0.71,
    "fulfillmentRate": 0.98
  },
  "supplierShopUrl": "https://winport.1688.com/page/index.html?memberId=b2b-220111175764790829&_tabId_=index&upstreamSource=od&offerId=926325393607",
  "scrapedAt": "2026-11-03T13:33:22.521Z"
}
```

### Key Output Fields

**Identity:** `offerId`, `url`, `title`, `titleEn`, `category`, `categoryPath`, `categoryPathEn`

**Price & order terms:** `priceMin` / `priceMax` (CNY), `priceMinUsd` / `priceMaxUsd`, `priceTiers` (quantity breaks with `priceUsd`), `minOrderQuantity`, `unit`, `mixWholesale`, `purchaseLimits`, `coupons`, `promotionDetails`

**Stock & demand:** `stock`, `isOutOfStock`, `soldCount`, `soldDisplay`, `wantBuyCount`

**Variants:** `skus` (options, `optionsEn`, price, `priceUsd`, stock, image)

**Product:** `specs` (with `nameEn` / `valueEn`), `images`, `descriptionImages`, `descriptionText` / `descriptionTextEn` (the seller's note on the listing), `videoUrl`, `packageDimensions`, `unitWeightKg`

**Reviews:** `rating`, `ratingScale`, `reviewCount`, `positiveRate`, `reviewTags` (with `tagEn`), negative / neutral / with-photo counts

**Shipping & services:** `shipping` (carrier, dispatch hours, delivery days, fee, ship-from with English copies), `services`, `servicesEn`, `serviceDetails`, `supportsDropship`, `supportsSampling`, `customizationSupported`

**Supplier:** `supplierName`, `supplierNameEn`, `supplierType`, `supplierYears`, `supplierFans`, `supplierStats` (repeat rate, response rate, staff, plant area, equipment…), `supplierCertification`, `supplierRank`, `supplierAddress`, `supplierCoordinates`, `city` / `cityEn`, `province` / `provinceEn`, `supplierShopUrl`

### Pricing

**$4 per 1,000 products** ($0.004 per product row), no start fee. Products that cannot be read are never charged, and the run stops at the spending limit you set. On the Apify free plan a run returns up to 50 products.

### FAQ

**Do I need a 1688 account?**
No. Paste product links or offer IDs and run.

**How long does a run take?**
About a minute and a half per product, with 20 products read in parallel by default: roughly 800 products an hour. Raise "Products at a time" for bigger lists.

**Are the English translations machine-made?**
Yes. They are automatic translations placed next to the Chinese original, which is always kept, so you can check or re-translate any field.

**Why is a field empty for some products?**
1688 shows different data for different listings: new products have no reviews, some suppliers publish no certifications, some variants carry no own price (the quantity tiers apply). Those fields come back `null` or empty rather than guessed.

**What happens to products that can't be read?**
Removed, private or unavailable offers are skipped, listed in the run log, and not charged.

**How is the USD price calculated?**
CNY prices are converted at the day's reference exchange rate. If the rate can't be read, USD fields are left empty rather than estimated.

**Can I start from a keyword instead of links?**
Yes. Add keywords to "Search keywords" or paste a 1688 search results link; each adds up to 100 best-matching products with full details. For deeper search, filters or photo search, use [1688 Wholesale Scraper](https://apify.com/memo23/1688-wholesale-scraper) and paste its links here.

**How does "Only new products" work?**
The run keeps the IDs it delivered in a key-value store in your own Apify account, named after the monitor. Later runs with the same name skip those products before looking them up, so they are neither returned nor charged. Use a new name to start over.

**Do I get the individual review texts?**
No. Each row has the reviews summary: average rating, review count, positive rate, negative / neutral / with-photo counts and the review tags buyers mention most, with counts and English copies.

**Can I paste a supplier's shop link?**
Not as input. Paste the shop's product links, or search for the products by keyword.

### Support

- **Found a bug or need a field?** Open an issue on this actor's **Issues** tab; it's the fastest way to reach me.
- **Email:** <muhamed.didovic@gmail.com>
- **Website:** [muhamed-didovic.github.io](https://muhamed-didovic.github.io/)

### Additional Services

Need scheduled price and stock monitoring for a supplier list, delivery to your own database, or a custom field set? I build and maintain custom scrapers and data pipelines. Reach out through the Issues tab or by email.

### Explore More Scrapers

- [1688 Wholesale Scraper](https://apify.com/memo23/1688-wholesale-scraper): 1688 keyword and photo search
- [1688 Image Search](https://apify.com/memo23/1688-image-search-scraper): find 1688 suppliers from a product photo
- [1688 Supplier Scraper](https://apify.com/memo23/1688-supplier-scraper): factories and wholesalers for a product with factory profiles, and every product of one supplier
- [AliExpress Product Details Scraper](https://apify.com/memo23/aliexpress-product-details-scraper): variants, stock and shipping for AliExpress products
- [AliExpress Scraper](https://apify.com/memo23/aliexpress-scraper): AliExpress search results

More on my profile: [memo23 on Apify](https://apify.com/memo23).

### 🤖 For AI Agents & LLM Apps

Actor: `memo23/1688-product-details-scraper`.

**Purpose:** 1688.com product links or offer IDs → one structured row per product with CNY and USD prices, MOQ, stock, SKUs, specs, reviews summary, shipping and supplier profile, with English copies of Chinese fields.

**Minimal input:**

```json
{ "productUrls": ["https://detail.1688.com/offer/787646790056.html", "926325393607"], "maxItems": 20 }
```

**Behaviors an agent should know:**

- Accepts `productUrls` (strings) and `startUrls` (`{ "url": … }` objects): product links, search links, offer IDs; duplicates are removed.
- `searchQueries` adds the top `maxProductsPerSearch` products per keyword (≤100).
- `monitoringStoreName` returns only products not delivered in earlier runs with that name; skipped products are not charged.
- Each product takes about 90 seconds; 20 run in parallel by default.
- Unreadable products are skipped and not charged; the run's status message reports how many.
- `translateToEnglish: false` skips the English copies.
- Billing: one `product` event per delivered row.

### ⚠️ Disclaimer

This actor is an independent tool and is not affiliated with, endorsed by, or connected to 1688.com, Alibaba Group or any of their affiliates. It collects publicly visible product information for research, sourcing and price-comparison purposes. You are responsible for using the data in line with applicable laws and 1688's terms. Translations are automatic and provided as a convenience; the Chinese original is the reference.

### SEO Keywords

1688 scraper, 1688 product details, 1688 products, 1688 product data, 1688 product scraper, 1688.com scraper, 1688 API alternative, 1688 SKU scraper, 1688 price scraper, 1688 supplier scraper, alibaba 1688 scraper, china wholesale scraper, 1688 sourcing tool, 1688 to english, 1688 product data, 1688 stock checker, 1688 MOQ, dropshipping sourcing, china supplier data, factory supplier vetting, wholesale price comparison, 1688 json export, 1688 csv export

# Actor input Schema

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

1688 product pages, one per line: https://detail.1688.com/offer/926325393607.html, the mobile m.1688.com/offer/... link, or just the offer ID. A 1688 search results link works too: its top products are looked up, up to "Products per search". Duplicates are removed before anything is looked up.

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

Optional. Same as Product URLs above: 1688 product pages, search-results links or offer IDs. The Console, integrations and MCP clients send this field. Paste here or there; both are read and duplicates are dropped.

## `maxItems` (type: `integer`):

Stop after this many products. Each product is one charged row; products that cannot be read are never charged.

## `searchQueries` (type: `array`):

Optional. Keywords to search on 1688, e.g. 蓝牙耳机 or yoga mat. Each keyword returns its best-matching products with full details, up to "Products per search". English keywords are translated to Chinese first, since 1688 matches Chinese far better.

## `maxProductsPerSearch` (type: `integer`):

How many products each keyword or pasted search link adds (best matches first, up to 100).

## `monitoringStoreName` (type: `string`):

Optional. Give the monitor a name (e.g. yoga-mats) and every later run with the same name skips products it already delivered, so they are neither returned nor charged again. Schedule it with a keyword to get only newly listed products. Leave empty for a normal run.

## `translateKeywords` (type: `boolean`):

Translate English keywords to Chinese before searching. Model numbers (e.g. ESP32-C3) are kept as typed.

## `translateToEnglish` (type: `boolean`):

Adds English next to the Chinese original for the title, category, specs, SKU options, review tags, services and supplier name. The Chinese text is always kept.

## `includeSupplierProfile` (type: `boolean`):

Adds supplierProfile to each row: year founded, factory area, staff, production lines, equipment, patents, certificates, the company that audited the factory, OEM minimum order, export markets, response and on-time-delivery rates, rating and followers. One extra read per supplier, shared across that supplier's products, at no extra charge. Suppliers with no public profile, or whose shop link does not name them, get an empty profile.

## `maxConcurrency` (type: `integer`):

How many products are looked up in parallel. Each takes about a minute and a half, so 20 at a time handles roughly 800 products an hour.

## Actor input object example

```json
{
  "productUrls": [
    "https://detail.1688.com/offer/926325393607.html"
  ],
  "maxItems": 1000,
  "maxProductsPerSearch": 20,
  "translateKeywords": true,
  "translateToEnglish": true,
  "includeSupplierProfile": true,
  "maxConcurrency": 20
}
```

# Actor output Schema

## `products` (type: `string`):

All products in the overview table.

# 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/926325393607.html"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("memo23/1688-product-details-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/926325393607.html"] }

# Run the Actor and wait for it to finish
run = client.actor("memo23/1688-product-details-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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/926325393607.html"
  ]
}' |
apify call memo23/1688-product-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,memo23/1688-product-details-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/EJJ7Eidl6sGq6CHme/builds/23Rjl3G7i34qCJxc2/openapi.json
