1688 Product Search – China Wholesale Product Data Extractor

Search 1688.com (Alibaba China) products by keyword, category, or vendor and extract detailed product data including pricing in CNY & USD, vendor info, quantity ranges, images, and physical parameters. Supports pagination, sorting, price filtering, and multi-language output. Built with Apify best practices for reliability and speed.

---

Table of Contents

• Features
• Use Cases
• Quick Start
• Input Parameters
• Output Format
• Sorting Options
• Language Support
• Performance & Limits
• FAQ
• Troubleshooting
• Tags

---

Features

• Keyword Search – Search 1688.com's full product catalog using any keyword or phrase in any supported language.
• Multi-Language Support – Get product titles and descriptions in 35+ languages including English, Chinese, Spanish, French, Japanese, Korean, Arabic, and more.
• Pagination Support – Scrape up to 250 pages of search results per run (~10,000 products) for large-scale data collection.
• Sorting Options – Sort results by Recently Updated, Price Low-to-High, or Price High-to-Low.
• Price Range Filtering – Set minimum and/or maximum price in CNY to narrow down products within your budget.
• Category Filtering – Filter results by a specific 1688 category ID for targeted product discovery.
• Vendor Filtering – Search products from a specific vendor/store on 1688.
• Dual Currency Pricing – Get prices in both Chinese Yuan (CNY) and US Dollar (USD) automatically.
• Quantity Tier Pricing – Extract wholesale tier pricing (e.g., 1-9 units, 10-49 units, 50+ units).
• Rich Product Data – Extract images (multiple sizes), vendor info, brand details, physical parameters, stock quantity, and more.

---

Use Cases

Use Case	Description	Key Benefits
Wholesale Sourcing	Find Chinese wholesale products at factory prices on 1688.	Access the largest Chinese B2B marketplace with real-time pricing.
Price Monitoring	Track 1688 product prices over time for dynamic pricing strategies.	Detect price changes in both CNY and USD simultaneously.
Competitor Analysis	Monitor vendor products, pricing, and quantity tiers across categories.	Benchmark against Chinese suppliers and discover new products.
Product Research	Search product categories to analyze trends, brands, and wholesale pricing.	Discover trending wholesale products with tier pricing data.
Dropshipping & Arbitrage	Find profitable products by comparing 1688 prices with other marketplaces.	Automate product discovery with price and category filters.
Supply Chain Intelligence	Enrich your database with 1688 vendor data, stock levels, and shipping parameters.	Automate supplier evaluation with vendor scores and stock data.

---

Quick Start

1. Basic – Simple Keyword Search

{
  "query": "LED light",
  "maxPages": 1
}

2. Advanced – Sorted by Price with Category Filter

{
  "query": "phone case",
  "sortBy": "Price:Asc",
  "categoryId": "10206",
  "maxPages": 3
}

3. Multi-Language – Japanese Output

{
  "query": "wireless earbuds",
  "language": "ja",
  "maxPages": 2
}

4. Full Filters – Price Range + Vendor + Sorting

{
  "query": "Polymer Lithium Battery",
  "sortBy": "UpdatedTime:Desc",
  "minPrice": 10,
  "maxPrice": 500,
  "language": "en",
  "maxPages": 5
}

---

Input Parameters

Parameter	Type	Required	Description	Default	Example
query	String	Yes	Search keyword or phrase to find products on 1688	-	"LED light", "phone case", "Polymer Lithium Battery"
language	String	No	Language for product titles and descriptions (see Language Support)	"en"	"zh-chs", "ja", "ko"
sortBy	String	No	Sort order for results (see Sorting Options)	"UpdatedTime:Desc"	"Price:Asc", "Price:Desc"
categoryId	String	No	1688 category ID to filter results. Leave empty for all categories	-	"10206", "1032307"
vendorName	String	No	Filter by specific vendor/store name on 1688	-	"b2b-221850414746747d22"
minPrice	Number	No	Minimum product price in CNY (Chinese Yuan)	-	10, 50, 100
maxPrice	Number	No	Maximum product price in CNY (Chinese Yuan)	-	500, 1000, 5000
maxPages	Integer	No	Number of result pages to scrape (1–250). Each page returns ~40 products	1	3, 10, 50

---

Output Format

Product Result Data Structure

{
  "source": "1688_product_search",
  "search_query": "Polymer Lithium Battery",
  "position": 1,

  "id": "abb-969369401690",
  "title": "Electric bike, lithium battery, smart electric car",
  "original_title": "出口长续航电动摩托车自行车小九牛号锂电池电瓶车智能车电动车",
  "is_title_translated": true,

  "category_id": "abb-1221",
  "external_category_id": "1221",

  "external_item_url": "https://detail.1688.com/offer/969369401690.html",
  "taobao_item_url": "https://detail.1688.com/offer/969369401690.html",

  "vendor_id": "abb-b2b-221850414746747d22",
  "vendor_name": "b2b-221850414746747d22",
  "vendor_display_name": "b2b-221850414746747d22",
  "vendor_score": 12,

  "brand_id": "abb-琪尚",
  "brand_name": "琪尚",

  "provider_type": "Alibaba1688",

  "price_cny": 1387,
  "margin_price_cny": 1387,
  "original_currency": "CNY",

  "price_usd": 191,
  "converted_price": "191.00$",
  "converted_price_without_sign": "191.00",
  "currency_sign": "$",
  "currency_name": "USD",

  "is_deliverable": false,
  "delivery_price_cny": 0,
  "delivery_price_usd": 0,

  "quantity_ranges": [
    {
      "min_quantity": 1,
      "price_cny": 6000,
      "price_usd": 824,
      "converted_price": "824.00$"
    },
    {
      "min_quantity": 5,
      "price_cny": 5800,
      "price_usd": 797,
      "converted_price": "797.00$"
    },
    {
      "min_quantity": 10,
      "price_cny": 5500,
      "price_usd": 756,
      "converted_price": "756.00$"
    }
  ],

  "stuff_status": "New",
  "volume": 0,
  "master_quantity": 599,
  "is_sell_allowed": true,
  "is_filtered": false,

  "main_image": "https://cbu01.alicdn.com/img/ibank/...",
  "images": [
    {
      "url": "https://cbu01.alicdn.com/img/ibank/...",
      "small": "https://cbu01.alicdn.com/img/ibank/...100x100.jpg",
      "medium": "https://cbu01.alicdn.com/img/ibank/...310x310.jpg",
      "large": "https://cbu01.alicdn.com/img/ibank/...600x600.jpg",
      "is_main": true
    }
  ],

  "weight_kg": 65,
  "length_cm": 165,
  "width_cm": 45,
  "height_cm": 85,

  "features": [],
  "featured_values": {
    "encrypted_vendor_id": "BBB9eSevm_FL6Ckft7N4_QCZA"
  },

  "created_time": "2025-12-10T16:26:43.139Z",
  "updated_time": "2026-07-25T02:04:00.652Z",
  "last_updated_time": "2026-07-25T02:04:00.652Z",

  "scraped_at": "2026-07-25T12:30:00.000Z"
}

Output Fields Explained

Field	Type	Description
source	String	Source indicator, always 1688_product_search
search_query	String	The keyword used for the search
position	Integer	Position of the product in the scraper batch (1-based)
id	String	1688 internal product ID
title	String	Product title (translated to selected language)
original_title	String	Original Chinese product title
is_title_translated	Boolean	Whether the title was manually translated
category_id	String	Internal category ID
external_category_id	String	1688 external category ID
external_item_url	String	Direct link to the product on 1688.com
taobao_item_url	String	Alternative product URL
vendor_id	String	Unique vendor/store ID
vendor_name	String	Vendor username
vendor_display_name	String	Vendor display name
vendor_score	Number	Vendor reliability score
brand_id	String	Brand identifier
brand_name	String	Brand name
provider_type	String	Data provider type (always Alibaba1688)
price_cny	Number	Product price in Chinese Yuan (CNY)
margin_price_cny	Number	Margin/wholesale price in CNY
original_currency	String	Original currency code (always CNY)
price_usd	Number	Converted price in US Dollars
converted_price	String	Formatted converted price with currency sign
converted_price_without_sign	String	Converted price without currency sign
currency_sign	String	Currency sign (e.g., $)
currency_name	String	Currency name (e.g., USD)
is_deliverable	Boolean	Whether delivery pricing is available
delivery_price_cny	Number	Delivery cost in CNY
delivery_price_usd	Number	Delivery cost in USD
quantity_ranges	Array	Wholesale tier pricing with min quantity and prices
stuff_status	String	Product condition (e.g., New)
volume	Number	Sales volume
master_quantity	Number	Available stock quantity
is_sell_allowed	Boolean	Whether the product is available for sale
is_filtered	Boolean	Whether the product was filtered by the API
main_image	String	URL of the main product image
images	Array	List of product images with small, medium, and large URLs
weight_kg	Number	Product weight in kilograms
length_cm	Number	Product length in centimeters
width_cm	Number	Product width in centimeters
height_cm	Number	Product height in centimeters
features	Array	Product feature tags (e.g., Expired)
featured_values	Object	Additional product attributes as key-value pairs
created_time	String	ISO timestamp when the product was first listed
updated_time	String	ISO timestamp when the product was last updated
last_updated_time	String	ISO timestamp of the latest update
scraped_at	String	ISO timestamp of when the data was extracted

---

Sorting Options

Value	Description
UpdatedTime:Desc	Most recently updated products first (default)
UpdatedTime:Asc	Oldest updated products first
Price:Asc	Cheapest products first
Price:Desc	Most expensive products first

---

Language Support

The API supports 35+ languages for product titles and descriptions:

Code	Language	Code	Language
en	English	ja	Japanese
zh-chs	Chinese (Simplified)	ko	Korean
ru	Russian	ar	Arabic
es	Spanish	vi	Vietnamese
de	German	tr	Turkish
pt	Portuguese	th	Thai
fr	French	pl	Polish

And many more: ro, uk, fi, bg, he, hy, ka, az, ky, kk, ms, uz, no, km, ku, el, am, my, cz, khk, sah.

---

Performance & Limits

• Pagination Limit – Up to 250 pages per query (max ~10,000 products at ~40 items/page).
• Items Per Page – Each page returns approximately 40 products (determined by the API's CurrentFrameSize).
• Batching – Data is saved in batches of 10 items to prevent loss during unexpected errors.
• Rate Limiting – Built-in 1.5-second delay between page requests for optimal throughput.
• Concurrency – Automatic key rotation and retry logic for smooth, uninterrupted performance.

---

FAQ

• Q: Where does the data come from?
  • All data is fetched dynamically from 1688.com's product database.
• Q: Can I get prices in USD?
  • Yes! The API automatically converts CNY prices to USD. Both price_cny and price_usd are included in every product result.
• Q: What are quantity ranges?
  • 1688 is a wholesale marketplace, so many products have tier pricing. The quantity_ranges field shows price breaks based on order quantity (e.g., 1-9 units at ¥100, 10+ units at ¥80).
• Q: How do I filter by category?
  • Use the categoryId input parameter with a valid 1688 category ID. You can discover category IDs from the product results.
• Q: Can I search in Chinese?
  • Yes! You can enter Chinese keywords in the query field. Set language to zh-chs for Chinese results, or keep it as en for translated titles.
• Q: What data formats can I export?
  • Apify supports exporting results as JSON, CSV, Excel (XLSX), XML, HTML, and RSS.

---

Troubleshooting

Issue	Cause	Solution
"No search query provided"	Empty or missing query	Enter a valid search term in the input
No products found	Keyword is too specific or has no matching products	Broaden the search query or remove filters
API returned error	Unexpected API response or invalid parameters	Check the error message and retry. Verify your parameters
Slow execution	Many pages requested	Reduce maxPages to run faster
Rate limit exceeded	Too many concurrent requests	Wait a few minutes and try again

---

Why Choose This Actor?

• Keyword-based 1688.com product search
• Real-time pricing in both CNY and USD
• Wholesale tier pricing (quantity ranges)
• Vendor info with reliability scores
• Multi-language support (35+ languages)
• Category and vendor filtering
• Physical product parameters (weight, dimensions)
• Multiple image sizes (small, medium, large)
• Downloadable as CSV, Excel, JSON, XML, or HTML

---

Tags

1688 scraper, 1688 product data, alibaba china scraper, china wholesale scraper, 1688 price tracker, 1688 api, wholesale product search, chinese marketplace scraper, b2b product data, supplier data extraction, 1688 product search, apify actor

---

Get Started Now

1. Enter the Search Query (e.g., LED light)
2. Choose the Language (e.g., English)
3. Choose the Sort Order (e.g., Recently Updated)
4. Optionally set Category ID, Vendor Name, or Price Range filters
5. Set the Maximum Pages to scrape
6. Click Start to run the scraper
7. Export your data in JSON, CSV, or Excel format
8. Click "Try for free" to test the actor

---

Built using Apify Platform | Optimized for Performance & Reliability