# 1688 Global Scraper & API: Wholesale & Arbitrage 🌐 (`unitbytes/1688-global-scraper`) Actor
⚡ 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.
- **URL**: https://apify.com/unitbytes/1688-global-scraper.md
- **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community)
- **Categories:** E-commerce, Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.90 / 1,000 search / ranking product listing (summary)s
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event
## What's an Apify Actor?
An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.
For examples already wired to this Actor's own input schema, see the [API](#api) section below.
Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).
# README
## 🌐 1688 Global Scraper & Arbitrage API: Cross-Border Wholesale, Rankings & SKU Matrix (AliTrading)
[](https://apify.com/unitbytes/1688-global-scraper?fpr=939u3w\&fp_sid=gh_1688_global)
[](#)
[](#)
[](#)
[](#)
[](#)
**Extract structured cross-border wholesale product catalogs, 15-currency factory pricing, international export compliance certifications (`CE`, `FCC`, `RoHS`, `UL`, `CPC`, `UKCA`, `MSDS`), complete SKU variant matrices, unit weights (`kg`), and downstream Amazon Japan & Southeast Asia TikTok Shop best-seller arbitrage margins directly from 1688 Global (`air.1688.com` / AliTrading) — with Zero Login, Zero Chinese Phone Number & Zero Manual Cookies Required.**
[**🚀 Try it Live on Apify**](https://console.apify.com/actors/WkaxfzL8TAyoNjWGL/input) • [**🇨🇳 Domestic 1688 Factory Scraper**](https://apify.com/unitbytes/1688-scraper?fpr=939u3w\&fp_sid=ecosystem) • [**📸 1688 Reverse Image Search**](https://apify.com/unitbytes/1688-image-search-scraper?fpr=939u3w\&fp_sid=ecosystem) • [**💬 Support**](https://apify.com/unitbytes/1688-global-scraper/issues)
***
⚡ 1-Click Free Trial: Test live cross-border queries & arbitrage rankings using Apify's $5 free monthly credit • No credit card required
> 📸 **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**](https://apify.com/unitbytes/1688-image-search-scraper?fpr=939u3w\&fp_sid=ecosystem) to find the original Chinese manufacturer from any Amazon, TikTok Shop, or Shopify photo, or pair with our [**Google Shopping Trends Scraper**](https://apify.com/unitbytes/google-shopping-trends-scraper?fpr=939u3w\&fp_sid=ecosystem) 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 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
| 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**:
```json
{
"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:
```json
{
"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:
```json
{
"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:
```json
{
"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"`)
```json
{
"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"`)
```json
{
"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` | 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` | `search` | Selling point badges and fulfillment SLA tags. |
| `priceTiers` | `array` | Full Detail | Quantity break price brackets (`minQuantity`, `priceCny`, `localPrice`, `localCurrency`). |
| `skuCount` | `integer` | Full Detail | Total number of distinct SKU combinations. |
| `skuProps` | `array` | Full Detail | SKU variation dimensions (e.g., Color, Size) and swatch images. |
| `skus` | `array` | 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.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.
#### 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 `offerId`s.
#### 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](https://apify.com/unitbytes/1688-global-scraper/issues).
***
#### 📋 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:
```json
{
"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)**](https://apify.com/unitbytes/1688-global-scraper?fpr=939u3w\&fp_sid=ecosystem) *(📍 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**](https://apify.com/unitbytes/1688-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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)**](https://apify.com/unitbytes/1688-image-search-scraper?fpr=939u3w\&fp_sid=ecosystem) | Visual product search (`以图搜款 / 拍立淘`): upload any product photo, URL, or Base64 to find the exact 1688 factory | From $0.0015 / item |
| [**Alibaba Wholesale Scraper**](https://apify.com/unitbytes/alibaba-scraper?fpr=939u3w\&fp_sid=ecosystem) | Global B2B product catalog, MOQ brackets, volume tiers, FBA carton specs & Verified Supplier audits | From $0.0015 / item |
| [**Alibaba Supplier Scraper: Manufacturers & Factory Audits**](https://apify.com/unitbytes/alibaba-supplier-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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**](https://apify.com/unitbytes/alibaba-seller-inventory-scraper?fpr=939u3w\&fp_sid=ecosystem) | Extract complete supplier storefront product catalogs (`*.en.alibaba.com`), MOQ tiers & store categories | From $0.0015 / item |
| [**Taobao & Tmall Product Scraper**](https://apify.com/unitbytes/taobao-tmall-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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**](https://apify.com/unitbytes/taobao-seller-shop-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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**](https://apify.com/unitbytes/goofish-xianyu-search-scraper?fpr=939u3w\&fp_sid=ecosystem) | Alibaba's C2C resale market (`闲鱼`): liquidation deals, seller price-drop sniping & secondhand arbitrage | From $0.0015 / item |
| [**Goofish / Xianyu Sellers, Inventory & Reviews Scraper**](https://apify.com/unitbytes/goofish-scraper?fpr=939u3w\&fp_sid=ecosystem) | Merchant due diligence, Zhima Credit (`芝麻信用`) ratings, active/sold store catalogs & buyer unboxing photos | From $0.001 / item |
| [**Goofish / Xianyu Reviews & Seller Reputation Scraper**](https://apify.com/unitbytes/goofish-xianyu-comments-scraper?fpr=939u3w\&fp_sid=ecosystem) | Buyer feedback, dispute filtering (`negative_only`), Zhima Credit verification & unboxing photo proofs | From $0.001 / review |
| [**Xiaohongshu (RedNote / 小红书) All-in-One Scraper**](https://apify.com/unitbytes/xiaohongshu-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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**](https://apify.com/unitbytes/google-shopping-trends-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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)**](https://apify.com/unitbytes/google-trends-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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**](https://apify.com/unitbytes/google-trends-api?fpr=939u3w\&fp_sid=ecosystem) | Low-latency programmatic search curves, real-time interest spikes & multi-year historical trend data | From $0.30 / 1K |
| [**Google Trending Now & Realtime Trends Scraper**](https://apify.com/unitbytes/google-trending-now-scraper?fpr=939u3w\&fp_sid=ecosystem) | Real-time 4h/24h/48h/7d viral search breakouts, search volumes, growth % & context news articles | From $0.30 / 1K |
| [**YouTube Trends Scraper**](https://apify.com/unitbytes/youtube-trends-scraper?fpr=939u3w\&fp_sid=ecosystem) | Breakout YouTube video search queries, creator SEO topics & regional viewer demand | From $0.30 / 1K |
| [**Reddit Scraper & Media API (All-in-One)**](https://apify.com/unitbytes/reddit-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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**](https://apify.com/unitbytes/reddit-search-scraper?fpr=939u3w\&fp_sid=ecosystem) | 5-surface keyword discovery across posts, communities, users, media & comments | From $0.50 / 1K |
| [**Reddit Subreddit Scraper: Hot Posts & Subreddits**](https://apify.com/unitbytes/reddit-subreddits-scraper?fpr=939u3w\&fp_sid=ecosystem) | Community feed monitoring (`hot`, `new`, `top`, `rising`) & subreddit metadata | From $0.50 / 1K |
| [**Reddit Comments Scraper: Comment Trees & Sentiment**](https://apify.com/unitbytes/reddit-comments-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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)**](https://apify.com/unitbytes/google-maps-leads-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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)**](https://apify.com/unitbytes/google-maps-reviews-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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)**](https://apify.com/unitbytes/google-maps-reviews-tracker?fpr=939u3w\&fp_sid=ecosystem) | 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**](https://apify.com/unitbytes/google-maps-contributor-scraper?fpr=939u3w\&fp_sid=ecosystem) | Reviewer profile audits, Local Guide levels (1–10), badges & lifetime review histories | Pay-Per-Event |
| [**Google Maps Photos Scraper (Places, Menus & Local Guides)**](https://apify.com/unitbytes/google-maps-photos-scraper?fpr=939u3w\&fp_sid=ecosystem) | Original `=s0` full-resolution place & menu photos, playable MP4 videos, 360° & Local Guide photo feeds | Pay-Per-Event |
| [**Naver Place & Map Scraper (네이버 플레이스·지도)**](https://apify.com/unitbytes/naver-place-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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 (네이버 플레이스 리뷰)**](https://apify.com/unitbytes/naver-place-reviews-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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 (네이버 지도)**](https://apify.com/unitbytes/naver-map-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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)**](https://apify.com/unitbytes/Facebook-Marketplace-Scraper?fpr=939u3w\&fp_sid=ecosystem) | Deep city pagination with 40+ structured fields: cars, rentals, local deals, seller profiles & HD galleries | From $0.60 / 1K |
| [**Facebook Marketplace Vehicle & Car Scraper**](https://apify.com/unitbytes/facebook-marketplace-vehicle-scraper?fpr=939u3w\&fp_sid=ecosystem) | Used cars, trucks & motorcycles by city/ZIP with 17-digit VIN, odometer mileage & transmission | From $0.60 / 1K |
| [**Facebook Marketplace Property & Rentals Scraper**](https://apify.com/unitbytes/facebook-marketplace-property-scraper?fpr=939u3w\&fp_sid=ecosystem) | Apartments & homes for rent or sale with bedrooms, bathrooms, sqft, pet policies & walk scores | From $0.60 / 1K |
| [**OfferUp Scraper: Marketplace Listings, Cars & Deals**](https://apify.com/unitbytes/offerup-scraper?fpr=939u3w\&fp_sid=ecosystem) | Local pickup & nationwide shipping listings, 19 vehicle specs, seller storefronts & price drops | From $0.60 / 1K |
| [**Craigslist Search Scraper (All-in-One)**](https://apify.com/unitbytes/craigslist-scraper?fpr=939u3w\&fp_sid=ecosystem) | 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](https://blog.apify.com/is-web-scraping-legal/) 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.
# Actor input Schema
## `mode` (type: `string`):
Select 'Auto-Detect' to automatically classify keywords, 1688 Global search URLs, ranking URLs, or numeric offer IDs. Choose 'Global Trending & Best-Seller Rankings' to extract cross-border leaderboards for China 1688, Japan Amazon/TikTok, or Southeast Asia TikTok Shop.
## `queries` (type: `array`):
Enter English or multilingual product keywords (e.g. 'Shoes', 'Digital, Computer', 'wireless earbuds'), 1688 Global Ranking URLs ('https://air.1688.com/kapp/1688-global/sales/ranking?...'), 1688 Global Search URLs ('https://air.1688.com/kapp/1688-global/sales/search?keywords=Shoes'), or numeric 1688 Offer IDs.
## `keyword` (type: `string`):
Optional single search keyword, 1688 Global ranking URL, search URL, or numeric 1688 offer ID.
## `offerIds` (type: `array`):
Optional list of numeric 1688 wholesale offer IDs (e.g. \['851610724109', '685176373959']) to extract full B2B product details, tiered wholesale pricing, unit weights, and SKU matrices directly without searching.
## `startUrls` (type: `array`):
Paste any 1688 Global Ranking URLs ('air.1688.com/kapp/1688-global/sales/ranking?...'), Global Search URLs ('air.1688.com/kapp/1688-global/sales/search?keywords=...'), or Product Offer URLs ('detail.1688.com/offer/...') directly from your browser.
## `maxItems` (type: `integer`):
Maximum number of wholesale products to extract per query or ranking feed (1 to 5,000).
## `detailLevel` (type: `string`):
Choose 'Full B2B & SKU Mode' (recommended) to enrich each listing with complete SKU variant matrices, tiered MOQ pricing, live stock counts, unit weight (kg), and factory verification flags, or 'Summary Mode' for fast search and ranking card discovery.
## `currency` (type: `string`):
Target currency for global wholesale pricing (CNY factory price is always returned alongside your selected local currency).
## `sortBy` (type: `string`):
Sorting order for 1688 Global keyword searches.
## `hotSelect` (type: `string`):
Filter search results by 1688 Global Trade verification, Super Factory status, Certified Merchant status, or calibrated weight & dimensions for FBA freight.
## `shippingFilter` (type: `string`):
Filter by 1-piece cross-border Dropshipping support or guaranteed 24-hour / 48-hour dispatch SLA.
## `sellerTenure` (type: `string`):
Filter for established manufacturers and wholesalers by verified operating history on 1688.
## `localisationService` (type: `string`):
Filter for export-ready factories offering custom carton shipping marks, foreign-language retail packaging, or multilingual user manuals.
## `certification` (type: `string`):
Filter for products holding verified international compliance certificates (CE, RoHS, FCC, MSDS, UL, CPC, TÜV PCoC, UKCA, CB, KC, FSC). To combine multiple certifications at once, use 'Multiple Certifications' below.
## `certifications` (type: `array`):
Optional list of multiple certification codes to combine in a single search (e.g. \['CE', 'RoHS', 'FCC']).
## `maxMoq` (type: `integer`):
Filter products whose minimum order quantity is at or below this threshold (e.g. 1, 2, 10, 50).
## `priceMin` (type: `string`):
Minimum unit wholesale price in your selected currency (e.g. '1.5' or '10').
## `priceMax` (type: `string`):
Maximum unit wholesale price in your selected currency (e.g. '50' or '200').
## `rankingType` (type: `string`):
Select which 1688 Global ranking leaderboard to extract.
## `rankingMarket` (type: `string`):
Select the target country and e-commerce platform for the ranking leaderboard. Amazon Japan and TikTok Shop markets include downstream retail prices ('platformRetailPriceUsd') and automatic gross arbitrage margin calculations ('grossMarginUsd', 'grossMarginPct').
## `rankingCategory` (type: `string`):
Select a category for the ranking feed, or leave on 'Auto-Select Default Category' ('' or 'auto'). You can also specify any Level 1/2/3 category ID in 'Custom Category ID' below.
## `customCateId` (type: `string`):
Optional numeric 1688 category ID (e.g. '1044181' for Crafts or '1038378' for Shoes). Overrides the Ranking Category dropdown above.
## `customCateLevel` (type: `integer`):
Category hierarchy level (1, 2, or 3) when using a Custom Category ID.
## `resumptionToken` (type: `string`):
Optional encrypted resumption token from a previous run to continue pagination with zero duplicate items.
## `proxyConfiguration` (type: `object`):
Apify Proxy configuration. Apify Residential proxy is recommended for reliable global extraction.
## Actor input object example
```json
{
"mode": "auto",
"queries": [
"Shoes"
],
"maxItems": 30,
"detailLevel": "full",
"currency": "USD",
"sortBy": "normal",
"hotSelect": "",
"shippingFilter": "",
"sellerTenure": "",
"localisationService": "",
"certification": "",
"rankingType": "TRENDING",
"rankingMarket": "CN:cbu",
"rankingCategory": "",
"proxyConfiguration": {
"useApifyProxy": true
}
}
```
# Actor output Schema
## `results` (type: `string`):
Extracted 1688 Global (AliTrading) wholesale offers, multi-currency prices, CE/FCC/RoHS compliance filters, Amazon & TikTok Shop arbitrage margins, SKU variant matrices, and supplier intelligence.
## `overview` (type: `string`):
Curated table of 1688 Global offers with English titles, local & CNY pricing, MOQ, stock, SKU counts, and supplier details.
## `arbitrage` (type: `string`):
Side-by-side comparison of 1688 factory wholesale prices against downstream Amazon Japan and TikTok Shop retail prices, gross profit margins ($ and %), and monthly sales growth.
## `sku_logistics` (type: `string`):
Cross-border fulfillment specifications including per-unit weight (kg), shipping origin, domestic freight, Super Factory verification, and 1-piece dropshipping support.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"mode": "auto",
"queries": [
"Shoes"
],
"maxItems": 30,
"detailLevel": "full",
"proxyConfiguration": {
"useApifyProxy": true
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("unitbytes/1688-global-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"mode": "auto",
"queries": ["Shoes"],
"maxItems": 30,
"detailLevel": "full",
"proxyConfiguration": { "useApifyProxy": True },
}
# Run the Actor and wait for it to finish
run = client.actor("unitbytes/1688-global-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"mode": "auto",
"queries": [
"Shoes"
],
"maxItems": 30,
"detailLevel": "full",
"proxyConfiguration": {
"useApifyProxy": true
}
}' |
apify call unitbytes/1688-global-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/1688-global-scraper"
}
}
}
```
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/WkaxfzL8TAyoNjWGL/builds/QLYCVHciG6hWABVtk/openapi.json
