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.
• Have a photo, not a keyword? 1688 Image Search finds the offers that look like a product photo.
• 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; the prices also in US dollars at the European Central Bank's rate of the day
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 (such as "极速开票", fast invoicing)
Export	whether the offer is marked for cross-border trade, export services such as FBA labels, box marks and foreign-language packaging, whether a free sample is offered
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
English title (add-on)	title_en, an English machine translation of the title, for offers and search results

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.

Ready-made tasks

Start from a task that is already set up, then change the keyword to your product:

• Find 1688 suppliers for phone cases
• Get 1688 Bluetooth earphone listings with supplier ratings
• Compare wholesale prices of LED strip lights on 1688
• Get 1688 kitchen gadget offers with supplier ratings
• Find 1688 wholesale suppliers for women's dresses
• Compare 1688 wholesale prices of insulated water bottles
• Find car accessories suppliers on 1688
• Find 1688 suppliers for yoga and gym wear
• Find 1688 suppliers for phone holders and stands
• Find 1688 wholesale suppliers for earrings

Watch offers or a keyword for changes

Put a name in Watch list name and run the actor on a schedule, for example every day. The first run returns everything, marked "change": "new". Every later run with the same name returns only:

• what is new: an offer that came into a keyword's results, an offer you added;
• what changed since the last run: for an offer its title, lowest or highest price or state, for a search result its title or price ("change": "changed", with changed_fields and the old values in previous).

Rows that did not change are not stored and not charged, so a daily check costs only what changed. The Changes view of the output shows these rows. The actor keeps the watch list in a key-value store of your account named watch-1688-...; use one name per list, and one run of it at a time. An offer that leaves a keyword's results is not reported: on 1688 that usually means it moved down, not that it is gone. A row that no run with this name has seen for 90 days leaves the list; if it comes back, it is new again.

{
    "keywords": ["手机壳"],
    "maxPagesPerKeyword": 3,
    "watchName": "phone cases"
}

How much does it cost to scrape 1688?

You pay for the rows the actor stores. The price per 1,000 rows depends on your Apify plan:

What	Free	Starter	Scale	Business
An offer row	$3.00	$2.70	$2.40	$2.00
A search result row	$0.50	$0.45	$0.40	$0.35
An English title (add-on, per row that gets one)	$0.10	$0.10	$0.10	$0.10

The examples below are at the Free plan price.

• 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.
watchName	A watch list's name: each run stores only what is new or changed since the last run with the same name. Empty: every row.
translateTitles	Adds title_en, an English machine translation of each title. Charged per row that gets one; off 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.
• 1688 refuses search at times. For a while it answers every visitor who is not logged in with its check, mostly on search. The actor then waits and tries again (see the FAQ); if the check lasts longer than a few minutes, start the run again later.

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 and each keyword 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.

When 1688 answers with its check, the run does not press on: it waits 5 seconds, then reads one offer or keyword at a time, and waits longer after each one that is refused (10, 20, 40, 60 seconds). As soon as one gets through, it reads at full pace again. If the check is still there after about three minutes, the run stops and keeps what it stored, and its status message says what was not read; it is marked as failed only when it stored nothing. Nothing is charged for what was not read. Start it again later with Resurrect and it goes on from where it stopped.

Are prices in US dollars? Can I get the titles in English?

Every price comes in CNY, as 1688 shows it, and also in US dollars (price_usd for a search result, price_min_usd and price_max_usd for an offer, price_usd in each price tier), worked out at the European Central Bank's reference rate of the day; usd_per_cny and usd_rate_date say which rate. Turn on English titles to get title_en, a machine translation of each title; it is charged per row that gets one, and a row without one is not charged for it.

Do 1688 prices include export packaging, an invoice and shipping?

No. 1688 prices are domestic wholesale prices, without export packaging, an export invoice or the trip to your forwarder, so ask the supplier about them before you compare. The full offer row helps you ask: cross_border_services lists what the supplier offers for export (such as FBA labels, box marks, foreign-language packaging), guarantees shows promises such as "极速开票" (fast invoicing), sku_packages gives the weight and size of each variant for a freight estimate, ships_from the city, and has_free_sample whether a free sample is offered. Order samples from your best two or three suppliers before a large order.

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.