1688 Global Scraper & API: Wholesale & Arbitrage 🌐 avatar

1688 Global Scraper & API: Wholesale & Arbitrage 🌐

Pricing

from $0.90 / 1,000 search / ranking product listing (summary)s

Go to Apify Store
1688 Global Scraper & API: Wholesale & Arbitrage 🌐

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

UnitBytes | Enterprise Web Data

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

an hour ago

Last modified

Features

Limited permissions

Share

🌐 1688 Global Scraper & Arbitrage API: Cross-Border Wholesale, Rankings & SKU Matrix (AliTrading)


Try it for Free

📸 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:

Capability1688 Global Scraper (1688-global-scraper)Domestic 1688 Catalog
Product Titles & TaxonomyDual English (title) + Chinese (titleCn) titles & English category namesChinese titles only
Wholesale Pricing & Currencies15 Global Currencies (USD, EUR, GBP, JPY, AUD, CAD, SGD, MYR, THB, VND, IDR, PHP, KRW, HKD) + native CNYCNY (¥) only
Export Compliance CertificationsServer-side filtering for CE, FCC, RoHS, UL, MSDS, CPC, TÜV PCoC, UKCA, CB, KC, FSC certified factoriesNot indexed by international export certificates
Amazon & TikTok Arbitrage Leaderboards9 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 FiltersFilter suppliers by Foreign-Language Retail Packaging, Multilingual Manuals, & Custom Carton Shipping MarksDomestic packaging only
1-Piece Dropshipping & SLA FiltersNative filters for 1-Piece Dropshipping, 24-Hour Dispatch, 48-Hour Dispatch, & Calibrated FBA Weight/DimensionsStandard domestic wholesale filters
Full SKU Matrix & LogisticsComplete 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 to global_trade_verified (Global Trade Verified), global_trade_choice (Global Trade Choice), super_factory (Alibaba Verified Super Factories), certified_merchant (Audited Enterprise Merchants), or precise_weight_dimensions (Calibrated Weight & Dimensions for FBA/Air Freight).
  • Export Compliance Certifications (certification / certifications): Filter strictly for manufacturers holding verified CE, RoHS, FCC, MSDS, UL, CPC, TUV_PCoC, UKCA, CB, KC, or FSC testing certificates. Combine single or multiple certificates in one query.
  • Shipping Speed & Dropshipping (shippingFilter): Target dropshipping (1-Piece Cross-Border Dropshipping), shipping_24h (24-Hour Fast Dispatch), or shipping_48h (48-Hour Fast Dispatch).
  • Export Localisation (localisationService): Filter for factories providing shipping_mark (Custom Outer Carton Shipping Marks), local_packaging (Foreign-Language Retail Packaging), or local_manuals (Foreign-Language User Manuals).
  • Supplier Tenure (sellerTenure): Filter for veteran manufacturers operating on 1688 for over_5_years, over_7_years, or over_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 (platformRetailPriceUsd and native platformOriginalPrice), 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 individual skuId, specId, specAttributes, priceCny, converted localPrice, 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 both CNY and your selected currency.
  • 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

ParameterTypeDefaultDescription
modestring"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).
queriesarray["Shoes"]List of English/multilingual keywords, 1688 Global Ranking URLs, 1688 Global Search URLs, or numeric 1688 Offer IDs.
keywordstring""Optional single search keyword, ranking URL, search URL, or numeric 1688 Offer ID.
offerIdsarray[]Optional list of numeric 1688 Offer IDs (8–16 digits) for direct full-detail extraction and price/stock monitoring.
startUrlsarray[]Optional list of 1688 Global Ranking URLs, Search URLs, or Product Detail URLs.
maxItemsinteger30Maximum number of products to extract per query or ranking feed (1 to 5000).
detailLevelstring"full""full" (enriches every product with SKU matrix, tiered pricing, stock, unit weight, and factory badges) or "summary" (fast search/ranking cards only).
currencystring"USD"Target display currency: USD, CNY, EUR, GBP, JPY, AUD, CAD, SGD, MYR, THB, VND, IDR, PHP, KRW, or HKD.
sortBystring"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").
hotSelectstring""Supplier/offer badge filter: "", "global_trade_verified", "global_trade_choice", "super_factory", "certified_merchant", or "precise_weight_dimensions".
shippingFilterstring""Fulfillment filter: "", "dropshipping" (1-Piece Dropshipping), "shipping_24h" (24h Dispatch), or "shipping_48h" (48h Dispatch).
sellerTenurestring""Supplier operating history on 1688: "", "over_5_years", "over_7_years", or "over_10_years".
localisationServicestring""Export packaging filter: "", "shipping_mark" (Custom Carton Mark), "local_packaging" (Local Language Packaging), or "local_manuals" (Local Language Manuals).
certificationstring""Single export compliance certificate filter: "", "CE", "RoHS", "FCC", "MSDS", "UL", "CPC", "TUV_PCoC", "UKCA", "CB", "KC", or "FSC".
certificationsarray[]Combine multiple export certificates in a single search (e.g., ["CE", "FCC", "RoHS"]).
maxMoqinteger—Maximum starting Minimum Order Quantity filter (e.g., 1, 2, 10, 50).
priceMinstring""Minimum unit wholesale price in selected currency (e.g., "1.5" or "10").
priceMaxstring""Maximum unit wholesale price in selected currency (e.g., "25" or "100").
rankingTypestring"TRENDING"Ranking leaderboard tab: "TRENDING" (Hot-Rising L30D Growth), "Most_Popular" (Sourcing Top Deals by L30D Orders), or "New_Arrivals" (Hot New Releases).
rankingMarketstring"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".
rankingCategorystring""Ranking category preset ("" or "auto" auto-selects the market's default category, or choose from 22 L1/L2 category presets).
customCateIdstring""Optional numeric 1688 cateId (e.g., "1044181" for Crafts). Overrides rankingCategory.
customCateLevelinteger—Category hierarchy level (1, 2, or 3) when using customCateId.
resumptionTokenstring""Encrypted pagination checkpoint token from a previous run to resume extraction with zero duplicate items.
proxyConfigurationobjectResidentialApify 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 ValueCertificate NamePrimary Target Market & Compliance Scope
"CE"CE Marking (European Conformity)European Economic Area (EEA) health, safety, and environmental protection
"RoHS"RoHS Directive ComplianceEU & global restriction of hazardous substances in electrical/electronic equipment
"FCC"FCC Declaration of ConformityUnited States radio frequency, wireless, Bluetooth, and electronic devices
"MSDS"Material Safety Data SheetInternational air/sea freight safety documentation for batteries, liquids, and cosmetics
"UL"UL Safety CertificationNorth American (US & Canada) electrical, charger, and appliance safety standards
"CPC"Children's Product CertificateUS CPSC mandatory safety certification for toys, baby products, and children's apparel
"TUV_PCoC" (or "TUV")TÜV PCoCAccredited TÜV product conformity testing and quality verification
"UKCA"UK Conformity AssessedGreat Britain (England, Wales, Scotland) mandatory product safety marking
"CB"IEC CB Scheme CertificateInternational Electrotechnical Commission mutual recognition electrical safety
"KC"Korea Certification (KC Mark)South Korea mandatory safety certification for electronics and consumer goods
"FSC"Forest Stewardship CouncilSustainably sourced wood, paper, packaging, and furniture certification

2. Hot Select, Shipping, Tenure & Localisation Filters

ParameterAllowed ValueDescription
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)

rankingMarketCountryDownstream PlatformArbitrage 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 ValueCategory NameMarket ScopeHierarchy Level
"" or "auto"Auto-Select Default Category for MarketAll Markets (CN, JP, SEA)Auto
"54:1"Clothing Accessories & Jewelry1688 Global (CN:cbu)Level 1
"67:1"Office & Culture1688 Global (CN:cbu)Level 1
"1044181:2"Crafts & Giftware1688 Global (CN:cbu)Level 2
"18:1"Sports & Outdoor1688 Global (CN:cbu)Level 1
"1042954:1"Luggage & Leather Goods1688 Global (CN:cbu)Level 1
"10166:1"Women's Clothing1688 Global (CN:cbu)Level 1
"311:1"Children's Clothing1688 Global (CN:cbu)Level 1
"7:1"Digital & Computer1688 Global (CN:cbu)Level 1
"1038378:1"Shoes & Footwear1688 Global (CN:cbu)Level 1
"1813:1"Toys & Hobbies1688 Global (CN:cbu)Level 1
"97:1"Beauty, Skincare & Makeup1688 Global (CN:cbu)Level 1
"6:1"Household Appliances1688 Global (CN:cbu)Level 1
"58:1"Lighting1688 Global (CN:cbu)Level 1
"122916001:1"Pets & Gardening1688 Global (CN:cbu)Level 1
"122916002:1"Automotive Supplies1688 Global (CN:cbu)Level 1
"96:1"Home Textile & Decoration1688 Global (CN:cbu)Level 1
"59:1"Hardware & Tools1688 Global (CN:cbu)Level 1
"68:1"Packaging Materials1688 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

FieldTypeModeDescription
offerIdstringAllUnique 1688 numeric product offer ID.
sourceModestringAll"search", "ranking", or "direct_offer".
rankintegerranking1-based rank position on the leaderboard.
rankingTypestringranking"TRENDING", "Most_Popular", or "New_Arrivals".
rankingMarketstringrankingMarket identifier (e.g., "CN:cbu", "JP:amazon", "VN:tiktok").
countryCodestringranking2-letter ISO target country code (CN, JP, ID, VN, MY, TH, PH, SG).
downstreamPlatformstringrankingDownstream e-commerce platform ("cbu", "amazon", or "tiktok").
categoryIdstringAllNumeric 1688 category ID.
categoryNamestringrankingEnglish category name from the 1688 Global taxonomy.
searchKeywordstringsearchKeyword query used to discover the product.
titlestringAllEnglish product title from 1688 Global.
titleCnstringAllOriginal Chinese product title on 1688.
urlstringAllCanonical link to the offer on detail.1688.com.
globalUrlstringsearch / rankingSource 1688 Global (air.1688.com) search or ranking URL.
imageUrlstringAllPrimary high-resolution product photo URL.
imagesarray<string>AllFull gallery of high-resolution product images.
priceCnynumberAllFactory wholesale unit price in Chinese Yuan (CNY).
originalPriceCnynumbersearchBaseline pre-promotion wholesale unit price in CNY.
localPricenumberAllWholesale unit price converted into your selected currency.
localCurrencystringAllSelected display currency code (e.g., "USD", "EUR").
localPriceFormattedstringAllFormatted display price (e.g., "USD 2.71").
platformRetailPriceUsdnumberrankingDownstream retail price on Amazon Japan or TikTok Shop in USD.
platformOriginalPricenumberrankingDownstream retail price in the target market's local currency (e.g., JPY, VND).
platformOriginalCurrencystringrankingCurrency code of platformOriginalPrice.
grossMarginUsdnumberrankingGross unit arbitrage profit spread in USD (platformRetailPriceUsd - localPrice).
grossMarginPctnumberrankingGross arbitrage profit margin percentage (0–100%).
matchedSuppliersCountintegerrankingNumber of 1688 suppliers matched to the downstream bestseller.
releaseDateInfostringrankingProduct launch date indicator on New_Arrivals leaderboards.
moqintegerAllMinimum Order Quantity required by the supplier.
unitstringAllEnglish unit of measure (e.g., "piece", "pair").
unitCnstringFull DetailChinese unit of measure (e.g., "件", "双").
totalStockintegerFull DetailTotal bookable factory inventory across all SKUs.
exactSalesCountintegerFull DetailExact cumulative unit sales count from offer detail.
salesVolumestringAllFormatted sales volume indicator (e.g., "5.9K", "10000+").
momGrowthRatestringrankingMonth-over-month order volume growth rate (e.g., "1000+%").
repurchaseRatestringAllRepeat wholesale customer repurchase rate (e.g., "31%").
serviceTagsarray<string>searchSelling point badges and fulfillment SLA tags.
priceTiersarray<object>Full DetailQuantity break price brackets (minQuantity, priceCny, localPrice, localCurrency).
skuCountintegerFull DetailTotal number of distinct SKU combinations.
skuPropsarray<object>Full DetailSKU variation dimensions (e.g., Color, Size) and swatch images.
skusarray<object>Full DetailIndividual SKU records (skuId, specId, specAttributes, priceCny, localPrice, stock, salesCount, imageUrl).
logisticsobjectFull DetailShipping origin, unitWeightKg, domesticDeliveryFeeCny, freeDomesticShipping, and serviceNotes.
sellerobjectAllSupplier profile (companyName, companyNameEn, companyNameCn, yearsOn1688, starRating, repurchaseRate, location, sellerType, isSuperFactory, shopUrl).
crossBorderFlagsobjectFull DetailExport capabilities (isCrossBorderSupply, supportsDropshipping, freeDropshippingPostage, hastaohuo).
leafCategoryNameCnstringFull DetailGranular Chinese leaf category name.
descriptionContentUrlstringFull DetailCDN URL containing the full HTML product specification sheet.
detailEnrichedbooleanFull Detailtrue when full SKU, tier pricing, and logistics enrichment completed.
scrapedAtstringAllISO 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.0001 per run start.
    • search-item (detailLevel: "summary"): $0.0015 per product ($1.50 per 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.0025 per product ($2.50 per 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 maxTotalChargeUsd run 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.00 event 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.

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-scraper Actor 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.


Combine our specialized Chinese e-commerce and B2B procurement scrapers for end-to-end supplier discovery, retail benchmarking, and social trend validation:

ActorPurpose & SuperpowersPricing
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 leaderboardsFrom $0.0015 / item
1688 Factory Direct Scraper & Price MonitorDomestic manufacturer sourcing, true factory prices, full SKU matrices, stock monitoring & Amazon FBA packaging specsFrom $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 factoryFrom $0.0015 / item
Alibaba Wholesale ScraperGlobal B2B product catalog, MOQ brackets, volume tiers, FBA carton specs & Verified Supplier auditsFrom $0.0015 / item
Alibaba Supplier Scraper: Manufacturers & Factory AuditsVerified manufacturers, TÜV Rheinland / SGS inspection audits, factory floor size, staff count & export capabilitiesFrom $0.0015 / item
Alibaba Seller Inventory & Store Catalog ScraperExtract complete supplier storefront product catalogs (*.en.alibaba.com), MOQ tiers & store categoriesFrom $0.0015 / item
Taobao & Tmall Product ScraperChina's premier retail marketplace: customer reviews, 3-axis DSR scores, buyer sentiment tags & multi-currency pricesFrom $0.0015 / item
Taobao & Tmall Seller Catalog & Shop ScraperExtract full Taobao & Tmall seller storefront catalogs (淘宝店铺), shop item counts, new arrivals & 3-axis DSR ratingsFrom $0.0015 / item
Goofish / Xianyu Fast Search & Deals ScraperAlibaba's C2C resale market (闲鱼): liquidation deals, seller price-drop sniping & secondhand arbitrageFrom $0.0015 / item
Goofish / Xianyu Sellers, Inventory & Reviews ScraperMerchant due diligence, Zhima Credit (芝麻信用) ratings, active/sold store catalogs & buyer unboxing photosFrom $0.001 / item
Goofish / Xianyu Reviews & Seller Reputation ScraperBuyer feedback, dispute filtering (negative_only), Zhima Credit verification & unboxing photo proofsFrom $0.001 / review
Xiaohongshu (RedNote / 小红书) All-in-One ScraperViral consumer notes, unwatermarked HD videos/photos, KOL profiles, nested comments & live commercePay-Per-Event

Explore the rest of the UnitBytes data extraction fleet on the Apify Store:

ActorPurpose & SuperpowersPricing
Google Shopping Trends ScraperBreakout physical merchandise demand (froogle), +5,000% surging product searches, seasonal buying curves & top shopper regionsFrom $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 propertiesFrom $0.30 / 1K
Google Trends Fast APILow-latency programmatic search curves, real-time interest spikes & multi-year historical trend dataFrom $0.30 / 1K
Google Trending Now & Realtime Trends ScraperReal-time 4h/24h/48h/7d viral search breakouts, search volumes, growth % & context news articlesFrom $0.30 / 1K
YouTube Trends ScraperBreakout YouTube video search queries, creator SEO topics & regional viewer demandFrom $0.30 / 1K
Reddit Scraper & Media API (All-in-One)Subreddit feeds, 5-tab search, user profiles, deep nested comment trees & permanent HD media linksFrom $0.50 / 1K
Reddit Search Scraper: Brand Monitoring & B2B Leads5-surface keyword discovery across posts, communities, users, media & commentsFrom $0.50 / 1K
Reddit Subreddit Scraper: Hot Posts & SubredditsCommunity feed monitoring (hot, new, top, rising) & subreddit metadataFrom $0.50 / 1K
Reddit Comments Scraper: Comment Trees & SentimentDeep recursive comment reply trees (depth, parentId) for LLM/RAG & sentiment analysisFrom $0.50 / 1K

📍 Google Maps, Naver Place & Local Business Intelligence

ActorPurpose & SuperpowersPricing
Google Maps Email & Leads Scraper (B2B Contacts)Extract B2B business leads with verified website emails, phone numbers, social links, tech stack & ad pixelsFrom $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 linksFrom $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 ScraperReviewer profile audits, Local Guide levels (1–10), badges & lifetime review historiesPay-Per-Event
Google Maps Photos Scraper (Places, Menus & Local Guides)Original =s0 full-resolution place & menu photos, playable MP4 videos, 360° & Local Guide photo feedsPay-Per-Event
Naver Place & Map Scraper (네이버 플레이스·지도)South Korean local business leads, KRW menus, 7-day hours, 0507 SmartCall phones, GPS & visitor/blog reviewsFrom $1.00 / 1K
Naver Place Reviews Scraper (네이버 플레이스 리뷰)Receipt-verified Korean visitor reviews, server-side photo review filter, sentiment keywords & linked Naver Blog reviewsFrom $0.50 / 1K
Naver Map Scraper: Korean Leads & Menus (네이버 지도)Korean B2B business discovery, road addresses, subway directions, amenities & full menu pricingFrom $1.00 / 1K

🏷️ Global Classifieds, Automotive & Real Estate Marketplaces

ActorPurpose & SuperpowersPricing
Facebook Marketplace Scraper (All-in-One)Deep city pagination with 40+ structured fields: cars, rentals, local deals, seller profiles & HD galleriesFrom $0.60 / 1K
Facebook Marketplace Vehicle & Car ScraperUsed cars, trucks & motorcycles by city/ZIP with 17-digit VIN, odometer mileage & transmissionFrom $0.60 / 1K
Facebook Marketplace Property & Rentals ScraperApartments & homes for rent or sale with bedrooms, bathrooms, sqft, pet policies & walk scoresFrom $0.60 / 1K
OfferUp Scraper: Marketplace Listings, Cars & DealsLocal pickup & nationwide shipping listings, 19 vehicle specs, seller storefronts & price dropsFrom $0.60 / 1K
Craigslist Search Scraper (All-in-One)700+ cities worldwide across all categories: cars, housing, jobs, for sale, services & direct contact leadsFrom $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.