Taobao & 1688 Product API Technical Overview and JSON Response Reference
Taobao & 1688 Product API Technical Overview and JSON Response Reference
1. Topic Overview
2. API Introduction
taobao.item.get: Obtain basic product details
taobao.item.get_full: Obtain full product data (SKU, images, description, promotion)
taobao.items.onsale.get: Get all on-sale products from a store
1688.item.get: Get 1688 wholesale product information
3. Core Technical Features
Protocol: HTTPS
Data format: JSON / XML (JSON is recommended for enterprise development)
Authentication: AppKey + AppSecret MD5 signature verification
Data feature: structured, standardized, stable version iteration
Access control: QPS limit, frequency control, official traffic protection
4. Enterprise Application Scenarios
Cross-store and cross-platform product distribution (dropshipping)
Enterprise ERP commodity data synchronization
Real-time price and inventory monitoring system
Competitor product data analysis
E-commerce big data statistics and automated report generation
5. Standard JSON Return Reference (Enterprise Version)
{
"item_get_response": {
"item": {
"num_iid": "680123456789",
"title": "2026 Summer New Casual Cotton Short Sleeve T-shirt",
"price": "89.00",
"promotion_price": "59.00",
"num": 520,
"sales": 12580,
"cid": 50015261,
"category_name": "Women's Clothing > T-shirt",
"pic_url": "https://img.taobao.com/xxx.jpg",
"location": "Guangdong, Guangzhou",
"nick": "Official Flagship Store",
"modified_time": "2026-05-20 15:30:10",
"sku_list": {
"sku": [
{
"sku_id": "123456789001",
"properties_name": "White / L",
"price": "59.00",
"quantity": 120
},
{
"sku_id": "123456789002",
"properties_name": "Black / XL",
"price": "59.00",
"quantity": 95
}
]
}
},
"request_id": "2026052015301000123"
}
}6. Core Field Explanation
num_iid: Unique product ID, the primary key for data synchronization
title: Product official title
price / promotion_price: Original price and discount price
num: Current stock quantity
sales: Cumulative sales volume
pic_url: Main product image URL
sku_list: Multi-specification price and inventory data
modified_time: Last update time for incremental synchronization
request_id: Full-link tracking ID for error troubleshooting
7. Enterprise Stability Guarantee Strategy
Control QPS frequency to avoid platform flow restriction
Retry mechanism for network timeout and 5xx errors
Strict data validation for price, stock and fields
Redis cache optimization to reduce API pressure
Incremental update based on modified_time
Full log recording and abnormal alarm monitoring
