1688 Product Scraper

What does 1688 Product Scraper do?

1688 Product Scraper reads product offers and search results from 1688.com, the Chinese wholesale marketplace. Give it offer links or search keywords and it returns one row per offer with about 100 fields: wholesale prices by quantity, variants with stock, sales, supplier, ratings, dropshipping terms and description.

• No 1688 account, no cookies, no proxy of your own. Paste links or keywords and press Start.
• Full offer rows. The supplier card, the ratings, the dropshipping terms and the description come with every offer, not only what the offer page itself carries.
• Search by keyword. Up to 180 offers per keyword, each stored once.
• Fast. About 2,600 offers an hour with the default settings; 100 offers took a little over two minutes in our runs.
• You pay per row that was read and stored, and for nothing else.

It runs on the Apify platform, so you also get scheduling, an API, webhooks, integrations, and export of the results to JSON, CSV, Excel or HTML.

What data can you extract from 1688?

Group	Fields
Offer	id, title, category name and ids, brand, attributes, selling points, status, dates created, changed and posted
Price	lowest and highest price, price by quantity, prices before a promotion, unit, smallest order, mixed-batch terms
Variants	every variant with its id, name, price and stock; total stock; weight and package size
Sales	units sold, orders in 30 days, repeat-buyer rate, number of reviews, review tags, rating
Media	pictures, video link and cover
Delivery	where it ships from, postage, promised dispatch time, usual carrier, guarantees
Supplier	company name, seller ids, shop link, years on 1688, star level, main category, service scores, badges (TrustPass, factory, strength merchant)
Dropshipping	whether it is offered, the channels it is offered for, prices and services
Description	text, pictures, link to the description file

A search row is shorter: offer id, title, price, price by quantity, units sold, repeat-buyer rate, supplier name and ids, shop link, years on 1688, province and city, tags, picture, link, whether the result is an ad, and its place on the page.

How to scrape 1688 products

1. Open the actor and go to the Input tab.
2. Paste offer links or ids (one per line), or type search keywords, or both.
3. For keywords, choose how many pages of results to read (1 to 3) and whether to open every search result to get its full offer row.
4. Press Start.
5. Open the Output tab, or export the dataset as JSON, CSV or Excel, or read it through the API.

How much does it cost to scrape 1688?

You pay for the rows the actor stores, at two prices:

What	Price
An offer row	$3.00 per 1,000
A search result row	$0.50 per 1,000

• 1,000 full offer rows cost $3.00.
• One keyword read to the end is at most 180 search rows: $0.09.
• A keyword with every result opened is at most 180 offer rows: $0.54.

You do not pay for offers the actor could not read, and a run that reads nothing fails without charging a row. Apify's free plan comes with $5 of usage a month, which is enough for about 1,600 offer rows.

Input

Field	What it does
offers	Offer links or ids. https://detail.1688.com/offer/762640272016.html and 762640272016 are the same.
keywords	Search keywords. Chinese keywords find the most.
maxPagesPerKeyword	1 to 3 pages of results per keyword, 60 results a page.
scrapeDetails	Off: a short row per search result. On: the full offer row for every search result.
includeExtras	Adds the supplier card, ratings, dropshipping terms and description to every offer. On by default.
maxItems	Stop after this many rows.
maxConcurrency	How many offers and search pages are read at the same time. 10 by default.

Offers by link:

{
    "offers": [
        "https://detail.1688.com/offer/1038945499752.html",
        "762640272016"
    ]
}

A keyword, with the full row for every result:

{
    "keywords": ["手机壳"],
    "maxPagesPerKeyword": 2,
    "scrapeDetails": true
}

Output

Every row has a type field: offer or search_result.

An offer row

About 100 fields; the main ones are shown here, with the lists cut short.

{
    "type": "offer",
    "offer_id": "1038945499752",
    "url": "https://detail.1688.com/offer/1038945499752.html",
    "title": "雅盾磁吸适用iPhone18promax手机壳秒变苹果17promax全包防摔壳16",
    "category_name": "iPhone保护套",
    "brand": "潮虹兔",
    "unit": "个",
    "price_min": 7,
    "price_max": 8.5,
    "price_tiers": [
        {"price": 8.5, "from_quantity": 1},
        {"price": 8, "from_quantity": 300},
        {"price": 7, "from_quantity": 3000}
    ],
    "min_order": 1,
    "stock_total": 1559335,
    "sku_count": 156,
    "skus": [
        {"sku_id": 6224367734976, "spec": "黑色>iPhone 14pro", "price": null, "discount_price": null, "stock": 9999, "sold": 0}
    ],
    "sold_count_min": 600,
    "orders_30d_min": 3000,
    "review_count": 21328,
    "goods_grade": 5,
    "good_rate_percent": 99.6,
    "repeat_rate_3m": "57.18%",
    "attributes": {"材质": "PC", "款式": "二合一", "品牌": "潮虹兔"},
    "images": ["https://cbu01.alicdn.com/img/ibank/O1CN01MQmJszTNdAB2vH2e_!!3872131675-0-cib.jpg"],
    "has_video": true,
    "ships_from": "广东省深圳市",
    "post_fee": 3,
    "delivery_promise": "承诺48小时发货·常发韵达快递",
    "guarantees": ["7天无理由退货", "晚发必赔"],
    "company": "深圳市亿佳合兴科技有限公司",
    "shop_url": "https://shop764420m281617.1688.com",
    "supplier_years": 9,
    "supplier_star": 4,
    "supplier_main_category": "苹果专用配件",
    "supplier_scores": {"品质达标率": "99.9%", "综合履约率": "91.9%", "店铺回头率": "57.2%"},
    "seller_is_trustpass": true,
    "seller_is_factory": false,
    "rating_grade": 5,
    "rating_good_percent": 100,
    "dropship_channels": ["Lazada", "Amazon", "Shopify", "Shopee"],
    "dropship_prices": [{"quantity": "1件价格", "price": 8.5}],
    "description_text": "首先恭喜您找到源头厂家货源，批发量大价优！...",
    "description_images": ["https://cbu01.alicdn.com/img/ibank/O1CN01hBll2W1OFCAqJ7128_!!3872131675-0-cib.jpg"],
    "created_at": "2026-04-05T14:18:37Z",
    "modified_at": "2026-10-13T13:18:30Z"
}

A search result row

{
    "type": "search_result",
    "keyword": "蓝牙耳机",
    "page": 1,
    "position": 5,
    "offer_id": "1051199602311",
    "url": "https://detail.1688.com/offer/1051199602311.html",
    "title": "【新升级】2026新款蓝牙耳机无线耳夹运动降噪高音质无线夹耳",
    "price": 5.01,
    "price_note": "限时价",
    "sold_text": "全网4.2万+件",
    "sold_count_min": 42000,
    "booked_count": 8135,
    "repeat_buyer_rate": "10%",
    "company": "厦门祥德行塑胶有限公司",
    "shop_url": "http://shop7176332hn1j77.1688.com",
    "supplier_years": 2,
    "province": "福建",
    "city": "厦门市",
    "tags": ["退货包运费", "先采后付", "回头率10%"],
    "image": "https://cbu01.alicdn.com/img/ibank/O1CN01HcxZQF1JWzrRozisJ_!!2219639211037-0-cib.jpg",
    "is_ad": false
}

Limits you should know

• Search gives up to 180 offers per keyword. 1688 shows a visitor who is not logged in three pages of 60 results and no more. It sometimes shows an offer again on a later page; the actor stores an offer once per keyword, at the place it was first shown, and you do not pay for the repeat. To get more offers, use more specific keywords.
• A supplier card, a rating or a description is sometimes missing for an offer: 1688 has none for it, or did not answer for that block. The row is returned with the fields it has.
• Descriptions are mostly pictures. Sellers on 1688 usually put the description into images, so description_text is often short and description_images is long.
• The supplier's legal details (registration number, registered capital) are on a separate page of the shop and are not read. shop_credit_url in the row points to it.
• Text is returned as 1688 gives it: in Chinese, prices in CNY.
• A full offer row takes about 14 seconds for one reader; ten read at the same time by default. For a large job set the run's timeout to fit.

FAQ

Do I need a 1688 account, cookies or a proxy?

No. The actor reads what 1688 shows to a visitor who is not logged in, and brings its own connections.

What happens when an offer could not be read?

Each offer is tried up to three times. What still fails is listed in the FAILED record of the run's key-value store, with the reason, and is not charged. The SUMMARY record holds the counts of the run. A row is never stored twice, also when the platform restarts a run.

Can I get more than 180 results for a keyword?

Not for one keyword: that is where 1688 stops a visitor who is not logged in. Use several narrower keywords instead. A search row is returned under every keyword that finds the offer; with "open every search result" the full offer row is read and charged once per run.

Can I run it on a schedule or call it from my code?

Yes. Use Apify's schedules for regular runs, and the Apify API or its clients for Python and JavaScript to start runs and read results. The maxItems field and the run's spending limit keep a run within a budget.

Is it legal to scrape 1688?

The actor reads only what 1688.com shows publicly, without logging in. Offer pages name companies and their shops, and a seller can be a private person, so handle names as the data protection rules that apply to you require. You are responsible for how you use the data; if you are not sure, ask a lawyer.

Something is wrong or a field is missing

Open an issue on the actor's Issues tab with the offer link or the keyword. Requests for other marketplaces are welcome there too.

1688 is a trademark of its owner. This actor is not affiliated with or endorsed by 1688.com or Alibaba Group.