1688 Listings Scraper

🇨🇳 1688.com Listings Scraper

Easily extract wholesale product data from 1688.com, Alibaba's domestic-China B2B marketplace and the original source for most products you'll find on Alibaba.com — usually at a fraction of the export price. The 1688.com Listings Scraper lets you search by keyword (Chinese or English) or fetch specific offer IDs and pulls back structured product data for sourcing, price intelligence, and supplier research.

✨ Features

• 🏷️ Rich product data: title, tiered price ladder, MOQ, full attribute matrix, supplier company, after-sales policy, logistics, images.
• 🔍 Keyword search & direct offer lookup: paginate any keyword across 1688's mobile search, or scrape known offer IDs directly.
• 💴 Tiered wholesale prices: 1688's headline feature — volume-discount ladders — extracted as first-class data, not an afterthought.
• 🌏 Built for CN access: ships with Apify Residential proxy (country=CN) prefilled and auto-rotates sessions on the _____tmd_____ block page.
• ⚡ Fast & efficient: powered by Crawlee CheerioCrawler — no browser, no headless overhead.

🛠️ How It Works

1. Enter keywords or offer IDs — Chinese terms (e.g. 蓝牙耳机) return the richest results, but English (bluetooth earphones) is accepted.
2. Toggle detail mode — keep includeDetails off for fast shallow listing surveys ($1/1k), or turn it on for full per-product detail pages ($4/1k).
3. Run the scraper — the Actor handles pagination, proxy rotation, and anti-bot retries automatically.

📋 Input

Field	Type	Default	Description
keywords	string[]	["iphone case"]	Search terms to look up on 1688. Chinese works best; English is also accepted. Each keyword is paginated independently.
offerIds	string[]	[]	Specific 1688 offer IDs (e.g. 782846321577). Bypasses search — handy when you already know which products you want.
maxItems	integer	50	Hard cap on rows pushed to the dataset across all keywords. Set 0 for unlimited.
maxPagesPerKeyword	integer	5	Search-result pages to walk per keyword (19 offers each, capped at 100).
includeDetails	boolean	false	If true, each search hit is followed to its detail page for tiered prices, attributes, MOQ, and seller info. If false, only shallow card data is collected.
proxyConfiguration	object	Apify Residential, country = CN	Apify Proxy config. CN residential is strongly recommended — 1688 blocks non-Chinese IPs aggressively.

Example input:

{
  "keywords": ["iphone case", "蓝牙耳机"],
  "maxItems": 200,
  "maxPagesPerKeyword": 5,
  "includeDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "CN"
  }
}

📊 Sample Output Data

Structured JSON output. Each product when includeDetails: true looks like this:

[
    {
        "offerId": "782846321577",
        "title": "潮牌金属适用iphone15promax手机壳苹果16pro立体十字架个性17air",
        "priceFrom": 12.8,
        "priceTo": 27,
        "unit": "个",
        "minOrderQuantity": 1,
        "tierPrices": [
            { "price": 12.8, "beginAmount": 1 },
            { "price": 27, "beginAmount": 1 }
        ],
        "soldCount": "4029",
        "wantBuy": "3524",
        "attributes": [
            { "name": "材质", "value": "仿皮" },
            { "name": "品牌", "value": "苹果" },
            { "name": "适用机型", "value": "苹果" }
        ],
        "images": [
            "https://cbu01.alicdn.com/img/ibank/O1CN0192dePV1p7PFGqWJGK_!!2831885313-0-cib.jpg"
        ],
        "services": ["7天无理由退货", "晚发必赔"],
        "logistics": {
            "location": "广东广州",
            "deliveryLimit": "承诺48小时发货·常发韵达快递",
            "unitWeight": 0
        },
        "sellerCompany": "广州市威卡诺塑料制品有限公司",
        "sellerLoginId": "艾诺奇1688",
        "sellerMemberId": "b2b-2831885313c05f4",
        "sellerWinportUrl": "https://winport.m.1688.com/page/index.html?memberId=b2b-2831885313c05f4",
        "location": "广东广州",
        "url": "https://m.1688.com/offer/782846321577.html",
        "scrapedAt": "2026-05-12T11:00:00.000Z"
    }
]

When includeDetails: false, you get a lighter row per offer with the core fields (offerId, title, priceFrom, soldCount, location, repurchaseRate, sellerTenure, image, url).

💡 Tips

• CN residential proxy is non-negotiable. 1688's desktop site is gated from request #1 for non-Chinese IPs. The mobile site this Actor uses is more permissive but still triggers slider-CAPTCHA after ~5–15 hits/IP/10 min. The prefilled Apify Residential + apifyProxyCountry: "CN" config handles rotation automatically.
• Use Chinese keywords when possible — the mobile search URL hex-encodes the keyword, and 蓝牙耳机 returns far more relevant results than bluetooth earphones.
• Compare 1688 ↔ Alibaba.com by pairing this Actor with piotrv1001/alibaba-listings-scraper on the same keyword set — see domestic vs export pricing for the same SKU.

💰 Pricing

This Actor uses Pay-Per-Event pricing — you only pay for results, not compute time or proxy GBs.

Event	Price	Triggered when
product-listing	$1.00 / 1,000 results	A shallow listing row is pushed (when includeDetails: false). Includes title, price, MOQ, seller, location, image.
item-detail	$4.00 / 1,000 results	A full detail row is pushed (when includeDetails: true). Includes everything above plus tiered prices, full attribute matrix, all images, after-sales policy, logistics, and full seller / company info.

A typical run of 1,000 detail-mode products costs ~$4 plus your Apify Residential proxy spend.

Optimize your sourcing and price intelligence with 1688.com Listings Scraper today! 🚀