1688 Global Product Search Scraper

Search 1688 Global products and rankings, enrich product details, and collect supplier contacts and company profiles. Global search/ranking titles and prices are validated as English/USD. Supplier legal names may be Chinese. Direct domestic details retain Chinese text and CNY prices, never relabelled as USD.

maxResults is the most product or supplier rows collected for each keyword, offer ID, or supplier member ID. The default is 70; larger requests are collected in parts of 70. All row types count together, and the whole run stops at your maximum total charge.

Collection modes

Mode	Input	Output
search (default through auto)	keyword (any language), maxResults, maxPages	Product cards, USD prices, supplier IDs, images, MOQ, repurchase rate and shipping signals when shown
ranking	rankingName: Most_Popular, New_Arrivals, Trending, or Ranked_by_L30_Days_Total_Orders; categoryId, categoryLevel, countryCode	Product rank, monthly sales/growth/collects, rating and release text when shown
detail	offerIds or HTTPS startUrls on detail.1688.com	Product title, SKU prices/inventory, properties, packaging, images/video, shipping, aggregate ratings and description
supplier	memberIds (b2b-…)	Company profile and merchant-published contacts, address, coordinates and Wangwang identity

auto infers direct modes from IDs/URLs even when the platform supplies a default keyword. Ranked_by_L30_Days_Total_Orders selects the near-30-day-orders ranking tab; an invalid or unrecognized rankingName falls back to the page default and is recorded in diagnostics. countryCode filters the ranking; it does not change the proxy exit country.

includeDetails defaults to true with one detail attempt. includeLeads follows it unless set explicitly; maxLeadItems controls supplier enrichment separately. Duplicate suppliers are fetched once per run. includeDescription retrieves the source-linked description text/images. Optional includeContactInfo attempts landline/fax from an observed shop URL and may be challenged. No contact value is guaranteed.

Search USD prices remain unchanged during enrichment; domestic values are under detailPriceCurrency, detailPriceModel, priceLadder and skuInfoMap. A supplier-only row has recordType=supplier, supplierMemberId and company name, not a fabricated offer ID. detailStatus, detailMissingGroups, leadStatus, companyStatus, contactInfoStatus and leadAbsences describe unavailable fields. RUN_SUMMARY.diagnostics includes extracted/dropped counts, session health and challenge classification.

Domestic login-only search, purchases, private buyer quotations/RFQs and pallet workflows are not supported. This Actor does not submit forms or log in. When a detail page shows the "slide to verify" check, the worker slides it at most a few times per run; pages still gated are reported as gated. Long-term availability is not guaranteed by a smoke run.

Architecture: thin Apify Actor → control plane → alibaba-1688-com worker on ns515786 → fleet browser scheduler.

WORKER_BASE_URL stays at https://worker.opendata.best/b/alibaba-1688-com; the control plane owns the private worker route and its authentication.

Type a product keyword, click Start, and download a structured product table for sourcing, catalog research, price monitoring, or an AI workflow.

What you can do with it

1. Find products to source

Search a product category such as phone case, women dress, or home storage and compare offers before opening supplier conversations.

You only fill in the keyword and how many verified listings you want:

Field	What to enter
keyword	A product phrase in any language (translated to English before the search)
maxResults	Number of rows to save for each keyword or ID
maxPages	Search pages to inspect

The result is a clean, exportable table with a product ID, English title, supplier, USD price, images, sales text, and direct listing link.

2. Compare wholesale price signals

Each saved row includes the USD price evidence shown by the 1688 Global search surface. The raw CNY reference price is retained separately when present; it is never relabelled as USD.

This makes it practical to sort a spreadsheet by price, inspect image counts, and shortlist offers without manually converting each product card.

3. Build a supplier shortlist

The search card can include supplier name, supplier identifiers, supplier tenure text, star level, supplier-tag asset, and sales text.

These are search-list signals. Enable supplier enrichment or use supplier mode for merchant-published contact/company fields. Missing contacts stay missing rather than being inferred from unrelated numbers.

4. Monitor a category

Run the same keyword on a schedule and compare the exported tables over time. Each row includes the keyword, requested page, position, source endpoint, and capture timestamp, so downstream systems can retain provenance.

5. Feed an AI or automation workflow

Download CSV, JSON, or Excel from Apify, or send the Dataset to Make, n8n, Zapier, Python, or an MCP-enabled agent. The row contract is structured enough for filters such as “USD price below $10” or “supplier has 5 images”.

More Actors like this

Need another marketplace or a different vertical? Use a dedicated Actor below for structured fields. Use this Actor for 1688 Global English product search with USD price evidence.

Similar e-commerce scrapers

• Shopee Search Scraper
• Lazada Scraper
• Amazon Search Scraper
• SHEIN Product Scraper
• Temu Product Scraper
• MercadoLibre Scraper
• Allegro Scraper
• Walmart Product Scraper
• Etsy Scraper
• Mercari Japan Scraper
• Rakuten Japan Scraper
• Coupang Product Scraper
• Cdiscount Product Scraper

Prefer another specialized scraper?

If your target has a specialized Actor below, use that first — usually cheaper and more structured than a generic scrape.

Jobs & Freelance

• LinkedIn Jobs Scraper
• Indeed Jobs Scraper
• Upwork Jobs Scraper
• Glassdoor Scraper
• Fiverr Gigs Scraper
• Bayt Jobs Scraper

Real Estate

• Zillow & Zumper Scraper
• Realtor.com Scraper
• Apartments.com Rental Scraper
• Rightmove Scraper
• Idealista Scraper
• realestate.com.au Scraper

Travel & Stays

• Booking.com Hotels Scraper
• Airbnb Listings Scraper
• Expedia Scraper
• TripAdvisor Scraper

Social & Content

• YouTube Research Scraper
• TikTok Scraper
• Reddit Scraper
• YouTube Shorts Scraper

Ads Intelligence

• Facebook Ad Library Scraper
• TikTok Ads Scraper

Local & Maps

• Google Maps Scraper

General Tools

• Stealth Web Scraper
• Email Risk Validator
• Phone Number Intelligence

→ See the full catalog in Related Actors below, or browse apify.com/lentic_clockss.

---

How to use — no code required

1. Click Try for free.
2. Enter a keyword in any language. Non-English text is translated to English before the search.
3. Keep the default US surface setting; the worker manages egress.
4. Set a small maxResults value for a first run.
5. Click Start and open the Dataset when the run finishes.

That is the full workflow: search, wait, download. Start with the prefilled three rows to verify the product category, then increase the per-input output cap.

Free Apify plan limits (set by this Actor's developer)

Limit	Free Apify plan	Paid Apify plan
Runs of this Actor	10 runs total	Unlimited
Rows per run	Up to 200	Stops at your maximum total charge

These caps are enforced by the Actor developer (not Apify platform errors). When you hit the 10-run limit, the run finishes gracefully with a clear status message asking you to upgrade.

What you get back

Every emitted row has passed the Actor’s English/USD acceptance contract. Core fields include:

• offerId — stable 1688 offer identifier.
• title and sellerName — English product and supplier text from the accepted search result.
• priceMin, priceText, and priceCurrency — verified USD pricing evidence.
• priceInCny and cnyToUsdRate — separate source/reference evidence when supplied; never a relabelled price.
• mainImage, galleryImages, and imageCount — images shown by the search result.
• salesText, starLevel, supplierYearsText, and sellingPoints — available card-level commercial signals.
• supplierLoginId, supplierMemberId, and supplierTagAssetUrl — supplier identifiers/assets exposed by the search result.
• page, position, keyword, and capturedAt — row provenance.

The Actor also writes INPUT_ECHO, RUN_SUMMARY, and redacted NETWORK_DIAGNOSTICS to the default key-value store. These let you audit whether a run used the verified Global-search path without storing cookies, tokens, signatures, or raw browser traffic.

Supplier lead fields (供应商线索)

Every emitted item carries a supplier lead block. includeLeads requests the supplier contact and company modules using the observed member ID. Search-only rows retain card-level organization signals. The legacy shop module remains a fallback; contact-page navigation is optional.

Field	Type	Meaning
phones	[{value, type, e164?}]	Merchant-published mobile/landline from contact modules or the optional contact page; not guaranteed for every supplier.
emails	[{value, type}]	Contact email. Every measured 1688 surface (search card, detail page, shop page) exposes none → always [] with leadAbsences.emails=本站无.
address	{street, unit, locality, region, postalCode, country, full}	Vendor registered address from the shop unifiedRenderData payload (detailAddress / addr.entAddress). unit = 门牌 (street number), e.g. sample measured 广东省佛山市南海区里水镇宏岗村沥口东队东兴路12号 → unit 东兴路12号.
geo	{lat, lng}	Validated supplier coordinates from memberLbs; absent values remain null.
person	{name, gender?}	Merchant-published contact name and gender when returned.
org	{name, id, memberId, sellerLoginId}	Supplier legal name and observed IDs; legal names may be Chinese.
web	{website, socials[]}	Shop URL and social/IM channels. Social channel on 1688 = Wangwang IM, link pattern touid=cnalichn{sellerLoginId} (verified). Third-party socials: 本站无.
leadSource	search|detail|entity|contact|reveal-xhr	Which surface produced the lead block (search for card-only rows, detail/entity once the shop chain is captured).
leadReveal	visible|click|xhr|gated|image|absent	Reveal mechanism. 1688 exposes no click-reveal controls anywhere; leads that load are visible, the rest map to a reason below.
leadAbsences	object	Per-subfield absence reason, always explicit: 本站无 (measured surfaces truly lack it) / 闸门锁 (gated behind login/slider) / 未验证 (not verified this run). A row is never title/price/ID-only.
supplierOffers	[string]	Offer IDs from the supplier storefront grid (mobile shop showcase), capped per supplier. Detail URLs derive as https://detail.1688.com/offer/{id}.html. offerlistStatus reports the fetch outcome.

Reveal cost

• No click-reveal cost. 1688 has no "show phone/email" controls on any measured surface, so the Actor performs no per-row reveal clicks or reveal XHRs.
• Supplier cost: contact and company module requests are bounded by maxLeadItems, with one fetch per unique supplier. Optional contact-page visits cost additional time.
• Upstream limits: challenge and partial-result statuses are preserved. A retry is not guaranteed to succeed.

Honest limitations

• Details and contacts remain best-effort. Individual requests can hit login, punish or slider gates; the worker slides a limited number of sliders per run. Rows that stay gated never get fabricated fields.
• Phones are per-shop, not site-guaranteed. Empty merchant contact fields stay empty.
• No emails exist on any measured 1688 surface (本站无); no third-party socials — the social channel is Wangwang IM only.
• Postal codes are not established by the measured contact module. Coordinates and named contacts are returned when present.

Pricing

Pay only when the Actor starts and when it returns a Dataset item. No subscription. Platform usage costs are paid by the Actor owner, so the event prices below are the prices you see.

Event	Price
Actor start	$0.005 per GB of allocated Actor memory (minimum one event)
Verified result	$3.00 per 1,000 Dataset items ($0.003 each)

The result charge is linear: no output items means no result-item charge. The Actor charges the platform dataset event after a successful write (apify-default-dataset-item, with a legacy fallback). Charge failures are logged and do not erase already-written Dataset rows.

The start event is counted by Apify from allocated memory; for example, a 4 GB run starts at $0.020, then adds $0.003 for each verified Dataset item.

Free Apify plan: up to 10 runs of this Actor and 200 rows per run. Upgrade to a paid Apify plan for unlimited runs. (Limits set by the Actor developer.)

Zero verified listings

If the Global search API returns a validated English/USD empty page, the run finishes as SUCCEEDED with resultStatus=VALID_ZERO_RESULTS, an empty Dataset, and no result charge. Check RUN_SUMMARY.zeroResultNote.

Connect to your tools

Use Actor ID lentic_clockss/1688-global-scraper in the Apify integration for Make, n8n, Zapier, or your own code. For AI-agent workflows, the Actor can be discovered through the Apify MCP server.

When to use something else

If you need...	This Actor is not the right current path
Guaranteed complete details on every product	Detail mode extracts available groups but reports gaps and challenges; it cannot guarantee every field.
Chinese domestic-market search results	This Actor is intentionally limited to the 1688 Global English/USD search surface.
Guaranteed live shipping quotes or supplier verification	Search-card signals are not a substitute for supplier due diligence.

Input reference

Parameter	Default	Description
keyword	phone case	Product keyword in any language; searched in English.
maxResults	70	Maximum rows for each keyword, offer ID, or supplier member ID (1–100). Values above 70 are collected in parts of 70. Store Test uses the prefill of 3. All row types count together; the run stops at your maximum total charge. Free plan: 200 rows per run and 10 total runs.
maxPages	1	Search pages to observe (1–5).
useApifyProxy	true	Legacy compatibility flag; egress is worker-managed.
proxyCountry	US	Residential proxy country currently supported by this Actor.
includeDetails	true	Best-effort structured product details. Supplier enrichment is independently controlled by includeLeads.
maxDetailItems	1	When details are enabled, how many rows to open (defaults to 1 if omitted).

FAQ

Why is a result missing? The Actor rejects a response if the observed Global-search payload does not prove the requested keyword, English language, USD currency, numeric offer ID, English text, and USD price evidence.

Can I search in Chinese? Yes. Keywords in any language (Chinese, Korean, Japanese, …) are translated to English before the search, because the 1688 Global surface only answers English queries. The run log shows the text that was searched. Results stay English/USD.

I'm on the free Apify plan — are there limits? Yes. Free Apify plan users get 10 runs of this Actor and up to 200 rows per run. These limits are set by the Actor developer (not Apify). When you hit the run cap, the run finishes with a clear status message — it is not a platform bug.

Why are detail fields limited? Products differ in published fields, and some requests trigger challenges. Check detailMissingGroups, per-source statuses and leadAbsences. A cookie or proxy does not guarantee access.

Can I schedule it? Yes. Create an Apify schedule with the same input and send the Dataset to your preferred automation.

---

Related Actors

All 77 public Actors from [lentic_clockss]. Click a name to open the Store detail page.

Jobs & Freelance

• LinkedIn Jobs Scraper
• Bayt Jobs Scraper
• Fiverr Gigs Scraper
• Freelancer.com Scraper
• Glassdoor Scraper
• Himalayas Jobs Scraper
• Indeed Jobs Scraper
• Jobicy Remote Jobs Scraper
• RemoteOK Jobs Scraper
• SEEK Jobs Scraper
• Upwork Jobs Scraper

Real Estate

• Zillow & Zumper Scraper
• Realtor.com Scraper
• 99.co Scraper
• Realtor.com Agents Scraper
• Apartments.com Rental Scraper
• Bayut Scraper
• Craigslist Housing Scraper
• Daft.ie Scraper
• Dot Property Scraper
• FINN.no Scraper
• Funda Scraper
• Hepsiemlak Scraper
• Idealista Scraper
• Immobiliare.it Scraper
• ImmoScout24 Scraper
• Naver Land Scraper
• OpenSooq Scraper
• Otodom Scraper
• Property Finder Scraper
• PropertyGuru Scraper
• realestate.com.au Scraper
• Realtor.ca Scraper
• Rightmove Scraper
• SeLoger Scraper
• SUUMO Scraper
• Zillow Group Scraper

E-commerce

• Shopee Search Scraper
• E-commerce Scraper
• 1688 Global Product Search Scraper
• Allegro Scraper
• Amazon Search Scraper
• ASOS Product Scraper
• Cdiscount Product Scraper
• Costco Product Scraper
• Coupang Product Scraper
• Etsy Scraper
• Lazada Scraper
• MercadoLibre Scraper
• Mercari Japan Scraper
• Rakuten Japan Scraper
• SHEIN Product Scraper
• Target Product Scraper
• Temu Product Scraper
• Walmart Product Scraper

Travel & Stays

• Booking.com & Airbnb Scraper
• Agoda Scraper
• Airbnb Listings Scraper
• Booking.com Hotels Scraper
• Despegar Scraper
• Expedia Scraper
• Traveloka Scraper
• Travelstart Flights Scraper
• Trip.com Scraper
• TripAdvisor Scraper

Social & Content

• TikTok Scraper
• Reddit Scraper
• YouTube Shorts Scraper
• YouTube Research Scraper
• Hacker News Scraper

Ads Intelligence

• Facebook Ad Library Scraper
• Google Ads Transparency VN
• TikTok Ads Scraper

Local & Maps

• Google Maps Scraper

General Tools

• Stealth Web Scraper
• Email Risk Validator
• Phone Number Intelligence

→ Browse the full profile: apify.com/lentic_clockss