# 1688 Product Details Scraper: Full Data by URL (`theshark/1688-product-details-scraper`) Actor

Scrape full 1688.com product pages by link or offer ID: tiered prices, MOQ, stock, sales, images, video, attributes, package size, supplier profile and shipping. Optional SKU variants, reviews and factory data. No login. Pay only for results.

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

## Pricing

from $3.99 / 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: Full Product Data by URL or Offer ID

Scrape full product pages from [1688.com](https://www.1688.com) (Alibaba 1688), China's largest wholesale marketplace. Give product links or offer IDs and get everything on the page: tiered prices, minimum order quantity (MOQ), stock, sales, images, video, attributes, package size and weight, supplier profile, shipping and services. Optional add-ons bring every SKU variant with its price and stock, the description HTML, buyer reviews, factory data and the same item from other sellers.

No 1688 account, login, cookies or proxies of your own are needed. You pay only for products that were collected successfully.

### What can you do with 1688 Product Details Scraper?

- **Import products to your store:** titles, images, video, attributes and variants for dropshipping and e-commerce catalogs.
- **Check prices before ordering:** quantity price tiers, MOQ, stock and shipping cost for the products you plan to buy.
- **Check the supplier:** company registration, founding year, factory profile, service score and repeat buyer rate.
- **Read what buyers say:** up to 100 latest reviews per product, without buyer names.
- **Watch your products:** run the same list on a schedule and compare prices and stock over time.

### What data do you get?

| Data | Fields |
|---|---|
| Product | offer ID, link, title, category, attributes, package size and weight |
| Price and ordering | price range, quantity price tiers, MOQ, unit, stock, mixed wholesale, single-piece retail |
| Sales and popularity | sold count, favorites, badges, review summary (good rate, grade, buyer impression tags) |
| Media | images, main images, video, description images |
| Supplier | company name, shop link, seller chat link, location, service score, repeat buyer rate, supplier type, company registration, founding year, factory profile, shop metrics |
| Shipping and services | ships from, shipping cost, delivery promise, services, coupons, sales channels |
| SKU variants (optional) | every variant with its options, price, stock and sales |
| Reviews (optional) | review text, rating, date, variant, quantity, buyer city |
| Supplier intelligence (optional) | factory card (videos, rankings, equipment, production lines, OEM minimums, capacity, address), product certificates (CE, FCC, RoHS and more), customization services and prices, lead times, dropshipping metrics, product ranking |
| Same items (optional) | up to 8 offers of the same item from other sellers |

### How to scrape 1688 product details

1. Paste 1688 product links (`detail.1688.com/offer/<id>.html`) or offer IDs into **Product URLs or offer IDs**.
2. Choose the extra data you need: SKU variants, description HTML, reviews, supplier intelligence, same items.
3. Click **Start**. Products appear in the dataset while the run goes on.
4. Download the results as JSON, CSV, Excel or HTML, or get them through the API.

If you start the actor with an empty input, it runs a small example with two products, so you can see what the data looks like.

### Input

| Field | Type | Default | What it does |
|---|---|---|---|
| `offerIds` | list of strings | empty | 1688 product links or offer IDs, for example `735353578254`. |
| `includeSkuDetails` | boolean | `false` | Add every variant with its options, price, stock and sales. |
| `includeDescriptionHtml` | boolean | `false` | Add the full product description as HTML. Description text and images are always included. |
| `includeReviews` | integer, 0 to 100 | `0` | How many latest reviews to attach to each product. Charged per review. |
| `includeSupplierIntelligence` | boolean | `false` | Add factory card, product certificates, customization services and rankings. Charged as an add-on. |
| `includeSameItems` | boolean | `false` | Add up to 8 offers of the same item from other sellers. Charged as an add-on when the list is not empty. |

#### Examples

```json
{ "offerIds": ["735353578254", "https://detail.1688.com/offer/634155097789.html"] }
```

With variants, 20 reviews and factory data:

```json
{
  "offerIds": ["735353578254"],
  "includeSkuDetails": true,
  "includeReviews": 20,
  "includeSupplierIntelligence": true
}
```

### Output

One dataset row per product, shown in the **Products** view. Rows can be downloaded as JSON, CSV, Excel and more. Text fields (titles, attributes, supplier names, reviews) are in the original Chinese, prices are in CNY. Example row (shortened; real rows have more fields and full lists):

```json
{
  "offerId": "735353578254",
  "detailUrl": "https://detail.1688.com/offer/735353578254.html",
  "status": "OK",
  "title": "适用iphone18PRO大视窗磁吸手机壳15磨砂漏标苹果11秒变17保护套",
  "categoryName": "iPhone保护套",
  "unit": "个",
  "price": { "min": 9.0, "max": 9.0, "currency": "CNY", "basis": "quantity" },
  "quantityPrices": [
    { "minQuantity": 2, "price": 9.0 },
    { "minQuantity": 500, "price": 8.5 },
    { "minQuantity": 5000, "price": 7.5 }
  ],
  "minOrderQuantity": 2,
  "stock": 2692428,
  "mixWholesale": { "supported": true, "minQuantity": 2, "minAmount": 5 },
  "soldCount": 19793,
  "soldDisplay": "1.9万+",
  "favoriteCount": 458,
  "videoUrl": "https://cloud.video.taobao.com/play/u/3872131675/p/2/e/6/t/1/533538773043.mp4",
  "attributes": [
    { "name": "材质", "value": "PC" },
    { "name": "款式", "value": "防摔款" }
  ],
  "unitWeightKg": 0.03,
  "supplier": {
    "companyName": "深圳市亿佳合兴科技有限公司",
    "serviceScore": 4.0,
    "repeatBuyerRate3m": 56.5,
    "isTp": true,
    "location": "广东省深圳市"
  },
  "shipping": { "from": "广东省深圳市", "cost": 3.0, "text": "承诺48小时发货·常发韵达快递", "deliveryLimit": 2 },
  "distributionChannels": ["淘宝", "抖音", "快手", "微信", "Lazada", "Amazon", "Shopify", "Shopee"],
  "scrapedAt": "2026-11-12T15:21:54+00:00"
}
```

### How much does it cost to scrape 1688 product pages?

Pay per event: a flat price per product and per add-on. The current prices are on the **Pricing** tab.

| Event | When it is charged |
|---|---|
| `product` | One product collected from its page (status `OK`). |
| `reviews` | One review attached to a product. |
| `supplier-intelligence` | At least part of the supplier intelligence data was found for a product. |
| `same-items` | `sameItems` is not empty. |

Only rows with status `OK` are charged, and an add-on only when its data is in the row: a product without reviews or a supplier without factory data costs nothing extra. Set a maximum charge per run in Apify and the actor stops cleanly when it is reached.

#### Row statuses

| Status | Meaning | Charged? |
|---|---|---|
| `OK` | The product was collected. | Yes |
| `NOT_FOUND` | The product is no longer on 1688 or the ID is wrong. | No |
| `BLOCKED` | 1688 did not show this page this time. Run it again later. | No |
| `ERROR` | The row could not be collected, for example an invalid link or a page without prices. `statusMessage` says why. | No |

### Good to know

- **Reviews.** 1688 shows visitors without an account only part of a product's reviews, so a product can have fewer reviews than you asked for. You pay only for the reviews you get. Buyer names, avatars and profiles are never collected.
- **Supplier intelligence depends on the supplier.** Factory cards exist only for verified factories, and many suppliers have no certificates or customization data.
- **Data is in Chinese.** Titles, attributes and supplier names come as 1688 shows them. Prices are in CNY.
- **No contacts.** No phone numbers, emails, WeChat or QQ, or names of company contact persons. The only supplier contact is the public seller chat link.
- **Run settings.** Give the run a timeout of at least 5 minutes. The minimum memory is 1024 MB.

### Integrations and API

Start runs and download results with the [Apify API](https://docs.apify.com/api/v2) or the Apify clients for Python and JavaScript, run on a schedule, and send results to Google Sheets, Slack, Make, Zapier, webhooks and other tools supported by Apify.

### FAQ

**Where do I find the offer ID?**
It is the number in the product link: `https://detail.1688.com/offer/735353578254.html` has the offer ID `735353578254`. You can paste the whole link.

**How many products can I scrape in one run?**
As many as you give. Products are scraped in parallel; give the run enough time for long lists.

**Do I need a 1688 account or proxies?**
No. The actor uses its own proxies in China and does not log in.

**Is it legal to scrape 1688?**
The actor collects only publicly visible product information and no personal data. You are responsible for how you use the data and for following the laws and terms that apply to you.

### More 1688 scrapers

- [1688.com Wholesale Scraper](https://apify.com/TheShark/china-1688-scraper): every mode in one actor, plus suppliers and price monitoring.
- [1688 Search Results Scraper](https://apify.com/TheShark/1688-search-results-scraper): fast, low-cost product cards by keyword, link or category.
- [1688 Image Search Scraper](https://apify.com/TheShark/1688-image-search-scraper): find products and suppliers by photo.
- [1688 Supplier Scraper](https://apify.com/TheShark/1688-supplier-scraper): supplier profiles and their products.
- [1688 Price Monitor](https://apify.com/TheShark/1688-price-monitor): track prices, stock and sales of your products.

# Actor input Schema

## `offerIds` (type: `array`):

1688 product links (detail.1688.com/offer/<id>.html) or offer IDs, for example 735353578254.

## `includeSkuDetails` (type: `boolean`):

Add the full variant matrix: each variant with its options, price, stock and sales.

## `includeDescriptionHtml` (type: `boolean`):

Add the full product description as HTML. Description text and images are always included.

## `includeReviews` (type: `integer`):

How many latest reviews to attach to each product (0 to 100). 1688 shows anonymous visitors only part of a product's reviews, so some products get fewer. Buyer names, avatars and profiles are never collected. Charged per review delivered.

## `includeSupplierIntelligence` (type: `boolean`):

Add a supplierIntelligence block: factory card for verified factories (videos, rankings, equipment list, production lines, OEM minimums, production capacity, factory address and coordinates), product certificates (including CE/FCC/RoHS), customization (services with prices, printing price list, lead times by quantity), dropshipping metrics and the product's ranking on 1688. Up to 6 extra requests per product. Charged as an extra event only when at least part of this data is found. Always included for free: founding year, company registration with address, supplier profile (staff, area, equipment, verification), shop metrics (stars, quality and fulfilment rates, followers, years on 1688) and the seller chat link.

## `includeSameItems` (type: `boolean`):

Add a sameItems list to each product: up to 8 offers of the same item from other sellers (title, price, sales text, image and link; no seller details). Billed as a same-items event only when the list is not empty.

## Actor input object example

```json
{
  "includeSkuDetails": false,
  "includeDescriptionHtml": false,
  "includeReviews": 0,
  "includeSupplierIntelligence": false,
  "includeSameItems": false
}
```

# Actor output Schema

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

One dataset row per product.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/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 = {}

# Run the Actor and wait for it to finish
run = client.actor("theshark/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 '{}' |
apify call theshark/1688-product-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,theshark/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/DxfNpH0xDKRylfgve/builds/HVm6Z1271QpQqIekn/openapi.json
