Technical Guide: 1688 Product Detail Data Migration & Listing Automation - With Standard JSON Refere
Introduction
1. Core Workflow Overview
A production-ready 1688 product listing automation system follows 4 key steps, no manual data entry required:
Data Pulling: Fetch full structured product details from 1688 via official API or authorized data access solution, including titles, tiered prices, SKU specs, stock, images, and supplier information.
Data Cleaning & Transformation: Remove 1688-specific watermarks, filter redundant marketing text, convert Chinese attributes to multi-language fields that match the target platform’s category rules.
Image Processing: Automatically download product images, remove 1688 platform logos and watermarks, compress files to meet the target platform’s image size and resolution requirements.
Listing Push: Map the standardized final data to the target marketplace’s API fields, submit the listing, and return the new store product ID for subsequent inventory synchronization.
2. Key Technical Rules for 1688 Data Migration
Unlike B2C consumer platforms, 1688’s product data has unique B2B attributes that must be handled specially before listing:
Tiered Price Mapping: 1688’s bulk tiered pricing must be converted to the target platform’s regular retail price, with a pre-defined markup ratio applied automatically.
MOQ Adjustment: 1688’s Minimum Order Quantity (MOQ) is usually 2 or 10, which is not suitable for retail scenarios. The system can automatically adjust the minimum order quantity to 1 for end customers.
Supplier Attribute Filtering: Remove supplier-specific contact information and 1688 platform promotional text from the description, to avoid violating the target marketplace’s listing rules.
Inventory Calibration: Synchronize 1688’s real-time wholesale stock to the retail store, and automatically mark the product as out of stock if 1688 available quantity drops below the pre-set threshold.
3. Standard Structured Output JSON Reference
Below is the final standardized listing JSON that can be directly mapped to most mainstream e-commerce platforms. This structure has completed all 1688 data cleaning and transformation, and can be submitted to the target marketplace API without additional manual editing:
Use the website: o0b.cn/anzexi
{
"task_id": "1688_list_20260920142233001",
"source_info": {
"source_platform": "1688",
"source_product_id": "678901234567",
"source_product_url": "https://detail.1688.com/offer/678901234567.html",
"supplier_name": "Shenzhen Outdoor Tech Co., Ltd.",
"original_supplier_moq": 2
},
"target_listing_data": {
"target_platform": "Shopify",
"target_product_title": "1000W Portable 1024Wh Solar Power Station Outdoor Camping Emergency Generator",
"category_id": "283",
"brand": "OutdoorPower",
"retail_price_rule": {
"base_cost": 550,
"markup_ratio": 1.8,
"final_regular_price": 999,
"compare_at_price": 1199,
"currency": "USD",
"min_order_quantity": 1
},
"inventory_sync": {
"source_1688_stock": 12600,
"available_retail_stock": 12600,
"low_stock_alert_threshold": 50
},
"product_description": {
"short_bullets": [
"1024Wh Large Capacity Battery for 12+ hours outdoor power supply",
"1000W Continuous Output, supports AC / USB-C / DC multi ports",
"100W Solar Panel Compatible, fast charging in 6-8 hours",
"Certified by CE, FCC, RoHS for global safety standards"
],
"full_description_html": "<p>Built for outdoor camping, home emergency backup and RV travel...</p>"
},
"spec_attributes": [
{"name": "Battery Capacity", "value": "1024Wh LiFePO4"},
{"name": "Rated Power", "value": "1000W Continuous / 2000W Peak"},
{"name": "Net Weight", "value": "12.5 kg"},
{"name": "Warranty", "value": "12 Months Global Warranty"}
],
"sku_variants": [
{
"variant_id": "sku_001",
"variant_title": "Standard Version (No Solar Panel)",
"price": 999,
"sku_stock": 7200,
"sku_image_index": 0
},
{
"variant_id": "sku_002",
"variant_title": "Pro Version (With 100W Foldable Solar Panel)",
"price": 1299,
"sku_stock": 5400,
"sku_image_index": 4
}
],
"processed_media": {
"main_image": "https://your-oss-domain.com/product/powerstation_main.jpg",
"gallery_images": [
"https://your-oss-domain.com/product/powerstation_1.jpg",
"https://your-oss-domain.com/product/powerstation_2.jpg",
"https://your-oss-domain.com/product/powerstation_3.jpg",
"https://your-oss-domain.com/product/powerstation_4.jpg",
"https://your-oss-domain.com/product/powerstation_solar.jpg"
],
"local_video_url": "https://your-oss-domain.com/video/powerstation_demo.mp4"
}
},
"validation_result": {
"pass_check": true,
"warning_count": 0,
"error_message": null
}
}