Technical Deep Dive: 1688.com Product Detail API - Full Guide & Standard JSON Reference
Introduction
1. Core Interface Basic Information
The 1688 Product Detail API is a production-grade RESTful service hosted on Alibaba’s B2B open platform infrastructure, optimized for high-frequency industrial and wholesale business scenarios.
Item | Specification |
Official API Name | alibaba.product.get (Get Full Wholesale Product Details) |
Communication Protocol | HTTPS POST (Recommended) / GET |
Default Data Format | JSON (XML is supported for legacy enterprise ERP systems) |
Official Gateway Endpoint | https://gw.open.1688.com/openapi |
Authentication Mechanism | AppKey + AppSecret + OAuth 2.0 AccessToken + HMAC-SHA1 Signature |
Typical Use Cases | Wholesale product sourcing, tiered price monitoring, supplier qualification verification, dropshipping inventory synchronization, cross-border e-commerce product listing automation |
2. Full Request Parameter Breakdown
Calling this API strictly follows 1688 Open Platform’s proprietary signature specification. All non-empty parameters must be sorted lexicographically and encrypted with the AppSecret to generate a valid, tamper-proof signature value.
2.1 Mandatory Public Gateway Parameters
These parameters are required for every 1688 API call, used for platform authentication, permission validation and request tracing:
Parameter Name | Type | Required | Description |
app_key | String | Yes | Unique application identifier, obtained after enterprise developer verification on 1688 Open Platform |
method | String | Yes | Fixed as alibaba.product.get to specify the target product detail interface |
access_token | String | Yes | OAuth 2.0 authorized token, which carries the requester’s permission scope (public data / enterprise exclusive price) |
timestamp | String | Yes | East 8 timezone timestamp formatted as yyyy-MM-dd HH:mm:ss, used to prevent replay attacks |
v | String | Yes | API protocol version, the current stable production version is 2.0 |
sign_method | String | Yes | Signature algorithm, hmac-sha1 is the platform standard for all B2B interfaces |
sign | String | Yes | Final encrypted signature value generated by AppSecret and sorted parameters |
2.2 Business Core Parameters
These parameters control the granularity and scope of the wholesale product data returned:
Parameter Name | Type | Required | Description |
productId | Long | Yes | 1688 unique product ID (Offer ID), extracted directly from the product detail page URL |
fields | String | Yes | Custom return field list, for example productId,title,price,sku,supplier. Explicitly specifying required fields can reduce response latency by over 40% |
needCargoInfo | Boolean | No | Default false. Set to true to return real-time warehouse stock distribution and logistics delivery information |
includeExclusivePrice | Boolean | No | Default false. Only authorized enterprise buyers can set this to true to view negotiated exclusive contract prices |
3. Standard Production JSON Response Reference
Below is a standard full JSON response that strictly follows 1688’s official B2B interface return specification. This structure includes all unique high-value wholesale business fields, and can be directly used for debugging and enterprise ERP system docking:
Use the website: o0b.cn/anzexi
{
"alibaba_product_get_response": {
"code": 0,
"msg": "success",
"request_id": "1688_req_20260918102233456",
"data": {
"product_id": 678901234567,
"subject": "Factory Direct 1000W Portable Outdoor Power Station 220V Solar Generator for Camping",
"supplier_info": {
"member_id": "123456789",
"company_name": "Shenzhen New Energy Tech Co., Ltd.",
"supplier_level": "A+",
"gold_supplier_years": 8,
"transaction_rate": "98.5%",
"main_industry": "Portable Power Station"
},
"price_info": {
"unit": "piece",
"currency": "CNY",
"price_tiers": [
{"min_quantity": 1, "max_quantity": 9, "price": "689.00"},
{"min_quantity": 10, "max_quantity": 99, "price": "620.00"},
{"min_quantity": 100, "max_quantity": null, "price": "550.00"}
],
"exclusive_contract_price": "520.00",
"moq": 1
},
"stock_info": {
"total_available_stock": 15600,
"stock_status": "instock",
"warehouse_distribution": [
{"warehouse_code": "SZ001", "location": "Shenzhen", "stock": 9200, "lead_time_hours": 48},
{"warehouse_code": "GZ002", "location": "Guangzhou", "stock": 6400, "lead_time_hours": 72}
]
},
"product_attrs": [
{"attribute_name": "Battery Capacity", "attribute_value": "1024Wh"},
{"attribute_name": "Rated Power", "attribute_value": "1000W"},
{"attribute_name": "Interface Type", "attribute_value": "USB-A / Type-C / AC Outlet"},
{"attribute_name": "Certification", "attribute_value": "CE, FCC, RoHS, PSE"}
],
"sku_list": [
{
"sku_id": 987654321001,
"specification": "Standard Version (No Solar Panel)",
"sku_price": "689.00",
"sku_stock": 8600
},
{
"sku_id": 987654321002,
"specification": "Pro Version (With 100W Solar Panel)",
"sku_price": "899.00",
"sku_stock": 7000
}
],
"media_resources": {
"main_image": "https://cbu01.alicdn.com/img/ibank/2026/xxx/1.jpg",
"image_gallery": [
"https://cbu01.alicdn.com/img/ibank/2026/xxx/1.jpg",
"https://cbu01.alicdn.com/img/ibank/2026/xxx/2.jpg",
"https://cbu01.alicdn.com/img/ibank/2026/xxx/3.jpg"
],
"detail_video": "https://cloud.video.1688.com/play/xxx.mp4"
},
"trade_info": {
"payment_terms": "T/T, L/C, Alibaba Trade Assurance",
"shipping_terms": "FOB Shenzhen",
"supply_capability": "50000 pieces / Month",
"customization_support": true
}
}
}
}