1688 Global Product Search Scraper

Find export-ready 1688 products with English titles, English supplier names, and USD price evidence — in one search. Instead of handing you a mixed-language catalog or relabelled CNY prices, this Actor keeps only search results that prove the requested English/USD context.

Architecture: thin Apify Actor → alibaba-1688-com Cloud Run worker (HTTPS + API key).
Worker URL is config (WORKER_BASE_URL), not hardcoded-only — migrate the worker by updating Actor env without a code change. Set WORKER_PROVIDES_PROXY=1 when the worker supplies its own PROXY_URL.

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	An English product phrase
maxResults	Number of listings to save
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, not a claim that the Actor has collected a complete supplier profile. Use them to prioritize which offers deserve a manual follow-up.

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 an English keyword.
3. Keep Use Apify Residential Proxy enabled and choose US.
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 one result to verify the product category, then increase the 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
Listings per run (maxResults)	Up to 100	Up to 100

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 (供应商线索)

Beyond product rows, every emitted item carries a supplier lead block — the core added value for sourcing workflows. includeDetails defaults to on: the run opens the CN canonical detail page, discovers the supplier shop, and captures the shop page's own unifiedRenderData render response for supplier lead fields (phones / emails / address 门牌 / org / Wangwang). Search-only rows carry org-level signals; the full block comes from the shop surface.

Field	Type	Meaning
phones	[{value, type, e164?}]	Supplier phone, plain text inside the shop's self-decorated contact module only (no tel: link, no reveal XHR). Shops without that module are marked 未验证 (not verified) — never claimed as "site has none" and never invented.
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}	Coordinates. Not exposed on any measured surface → null with leadAbsences.geo=未验证.
person	{name, role?}	Named contact person. Not available to guest sessions; the shop contactinfo subpage is protected by an AWSC slider → marked 未验证 / 闸门锁.
org	{name, id, memberId, sellerLoginId}	Supplier organization: company full English name (verified non-empty on every row), company/member IDs, and seller login ID (e.g. b2b-… memberId, sellerLoginId).
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.

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.
• Shop-lead cost: shop lead fields require the detail→shop chain (includeDetails=true, default on). The run opens up to maxDetailItems (default 1) detail pages, follows the shop link, and intercepts the shop page's own unifiedRenderData response — seconds per detail item, normal residential-proxy traffic, no extra platform events.
• Upstream jitter: the Global EN/USD MTop SSE frame capture intermittently fails with a transient 422 (No validated English/USD result page was captured) in roughly 1/3–1/2 of attempts. Simply retrying the run succeeds — this is upstream search-service jitter, not a rate limit and not data loss.

Honest limitations

• CN detail/shop gating under the current US-egress sessions (measured 2026-08-30): anonymous automation sessions with a US egress get redirected to login.taobao.com on detail deep-links and hit an AWSC (nocaptcha slider) interstitial on shop pages; the shop unifiedRenderData API is same-origin only. CN-egress sessions are not currently available → in today's runs phones, address, web.website/socials are honestly marked 闸门锁 (gated) instead of populated. org (company full name + member IDs) is verified non-empty on every row. The extraction path for the full shop lead block is implemented and parse-tested — once a CN egress session is available, re-running the same input emits the complete block (verified shop sample: full address with 门牌, self-decorated phone module, b2b-… memberId, seller login ID, Wangwang IM link).
• Phones are per-shop, not site-guaranteed. The phone lives only in a supplier's self-decorated shop module; shops without that module are marked 未验证, and search/detail surfaces show no phone at all (本站无).
• No emails exist on any measured 1688 surface (本站无); no third-party socials — the social channel is Wangwang IM only.
• No coordinates (geo) and no postal codes are exposed (未验证).
• No named contact person for guest sessions; the shop contactinfo subpage is slider-gated (闸门锁).

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 100 listings 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
SKU-level inventory, product descriptions, price ladders, or full specifications	Detail access is not yet a stable anonymous capability; use a verified detail-data provider or manually validate shortlisted offers.
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	English product keyword.
maxResults	1	Maximum verified English/USD listings to save (1–100). Store Test uses 1. Free plan: also 10 total runs of this Actor.
maxPages	1	Search pages to observe (1–5).
useApifyProxy	true	Uses Apify RESIDENTIAL unless Actor env WORKER_PROVIDES_PROXY=1.
proxyCountry	US	Residential proxy country currently supported by this Actor.
includeDetails	true	Default on: best-effort detail navigation plus supplier lead enrichment (detail → shop discovery → unifiedRenderData capture for org/address/phones/Wangwang). Detail-page content itself remains best-effort; not SKU/attrs/price-ladder extraction.
maxDetailItems	1	When details are enabled, how many rows to open (defaults to 1 if omitted).
workerBaseUrl	(env)	Optional per-run override of the Cloud Run worker origin. Default: Actor env WORKER_BASE_URL.

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? The product contract is English/USD search-list output. Use English keywords for this Actor.

I'm on the free Apify plan — are there limits? Yes. Free Apify plan users get 10 runs of this Actor and up to 100 listings 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? 1688 detail pages redirect anonymous automation sessions (US egress) to a login flow, and supplier shop pages are protected by an AWSC slider. The Actor records those boundaries in detailStatus / leadAbsences honestly rather than inventing data; supplier org fields are still captured on every row, and the full shop lead block activates once a CN-egress session is available.

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