1688 Global Scraper & API: Wholesale & Arbitrage 🌐
Pricing
from $0.90 / 1,000 search / ranking product listing (summary)s
1688 Global Scraper & API: Wholesale & Arbitrage 🌐
⚡ Fast & Cheap ($1.50/1k): Scrape 1688 Global English search, Amazon & TikTok best-seller rankings, MOQ & SKU prices. Filter AliTrading suppliers by CE/FCC/RoHS certifications, 24h/48h dropshipping, Super Factory, unit weights & multi-currency margins. Zero login, MCP & AI ready.
Pricing
from $0.90 / 1,000 search / ranking product listing (summary)s
Rating
0.0
(0)
Developer
UnitBytes | Enterprise Web Data
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
an hour ago
Last modified
Categories
Features
Share
🌐 1688 Global Scraper & Arbitrage API: Cross-Border Wholesale, Rankings & SKU Matrix (AliTrading)
📸 Want to search 1688 by product photo instead of keywords (
以图搜款 / 拍立淘), or monitor domestic 1688 factories? Use our dedicated 1688 Reverse Image Search (Photo-to-Factory) Scraper to find the original Chinese manufacturer from any Amazon, TikTok Shop, or Shopify photo, or pair with our Google Shopping Trends Scraper to spot+5,000%breakout product demand before sourcing!
| ⚡ UnitBytes · B2B Sourcing, E-Commerce Demand & Global Lead Intelligence Ecosystem | ||
|
🌐 1688 Global & Arbitrage 📍 You are here English search, CE/FCC/RoHS filters, Amazon/TikTok margins & 15 currencies |
🇨🇳 1688 Factory Direct Domestic Wholesale & Monitor Direct China factory prices, SKU matrices & Amazon FBA carton specs |
📸 1688 Reverse Image Search ✨ Photo-to-Factory (以图搜款) Upload any product photo or URL to find the exact 1688 factory |
|
🏭 Alibaba Wholesale Suite Global B2B, Suppliers & Stores Products, Factory Audits & Store Catalogs |
🛍️ Taobao & Tmall Suite Retail, Reviews & Seller Shops Consumer trends, 3-axis DSR & Shop Catalogs (淘宝店铺) |
🐟 Goofish (Xianyu / 闲鱼) Suite C2C Resale, Sellers & Reviews Fast search deals, Seller Storefronts & Buyer Reviews |
|
📈 Google Shopping Trends 🔥 Breakout Product Demand Spot +5,000% surging products & top buying regions ($0.30/1K) |
📊 Google Trends All-in-One 5-Surface Search Intelligence Trending Now, YouTube Trends & Fast API |
📕 Xiaohongshu (RedNote / 小红书) Viral Consumer Trends & KOLs Trending Notes, KOL Leads & Live Commerce |
|
📍 Google Maps Email & Leads B2B Contacts & Tech Stack Verified emails, phones, social links & Local Guides ($0.50/1K) |
💬 Google Maps Reviews & Photos 10K Reviews, Menus & ORM All 10K reviews ($0.25/1K), HD Photos & Menus ($0.20/1K) & Review Tracker |
🇰🇷 Naver Place & Map (네이버) Korean B2B Leads, Menus & Reviews Naver Place leads, Visitor/Blog Reviews ($0.50/1K) & Naver Map ($1/1K) |
🚀 Why Scrape 1688 Global (air.1688.com) vs. Domestic 1688?
While domestic 1688 targets Mainland Chinese buyers in Mandarin and CNY only, 1688 Global (AliTrading) is Alibaba Group's dedicated cross-border wholesale portal engineered specifically for international sourcing and export:
| Capability | 1688 Global Scraper (1688-global-scraper) | Domestic 1688 Catalog |
|---|---|---|
| Product Titles & Taxonomy | Dual English (title) + Chinese (titleCn) titles & English category names | Chinese titles only |
| Wholesale Pricing & Currencies | 15 Global Currencies (USD, EUR, GBP, JPY, AUD, CAD, SGD, MYR, THB, VND, IDR, PHP, KRW, HKD) + native CNY | CNY (¥) only |
| Export Compliance Certifications | Server-side filtering for CE, FCC, RoHS, UL, MSDS, CPC, TÜV PCoC, UKCA, CB, KC, FSC certified factories | Not indexed by international export certificates |
| Amazon & TikTok Arbitrage Leaderboards | 9 Global Markets (JP:amazon, JP:tiktok, ID/VN/MY/TH/PH/SG:tiktok, CN:cbu) with downstream retail price (platformRetailPriceUsd) & gross margin (grossMarginPct) | Domestic China leaderboards only |
| Cross-Border Localisation Filters | Filter suppliers by Foreign-Language Retail Packaging, Multilingual Manuals, & Custom Carton Shipping Marks | Domestic packaging only |
| 1-Piece Dropshipping & SLA Filters | Native filters for 1-Piece Dropshipping, 24-Hour Dispatch, 48-Hour Dispatch, & Calibrated FBA Weight/Dimensions | Standard domestic wholesale filters |
| Full SKU Matrix & Logistics | Complete color/size SKU matrix, live variant stock, quantity price tiers, and per-unit weight (unitWeightKg) | Domestic SKU & freight metadata |
✨ Core Capabilities
1. 🔍 English & Multilingual Keyword Search + Cross-Border Filters (search mode)
Search 1688 Global using English or multilingual keywords (e.g., "wireless earbuds", "Shoes", "Digital, Computer", "portable blender") or paste any 1688 Global search URL directly from your browser. Every filter executes server-side so 100% of returned items match your sourcing criteria:
- Hot Select Verification Badges (
hotSelect): Restrict results toglobal_trade_verified(Global Trade Verified),global_trade_choice(Global Trade Choice),super_factory(Alibaba Verified Super Factories),certified_merchant(Audited Enterprise Merchants), orprecise_weight_dimensions(Calibrated Weight & Dimensions for FBA/Air Freight). - Export Compliance Certifications (
certification/certifications): Filter strictly for manufacturers holding verifiedCE,RoHS,FCC,MSDS,UL,CPC,TUV_PCoC,UKCA,CB,KC, orFSCtesting certificates. Combine single or multiple certificates in one query. - Shipping Speed & Dropshipping (
shippingFilter): Targetdropshipping(1-Piece Cross-Border Dropshipping),shipping_24h(24-Hour Fast Dispatch), orshipping_48h(48-Hour Fast Dispatch). - Export Localisation (
localisationService): Filter for factories providingshipping_mark(Custom Outer Carton Shipping Marks),local_packaging(Foreign-Language Retail Packaging), orlocal_manuals(Foreign-Language User Manuals). - Supplier Tenure (
sellerTenure): Filter for veteran manufacturers operating on 1688 forover_5_years,over_7_years, orover_10_years. - MOQ, Price Bounds & Sorting (
maxMoq,priceMin,priceMax,sortBy): Cap minimum order quantity (quantityBegin), bracket unit prices, and sort by 360-day order volume (va_sales360), lowest price (price_asc), highest price (price_desc), or relevance (normal).
2. 📈 9-Market Amazon & TikTok Shop Arbitrage Rankings (ranking mode)
Extract official 1688 Global cross-border leaderboards across 3 ranking tabs (TRENDING, Most_Popular, New_Arrivals), 9 international markets, and 50+ Level-1/Level-2 product categories:
- Downstream Retail vs. 1688 Factory Price Spread: For Amazon Japan (
JP:amazon) and TikTok Shop (JP:tiktok,ID:tiktok,VN:tiktok,MY:tiktok,TH:tiktok,PH:tiktok,SG:tiktok), each record includes the downstream retail selling price (platformRetailPriceUsdand nativeplatformOriginalPrice), the 1688 factory wholesale price (localPrice,priceCny), and the pre-calculated Gross Arbitrage Margin in both dollars (grossMarginUsd) and percentage (grossMarginPct). - Velocity & Competition Signals: Captures 30-day sales volume (
salesVolume), month-over-month order growth rate (momGrowthRate, e.g.,"1000+%"), release timing (releaseDateInfo), and the exact count of competing 1688 factories manufacturing the same product (matchedSuppliersCount).
3. 📦 Full SKU Matrix, Volume Price Tiers & Logistics Enrichment (detailLevel: "full" & direct_offer mode)
When detailLevel is set to "full" (default) or when passing direct 1688 Offer IDs (offerIds):
- Complete SKU Variant Matrix (
skus&skuProps): Extracts every purchasable color, size, plug standard, or specification variant with its individualskuId,specId,specAttributes,priceCny, convertedlocalPrice, live factory inventory (stock), variant sales count (salesCount), and high-resolution swatch image (imageUrl). - Wholesale Quantity Price Brackets (
priceTiers): Full multi-tier bulk pricing schedule (e.g.,2+ pcs,100+ pcs,1,000+ pcs) in bothCNYand your selectedcurrency. - Cross-Border Logistics & Unit Weight (
logistics): Extracts physical per-unit weight in kilograms (unitWeightKg), factory dispatch city/province (shippingOrigin), domestic Chinese freight fee (domesticDeliveryFeeCny), free domestic shipping status, and fulfillment SLA notes. - Manufacturer Due Diligence (
seller&crossBorderFlags): Dual English/Chinese company names, Super Factory certification (isSuperFactory), factory vs. trader classification (sellerType), years on 1688 (yearsOn1688), repeat buyer repurchase rate (repurchaseRate), cross-border supply status (isCrossBorderSupply), and 1-piece dropshipping support (supportsDropshipping).
⚙️ Complete Input Parameters Reference
| Parameter | Type | Default | Description |
|---|---|---|---|
mode | string | "auto" | Execution mode: "auto" (auto-detects keywords, search URLs, ranking URLs, or offer IDs), "search" (keyword search + filters), "ranking" (cross-border leaderboards), or "direct_offer" (Offer IDs / product URLs only). |
queries | array | ["Shoes"] | List of English/multilingual keywords, 1688 Global Ranking URLs, 1688 Global Search URLs, or numeric 1688 Offer IDs. |
keyword | string | "" | Optional single search keyword, ranking URL, search URL, or numeric 1688 Offer ID. |
offerIds | array | [] | Optional list of numeric 1688 Offer IDs (8–16 digits) for direct full-detail extraction and price/stock monitoring. |
startUrls | array | [] | Optional list of 1688 Global Ranking URLs, Search URLs, or Product Detail URLs. |
maxItems | integer | 30 | Maximum number of products to extract per query or ranking feed (1 to 5000). |
detailLevel | string | "full" | "full" (enriches every product with SKU matrix, tiered pricing, stock, unit weight, and factory badges) or "summary" (fast search/ranking cards only). |
currency | string | "USD" | Target display currency: USD, CNY, EUR, GBP, JPY, AUD, CAD, SGD, MYR, THB, VND, IDR, PHP, KRW, or HKD. |
sortBy | string | "normal" | Search sort order: "normal" (relevance), "va_sales360" (highest 360-day orders; aliases: "sales", "booked"), "price_asc" (lowest price; alias: "priceAsc"), or "price_desc" (highest price; alias: "priceDesc"). |
hotSelect | string | "" | Supplier/offer badge filter: "", "global_trade_verified", "global_trade_choice", "super_factory", "certified_merchant", or "precise_weight_dimensions". |
shippingFilter | string | "" | Fulfillment filter: "", "dropshipping" (1-Piece Dropshipping), "shipping_24h" (24h Dispatch), or "shipping_48h" (48h Dispatch). |
sellerTenure | string | "" | Supplier operating history on 1688: "", "over_5_years", "over_7_years", or "over_10_years". |
localisationService | string | "" | Export packaging filter: "", "shipping_mark" (Custom Carton Mark), "local_packaging" (Local Language Packaging), or "local_manuals" (Local Language Manuals). |
certification | string | "" | Single export compliance certificate filter: "", "CE", "RoHS", "FCC", "MSDS", "UL", "CPC", "TUV_PCoC", "UKCA", "CB", "KC", or "FSC". |
certifications | array | [] | Combine multiple export certificates in a single search (e.g., ["CE", "FCC", "RoHS"]). |
maxMoq | integer | — | Maximum starting Minimum Order Quantity filter (e.g., 1, 2, 10, 50). |
priceMin | string | "" | Minimum unit wholesale price in selected currency (e.g., "1.5" or "10"). |
priceMax | string | "" | Maximum unit wholesale price in selected currency (e.g., "25" or "100"). |
rankingType | string | "TRENDING" | Ranking leaderboard tab: "TRENDING" (Hot-Rising L30D Growth), "Most_Popular" (Sourcing Top Deals by L30D Orders), or "New_Arrivals" (Hot New Releases). |
rankingMarket | string | "CN:cbu" | Target country & platform for rankings: "CN:cbu", "JP:amazon", "JP:tiktok", "ID:tiktok", "VN:tiktok", "MY:tiktok", "TH:tiktok", "PH:tiktok", or "SG:tiktok". |
rankingCategory | string | "" | Ranking category preset ("" or "auto" auto-selects the market's default category, or choose from 22 L1/L2 category presets). |
customCateId | string | "" | Optional numeric 1688 cateId (e.g., "1044181" for Crafts). Overrides rankingCategory. |
customCateLevel | integer | — | Category hierarchy level (1, 2, or 3) when using customCateId. |
resumptionToken | string | "" | Encrypted pagination checkpoint token from a previous run to resume extraction with zero duplicate items. |
proxyConfiguration | object | Residential | Apify Proxy configuration (Apify Residential proxy is recommended for reliable extraction). |
🛡️ Cross-Border Filter Reference Table (search Mode)
All cross-border filters are executed server-side on 1688 Global and can be combined freely in a single search run:
1. Product Qualifications & Export Certifications (certification / certifications)
| Input Value | Certificate Name | Primary Target Market & Compliance Scope |
|---|---|---|
"CE" | CE Marking (European Conformity) | European Economic Area (EEA) health, safety, and environmental protection |
"RoHS" | RoHS Directive Compliance | EU & global restriction of hazardous substances in electrical/electronic equipment |
"FCC" | FCC Declaration of Conformity | United States radio frequency, wireless, Bluetooth, and electronic devices |
"MSDS" | Material Safety Data Sheet | International air/sea freight safety documentation for batteries, liquids, and cosmetics |
"UL" | UL Safety Certification | North American (US & Canada) electrical, charger, and appliance safety standards |
"CPC" | Children's Product Certificate | US CPSC mandatory safety certification for toys, baby products, and children's apparel |
"TUV_PCoC" (or "TUV") | TÜV PCoC | Accredited TÜV product conformity testing and quality verification |
"UKCA" | UK Conformity Assessed | Great Britain (England, Wales, Scotland) mandatory product safety marking |
"CB" | IEC CB Scheme Certificate | International Electrotechnical Commission mutual recognition electrical safety |
"KC" | Korea Certification (KC Mark) | South Korea mandatory safety certification for electronics and consumer goods |
"FSC" | Forest Stewardship Council | Sustainably sourced wood, paper, packaging, and furniture certification |
2. Hot Select, Shipping, Tenure & Localisation Filters
| Parameter | Allowed Value | Description |
|---|---|---|
hotSelect | "global_trade_verified" | Products verified for international cross-border export standards |
hotSelect | "global_trade_choice" | Curated high-conversion cross-border best-sellers |
hotSelect | "super_factory" | Alibaba Verified Super Factories with audited large-scale production lines |
hotSelect | "certified_merchant" | Verified enterprise wholesale merchants with high fulfillment ratings |
hotSelect | "precise_weight_dimensions" | Products with factory-calibrated weight & dimensions for accurate FBA/freight quotes |
shippingFilter | "dropshipping" | Suppliers supporting 1-Piece Cross-Border Dropshipping orders |
shippingFilter | "shipping_24h" | Guaranteed factory dispatch within 24 hours |
shippingFilter | "shipping_48h" | Guaranteed factory dispatch within 48 hours |
sellerTenure | "over_5_years" | Established suppliers operating on 1688 for > 5 years |
sellerTenure | "over_7_years" | Established suppliers operating on 1688 for > 7 years |
sellerTenure | "over_10_years" | Veteran manufacturers operating on 1688 for > 10 years |
localisationService | "shipping_mark" | Factories supporting custom outer-carton shipping marks for FBA/3PL receiving |
localisationService | "local_packaging" | Products supplied with English / local-language retail box packaging |
localisationService | "local_manuals" | Products supplied with English / local-language printed user manuals |
🌍 Global Ranking Markets & Categories Reference (ranking Mode)
1. Target Markets & Downstream Platforms (rankingMarket)
rankingMarket | Country | Downstream Platform | Arbitrage Retail & Margin Fields Included? |
|---|---|---|---|
"CN:cbu" | China (CN) | 1688 Wholesale & Export (cbu) | 1688 factory wholesale prices (priceCny, localPrice), monthly sales & MoM growth |
"JP:amazon" | Japan (JP) | Amazon Japan (amazon) | Yes — platformRetailPriceUsd, platformOriginalPrice (JPY), grossMarginUsd, grossMarginPct, matchedSuppliersCount |
"JP:tiktok" | Japan (JP) | TikTok Shop Japan (tiktok) | Yes — Downstream TikTok Shop retail price & gross arbitrage margin |
"ID:tiktok" | Indonesia (ID) | TikTok Shop Indonesia (tiktok) | Yes — Downstream TikTok Shop retail price (IDR & USD) & gross arbitrage margin |
"VN:tiktok" | Vietnam (VN) | TikTok Shop Vietnam (tiktok) | Yes — Downstream TikTok Shop retail price (VND & USD) & gross arbitrage margin |
"MY:tiktok" | Malaysia (MY) | TikTok Shop Malaysia (tiktok) | Yes — Downstream TikTok Shop retail price (MYR & USD) & gross arbitrage margin |
"TH:tiktok" | Thailand (TH) | TikTok Shop Thailand (tiktok) | Yes — Downstream TikTok Shop retail price (THB & USD) & gross arbitrage margin |
"PH:tiktok" | Philippines (PH) | TikTok Shop Philippines (tiktok) | Yes — Downstream TikTok Shop retail price (PHP & USD) & gross arbitrage margin |
"SG:tiktok" | Singapore (SG) | TikTok Shop Singapore (tiktok) | Yes — Downstream TikTok Shop retail price (SGD & USD) & gross arbitrage margin |
2. Ranking Leaderboards (rankingType)
"TRENDING": Hot-Rising Trends — ranked by Last-30-Day (L30D) order volume growth rate (momGrowthRate)."Most_Popular": Sourcing Top Deals — ranked by highest L30D total wholesale and cross-border order volume (salesVolume)."New_Arrivals": Explore New Arrivals — newly launched factory products with breakout early traction (releaseDateInfo).
3. Built-In Category Presets (rankingCategory)
Leave rankingCategory as "" or "auto" to automatically resolve the top category for your selected rankingMarket, or pass any preset below (or any custom numeric cateId in customCateId):
rankingCategory Value | Category Name | Market Scope | Hierarchy Level |
|---|---|---|---|
"" or "auto" | Auto-Select Default Category for Market | All Markets (CN, JP, SEA) | Auto |
"54:1" | Clothing Accessories & Jewelry | 1688 Global (CN:cbu) | Level 1 |
"67:1" | Office & Culture | 1688 Global (CN:cbu) | Level 1 |
"1044181:2" | Crafts & Giftware | 1688 Global (CN:cbu) | Level 2 |
"18:1" | Sports & Outdoor | 1688 Global (CN:cbu) | Level 1 |
"1042954:1" | Luggage & Leather Goods | 1688 Global (CN:cbu) | Level 1 |
"10166:1" | Women's Clothing | 1688 Global (CN:cbu) | Level 1 |
"311:1" | Children's Clothing | 1688 Global (CN:cbu) | Level 1 |
"7:1" | Digital & Computer | 1688 Global (CN:cbu) | Level 1 |
"1038378:1" | Shoes & Footwear | 1688 Global (CN:cbu) | Level 1 |
"1813:1" | Toys & Hobbies | 1688 Global (CN:cbu) | Level 1 |
"97:1" | Beauty, Skincare & Makeup | 1688 Global (CN:cbu) | Level 1 |
"6:1" | Household Appliances | 1688 Global (CN:cbu) | Level 1 |
"58:1" | Lighting | 1688 Global (CN:cbu) | Level 1 |
"122916001:1" | Pets & Gardening | 1688 Global (CN:cbu) | Level 1 |
"122916002:1" | Automotive Supplies | 1688 Global (CN:cbu) | Level 1 |
"96:1" | Home Textile & Decoration | 1688 Global (CN:cbu) | Level 1 |
"59:1" | Hardware & Tools | 1688 Global (CN:cbu) | Level 1 |
"68:1" | Packaging Materials | 1688 Global (CN:cbu) | Level 1 |
"3210981:1" | Electronics (Amazon Japan) | Amazon Japan (JP:amazon) | Level 1 |
"605248:1" | Fashion Accessories (TikTok Shop) | TikTok Shop (JP / SEA) | Level 1 |
"601152:1" | Women's Clothing & Underwear (TikTok Shop) | TikTok Shop (JP / SEA) | Level 1 |
"601450:1" | Beauty & Personal Care (TikTok Shop) | TikTok Shop (JP / SEA) | Level 1 |
📋 Copy-Paste JSON Input Examples
Example 1: English Keyword Search + CE/FCC/RoHS Certifications & Super Factory Filter
Find verified Super Factories manufacturing wireless earbuds and power banks that hold CE, FCC, and RoHS compliance certificates, ship within 48 hours, and accept an MOQ of 50 units or fewer:
{"mode": "search","queries": ["wireless earbuds","magnetic power bank"],"maxItems": 40,"detailLevel": "full","currency": "USD","sortBy": "va_sales360","hotSelect": "super_factory","shippingFilter": "shipping_48h","certifications": ["CE","FCC","RoHS"],"maxMoq": 50,"priceMin": "2.0","priceMax": "25.0"}
Example 2: Paste 1688 Global Ranking & Search URLs Directly
Copy any air.1688.com ranking or search URL from your browser into queries or startUrls. The Actor automatically parses all embedded category IDs, ranking parameters, keywords, and filter tags:
{"mode": "auto","queries": ["https://air.1688.com/kapp/1688-global/sales/ranking?rankingName=TRENDING&countryCode=CN&platform=cbu&cateId=1044181&cateLevel=2","https://air.1688.com/kapp/1688-global/sales/search?keywords=Shoes&charset=utf8","https://air.1688.com/kapp/1688-global/sales/search?keywords=Digital,%20Computer&charset=utf8"],"maxItems": 30,"detailLevel": "full","currency": "USD"}
Example 3: Amazon Japan Best-Seller Arbitrage Discovery (JP:amazon)
Discover top-selling electronics on Amazon Japan matched directly to their source 1688 manufacturers, complete with Amazon retail price (platformRetailPriceUsd), gross profit margin (grossMarginPct), and full factory SKU matrices:
{"mode": "ranking","rankingType": "Most_Popular","rankingMarket": "JP:amazon","rankingCategory": "auto","maxItems": 25,"detailLevel": "full","currency": "USD"}
Example 4: Direct Offer IDs for Automated Price, Stock & SKU Monitoring (direct_offer)
Monitor specific 1688 factory listings by Offer ID on a daily or hourly schedule to detect wholesale price changes, low SKU inventory, or discontinued variants:
{"mode": "direct_offer","offerIds": ["851610724109","685176373959"],"detailLevel": "full","currency": "USD"}
📤 Output Schema & Sample Dataset Records
Sample 1: Amazon Japan Arbitrage Ranking + Enriched SKU Detail (sourceMode: "ranking", detailLevel: "full")
{"offerId": "800012345678","sourceMode": "ranking","rank": 1,"rankingType": "Most_Popular","rankingMarket": "JP:amazon","countryCode": "JP","downstreamPlatform": "amazon","categoryId": "3210981","categoryName": "Electronics","title": "Wireless Bluetooth 5.4 In-Ear Headphones with Digital LED Display","titleCn": "新款蓝牙耳机5.4真无线数显入耳式运动降噪耳机跨境批发","url": "https://detail.1688.com/offer/800012345678.html","globalUrl": "https://air.1688.com/kapp/1688-global/sales/ranking?rankingName=Most_Popular&countryCode=JP&platform=amazon&cateId=3210981","imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01example0000000000.jpg","images": ["https://cbu01.alicdn.com/img/ibank/O1CN01example0000000000.jpg","https://cbu01.alicdn.com/img/ibank/O1CN01example0000000001.jpg"],"priceCny": 18.5,"localPrice": 2.71,"localCurrency": "USD","localPriceFormatted": "USD 2.71","platformRetailPriceUsd": 22.9,"platformOriginalPrice": 3580.0,"platformOriginalCurrency": "JPY","grossMarginUsd": 20.19,"grossMarginPct": 88.2,"matchedSuppliersCount": 14,"moq": 2,"unit": "piece","unitCn": "个","totalStock": 48500,"exactSalesCount": 12400,"salesVolume": "10000+","momGrowthRate": "320%","repurchaseRate": "31%","priceTiers": [{"minQuantity": 2,"priceCny": 18.5,"localPrice": 2.71,"localCurrency": "USD"},{"minQuantity": 100,"priceCny": 16.8,"localPrice": 2.46,"localCurrency": "USD"},{"minQuantity": 1000,"priceCny": 15.2,"localPrice": 2.23,"localCurrency": "USD"}],"skuCount": 2,"skuProps": [{"name": "Color","values": [{"name": "Matte Black","imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01example0000000000.jpg"},{"name": "Pearl White","imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01example0000000001.jpg"}]}],"skus": [{"skuId": "5400000000001","specId": "a1b2c3d4e5f60001","specAttributes": "Matte Black","priceCny": 18.5,"localPrice": 2.71,"localCurrency": "USD","stock": 25000,"salesCount": 8200,"imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01example0000000000.jpg"},{"skuId": "5400000000002","specId": "a1b2c3d4e5f60002","specAttributes": "Pearl White","priceCny": 18.5,"localPrice": 2.71,"localCurrency": "USD","stock": 23500,"salesCount": 4200,"imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01example0000000001.jpg"}],"logistics": {"shippingOrigin": "Guangdong Shenzhen","unitWeightKg": 0.12,"domesticDeliveryFeeCny": 3.5,"freeDomesticShipping": false,"serviceNotes": ["48-hour dispatch guarantee"]},"seller": {"companyName": "Shenzhen Example Audio Technology Co., Ltd.","companyNameCn": "深圳市示例音频科技有限公司","companyNameEn": "Shenzhen Example Audio Technology Co., Ltd.","sellerLoginId": "example_audio_factory","sellerMemberId": "b2b-2200000000001","sellerUserId": "2200000000001","shopUrl": "https://example-audio.1688.com","yearsOn1688": 6,"repurchaseRate": "31%","location": "Guangdong Shenzhen","sellerType": "manufacture","isSuperFactory": true,"isFactoryDealer": true},"crossBorderFlags": {"isCrossBorderSupply": true,"supportsDropshipping": true,"freeDropshippingPostage": false,"hastaohuo": true},"leafCategoryNameCn": "蓝牙耳机","descriptionContentUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01example_desc.html","detailEnriched": true,"scrapedAt": "2026-11-10T12:00:00+00:00"}
Sample 2: Global Keyword Search + Cross-Border Filters (sourceMode: "search", detailLevel: "full")
{"offerId": "800098765432","sourceMode": "search","searchKeyword": "Shoes","title": "Breathable Mesh Men's Running Sneakers Lightweight Non-Slip Sports Shoes","titleCn": "跨境外贸男士运动鞋透气网面跑步鞋轻便防滑休闲鞋批发","url": "https://detail.1688.com/offer/800098765432.html","globalUrl": "https://air.1688.com/kapp/1688-global/sales/search?keywords=Shoes","imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01example_shoe_01.jpg","images": ["https://cbu01.alicdn.com/img/ibank/O1CN01example_shoe_01.jpg","https://cbu01.alicdn.com/img/ibank/O1CN01example_shoe_02.jpg"],"priceCny": 29.0,"originalPriceCny": 32.0,"localPrice": 4.25,"localCurrency": "USD","localPriceFormatted": "USD 4.25","moq": 2,"unit": "pair","unitCn": "双","totalStock": 18400,"exactSalesCount": 6350,"salesVolume": "6000+","repurchaseRate": "28.5%","serviceTags": ["Global Trade Verified","Ships within 24 hours","Repurchase rate 28.5%"],"priceTiers": [{"minQuantity": 2,"priceCny": 29.0,"localPrice": 4.25,"localCurrency": "USD"},{"minQuantity": 50,"priceCny": 26.5,"localPrice": 3.88,"localCurrency": "USD"}],"skuCount": 6,"logistics": {"shippingOrigin": "Zhejiang Wenzhou","unitWeightKg": 0.58,"domesticDeliveryFeeCny": 4.0,"freeDomesticShipping": false},"seller": {"companyName": "Wenzhou Example Footwear Manufacturing Co., Ltd.","companyNameCn": "温州市示例鞋业制造有限公司","companyNameEn": "Wenzhou Example Footwear Manufacturing Co., Ltd.","sellerLoginId": "example_footwear_cn","sellerMemberId": "b2b-2200000000002","starRating": 4.5,"yearsOn1688": 8,"repurchaseRate": "28.5%","location": "Zhejiang Wenzhou","sellerType": "manufacture","isSuperFactory": true,"isFactoryDealer": true},"crossBorderFlags": {"isCrossBorderSupply": true,"supportsDropshipping": true,"freeDropshippingPostage": false,"hastaohuo": true},"leafCategoryNameCn": "跑步鞋","detailEnriched": true,"scrapedAt": "2026-11-10T12:00:05+00:00"}
Complete Output Fields Reference
| Field | Type | Mode | Description |
|---|---|---|---|
offerId | string | All | Unique 1688 numeric product offer ID. |
sourceMode | string | All | "search", "ranking", or "direct_offer". |
rank | integer | ranking | 1-based rank position on the leaderboard. |
rankingType | string | ranking | "TRENDING", "Most_Popular", or "New_Arrivals". |
rankingMarket | string | ranking | Market identifier (e.g., "CN:cbu", "JP:amazon", "VN:tiktok"). |
countryCode | string | ranking | 2-letter ISO target country code (CN, JP, ID, VN, MY, TH, PH, SG). |
downstreamPlatform | string | ranking | Downstream e-commerce platform ("cbu", "amazon", or "tiktok"). |
categoryId | string | All | Numeric 1688 category ID. |
categoryName | string | ranking | English category name from the 1688 Global taxonomy. |
searchKeyword | string | search | Keyword query used to discover the product. |
title | string | All | English product title from 1688 Global. |
titleCn | string | All | Original Chinese product title on 1688. |
url | string | All | Canonical link to the offer on detail.1688.com. |
globalUrl | string | search / ranking | Source 1688 Global (air.1688.com) search or ranking URL. |
imageUrl | string | All | Primary high-resolution product photo URL. |
images | array<string> | All | Full gallery of high-resolution product images. |
priceCny | number | All | Factory wholesale unit price in Chinese Yuan (CNY). |
originalPriceCny | number | search | Baseline pre-promotion wholesale unit price in CNY. |
localPrice | number | All | Wholesale unit price converted into your selected currency. |
localCurrency | string | All | Selected display currency code (e.g., "USD", "EUR"). |
localPriceFormatted | string | All | Formatted display price (e.g., "USD 2.71"). |
platformRetailPriceUsd | number | ranking | Downstream retail price on Amazon Japan or TikTok Shop in USD. |
platformOriginalPrice | number | ranking | Downstream retail price in the target market's local currency (e.g., JPY, VND). |
platformOriginalCurrency | string | ranking | Currency code of platformOriginalPrice. |
grossMarginUsd | number | ranking | Gross unit arbitrage profit spread in USD (platformRetailPriceUsd - localPrice). |
grossMarginPct | number | ranking | Gross arbitrage profit margin percentage (0–100%). |
matchedSuppliersCount | integer | ranking | Number of 1688 suppliers matched to the downstream bestseller. |
releaseDateInfo | string | ranking | Product launch date indicator on New_Arrivals leaderboards. |
moq | integer | All | Minimum Order Quantity required by the supplier. |
unit | string | All | English unit of measure (e.g., "piece", "pair"). |
unitCn | string | Full Detail | Chinese unit of measure (e.g., "件", "双"). |
totalStock | integer | Full Detail | Total bookable factory inventory across all SKUs. |
exactSalesCount | integer | Full Detail | Exact cumulative unit sales count from offer detail. |
salesVolume | string | All | Formatted sales volume indicator (e.g., "5.9K", "10000+"). |
momGrowthRate | string | ranking | Month-over-month order volume growth rate (e.g., "1000+%"). |
repurchaseRate | string | All | Repeat wholesale customer repurchase rate (e.g., "31%"). |
serviceTags | array<string> | search | Selling point badges and fulfillment SLA tags. |
priceTiers | array<object> | Full Detail | Quantity break price brackets (minQuantity, priceCny, localPrice, localCurrency). |
skuCount | integer | Full Detail | Total number of distinct SKU combinations. |
skuProps | array<object> | Full Detail | SKU variation dimensions (e.g., Color, Size) and swatch images. |
skus | array<object> | Full Detail | Individual SKU records (skuId, specId, specAttributes, priceCny, localPrice, stock, salesCount, imageUrl). |
logistics | object | Full Detail | Shipping origin, unitWeightKg, domesticDeliveryFeeCny, freeDomesticShipping, and serviceNotes. |
seller | object | All | Supplier profile (companyName, companyNameEn, companyNameCn, yearsOn1688, starRating, repurchaseRate, location, sellerType, isSuperFactory, shopUrl). |
crossBorderFlags | object | Full Detail | Export capabilities (isCrossBorderSupply, supportsDropshipping, freeDropshippingPostage, hastaohuo). |
leafCategoryNameCn | string | Full Detail | Granular Chinese leaf category name. |
descriptionContentUrl | string | Full Detail | CDN URL containing the full HTML product specification sheet. |
detailEnriched | boolean | Full Detail | true when full SKU, tier pricing, and logistics enrichment completed. |
scrapedAt | string | All | ISO 8601 UTC extraction timestamp. |
💰 Pricing & Performance
- Lightweight 256MB RAM Footprint: Engineered for high-concurrency HTTP streaming with sub-second startup and minimal memory overhead—saving compute costs on every run.
- Transparent Pay-Per-Event (PPE) Billing:
apify-actor-start:$0.0001per run start.search-item(detailLevel: "summary"):$0.0015per product ($1.50per 1,000 products) — includes English & Chinese titles, multi-currency price, MOQ, sales volume, Amazon/TikTok arbitrage margin, and supplier summary.detail-item(detailLevel: "full"):$0.0025per product ($2.50per 1,000 products) — includes everything in summary mode plus the complete SKU variant matrix, live per-SKU inventory, bulk quantity price tiers, unit weight (unitWeightKg), and Super Factory verification flags.
- Strict Spending Cap Enforcement: Fully honors your Apify
maxTotalChargeUsdrun budget limit, automatically stopping cleanly the moment your target budget is reached with zero over-billing. - Zero Charge on Dead/Deleted Offers: If a requested direct Offer ID has been removed or taken off-shelf by the supplier, the Actor emits a clean
status: "unavailable"diagnostic record at$0.00event charge.
❓ Frequently Asked Questions (FAQ) & Troubleshooting
1. Do I need a 1688 account, Chinese phone number (+86), or cookies?
No. The Actor initializes its own cross-border session automatically on every run. You do not need a 1688 login, Alipay account, or session cookies.
2. How are grossMarginUsd and grossMarginPct calculated in Ranking mode?
When scraping downstream marketplace rankings (JP:amazon, JP:tiktok, ID:tiktok, VN:tiktok, MY:tiktok, TH:tiktok, PH:tiktok, SG:tiktok), 1688 Global matches each trending downstream retail product to the Chinese factories producing it and provides the downstream retail price (platformRetailPriceUsd). The Actor computes:
grossMarginUsd = round(platformRetailPriceUsd - localPrice, 2)grossMarginPct = round(((platformRetailPriceUsd - localPrice) / platformRetailPriceUsd) * 100, 1)
This gives you an immediate gross spread indicator before international shipping and marketplace referral fees.
3. Can I combine multiple export certifications (e.g., CE + FCC + RoHS) in one search?
Yes. Pass an array of certification codes in certifications (for example, ["CE", "FCC", "RoHS"]) or select a single certificate in the certification dropdown. Both parameters are merged automatically and filtered server-side.
4. What happens if I select a China-specific category ID with an Amazon Japan or TikTok Shop market?
Each downstream market (JP:amazon, VN:tiktok, etc.) has its own platform-specific category tree. If you leave rankingCategory set to "" or "auto" (or if a custom cateId is not present in that downstream platform's taxonomy), the Actor automatically queries the market's live category tree and resolves the default top category so your run always succeeds.
5. How do I resume a large multi-page scrape without getting duplicate products?
When a run stops early due to maxItems or a run budget cap, an encrypted checkpoint token is saved to the default Key-Value Store under RESUMPTION_STATE. Pass that token string in the resumptionToken input parameter on your next run to continue from the exact page and skip all previously extracted offerIds.
6. Need help or want to request a feature?
If you encounter any issues or need additional cross-border fields, please open a ticket in the Apify Issues Tab.
📋 Copy-and-Paste Directive for AI Coding Assistants (Cursor, Windsurf & Claude Code)
Give this direct prompt instruction to your AI assistant:
"Use the
unitbytes/1688-global-scraperActor on Apify to extract 1688 Global cross-border wholesale products, CE/FCC/RoHS certified suppliers, SKU matrices, and Amazon/TikTok Shop arbitrage rankings. Example call:client.actor('unitbytes/1688-global-scraper').call(run_input={'mode': 'auto', 'queries': ['Shoes'], 'detailLevel': 'full', 'currency': 'USD', 'maxItems': 30})"
🔌 MCP Server Setup: Claude Code, Cursor & AI Agents
Connect this scraper directly to Claude Code, Claude Desktop, Cursor, or any MCP-compatible AI agent via the hosted Apify MCP server:
{"mcpServers": {"apify": {"type": "http","url": "https://mcp.apify.com/?tools=actors,docs,unitbytes/1688-global-scraper"}}}
No manual API token required in configuration if your client supports Apify OAuth sign-in. Alternatively, pass your Apify API Token in the authorization header.
🌐 Related Chinese E-Commerce, Wholesale Sourcing & Social Commerce Actors
Combine our specialized Chinese e-commerce and B2B procurement scrapers for end-to-end supplier discovery, retail benchmarking, and social trend validation:
| Actor | Purpose & Superpowers | Pricing |
|---|---|---|
| 1688 Global Scraper & Arbitrage API (AliTrading) (📍 You are here) | English search, CE/FCC/RoHS/UL/CPC certification filters, 24h/48h dropshipping, 15 currencies & 9-market Amazon/TikTok Shop arbitrage leaderboards | From $0.0015 / item |
| 1688 Factory Direct Scraper & Price Monitor | Domestic manufacturer sourcing, true factory prices, full SKU matrices, stock monitoring & Amazon FBA packaging specs | From $0.0015 / item |
| 1688 Reverse Image Search (Photo-to-Factory) | Visual product search (以图搜款 / 拍立淘): upload any product photo, URL, or Base64 to find the exact 1688 factory | From $0.0015 / item |
| Alibaba Wholesale Scraper | Global B2B product catalog, MOQ brackets, volume tiers, FBA carton specs & Verified Supplier audits | From $0.0015 / item |
| Alibaba Supplier Scraper: Manufacturers & Factory Audits | Verified manufacturers, TÜV Rheinland / SGS inspection audits, factory floor size, staff count & export capabilities | From $0.0015 / item |
| Alibaba Seller Inventory & Store Catalog Scraper | Extract complete supplier storefront product catalogs (*.en.alibaba.com), MOQ tiers & store categories | From $0.0015 / item |
| Taobao & Tmall Product Scraper | China's premier retail marketplace: customer reviews, 3-axis DSR scores, buyer sentiment tags & multi-currency prices | From $0.0015 / item |
| Taobao & Tmall Seller Catalog & Shop Scraper | Extract full Taobao & Tmall seller storefront catalogs (淘宝店铺), shop item counts, new arrivals & 3-axis DSR ratings | From $0.0015 / item |
| Goofish / Xianyu Fast Search & Deals Scraper | Alibaba's C2C resale market (闲鱼): liquidation deals, seller price-drop sniping & secondhand arbitrage | From $0.0015 / item |
| Goofish / Xianyu Sellers, Inventory & Reviews Scraper | Merchant due diligence, Zhima Credit (芝麻信用) ratings, active/sold store catalogs & buyer unboxing photos | From $0.001 / item |
| Goofish / Xianyu Reviews & Seller Reputation Scraper | Buyer feedback, dispute filtering (negative_only), Zhima Credit verification & unboxing photo proofs | From $0.001 / review |
| Xiaohongshu (RedNote / 小红书) All-in-One Scraper | Viral consumer notes, unwatermarked HD videos/photos, KOL profiles, nested comments & live commerce | Pay-Per-Event |
📦 Other Published UnitBytes Actors (Global Marketplaces, Maps, Trends & Communities)
Explore the rest of the UnitBytes data extraction fleet on the Apify Store:
📈 Search Trends, E-Commerce Demand & Community Intelligence
| Actor | Purpose & Superpowers | Pricing |
|---|---|---|
| Google Shopping Trends Scraper | Breakout physical merchandise demand (froogle), +5,000% surging product searches, seasonal buying curves & top shopper regions | From $0.30 / 1K |
| Google Trends Scraper & Data API (All-in-One) | All 5 endpoints (interest_over_time, trending_now, interest_by_region, related_queries, related_topics) across 5 Google properties | From $0.30 / 1K |
| Google Trends Fast API | Low-latency programmatic search curves, real-time interest spikes & multi-year historical trend data | From $0.30 / 1K |
| Google Trending Now & Realtime Trends Scraper | Real-time 4h/24h/48h/7d viral search breakouts, search volumes, growth % & context news articles | From $0.30 / 1K |
| YouTube Trends Scraper | Breakout YouTube video search queries, creator SEO topics & regional viewer demand | From $0.30 / 1K |
| Reddit Scraper & Media API (All-in-One) | Subreddit feeds, 5-tab search, user profiles, deep nested comment trees & permanent HD media links | From $0.50 / 1K |
| Reddit Search Scraper: Brand Monitoring & B2B Leads | 5-surface keyword discovery across posts, communities, users, media & comments | From $0.50 / 1K |
| Reddit Subreddit Scraper: Hot Posts & Subreddits | Community feed monitoring (hot, new, top, rising) & subreddit metadata | From $0.50 / 1K |
| Reddit Comments Scraper: Comment Trees & Sentiment | Deep recursive comment reply trees (depth, parentId) for LLM/RAG & sentiment analysis | From $0.50 / 1K |
📍 Google Maps, Naver Place & Local Business Intelligence
| Actor | Purpose & Superpowers | Pricing |
|---|---|---|
| Google Maps Email & Leads Scraper (B2B Contacts) | Extract B2B business leads with verified website emails, phone numbers, social links, tech stack & ad pixels | From $0.50 / 1K |
| Google Maps Reviews Scraper (All 10K Reviews) | Extract up to 10,000 reviews per place sorted by newest/lowest rating, server-side keyword filter & policy report links | From $0.25 / 1K |
| Google Maps Review Monitor & Change Tracker (Alerts & ORM) | Stateful cross-run monitoring for NEW, REMOVED, and EDITED customer reviews plus owner reply SLA tracking | $1.50 / 1K |
| Google Maps Contributor & Local Guide Reviews Scraper | Reviewer profile audits, Local Guide levels (1–10), badges & lifetime review histories | Pay-Per-Event |
| Google Maps Photos Scraper (Places, Menus & Local Guides) | Original =s0 full-resolution place & menu photos, playable MP4 videos, 360° & Local Guide photo feeds | Pay-Per-Event |
| Naver Place & Map Scraper (네이버 플레이스·지도) | South Korean local business leads, KRW menus, 7-day hours, 0507 SmartCall phones, GPS & visitor/blog reviews | From $1.00 / 1K |
| Naver Place Reviews Scraper (네이버 플레이스 리뷰) | Receipt-verified Korean visitor reviews, server-side photo review filter, sentiment keywords & linked Naver Blog reviews | From $0.50 / 1K |
| Naver Map Scraper: Korean Leads & Menus (네이버 지도) | Korean B2B business discovery, road addresses, subway directions, amenities & full menu pricing | From $1.00 / 1K |
🏷️ Global Classifieds, Automotive & Real Estate Marketplaces
| Actor | Purpose & Superpowers | Pricing |
|---|---|---|
| Facebook Marketplace Scraper (All-in-One) | Deep city pagination with 40+ structured fields: cars, rentals, local deals, seller profiles & HD galleries | From $0.60 / 1K |
| Facebook Marketplace Vehicle & Car Scraper | Used cars, trucks & motorcycles by city/ZIP with 17-digit VIN, odometer mileage & transmission | From $0.60 / 1K |
| Facebook Marketplace Property & Rentals Scraper | Apartments & homes for rent or sale with bedrooms, bathrooms, sqft, pet policies & walk scores | From $0.60 / 1K |
| OfferUp Scraper: Marketplace Listings, Cars & Deals | Local pickup & nationwide shipping listings, 19 vehicle specs, seller storefronts & price drops | From $0.60 / 1K |
| Craigslist Search Scraper (All-in-One) | 700+ cities worldwide across all categories: cars, housing, jobs, for sale, services & direct contact leads | From $0.50 / 1K |
⚖️ Compliance & Privacy
This Actor extracts strictly publicly available B2B product and supplier catalog data from 1688 Global (air.1688.com). It does not log into private user accounts, bypass authentication walls, or collect private buyer messages. Personal data is protected by regulations such as GDPR and CCPA—see Apify's guide on the legality of web scraping and ensure your usage complies with applicable laws.
Disclaimer
This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Alibaba Group, 1688.com, or any of their subsidiaries.