Technical Deep Dive: JD.com Product Detail API - Full Guide & Standard JSON Reference
Introduction
1. Core Interface Basic Information
The JD Product Detail API is a high-performance RESTful service hosted on JD’s global open platform infrastructure, optimized for high-frequency commercial data access scenarios.
Item | Specification |
Official API Name | jd.product.detail.get (Get Full JD Product Details) |
Communication Protocol | HTTPS POST (Recommended) / GET |
Default Data Format | JSON |
Official Gateway Endpoint | https://api.jd.com/routerjson |
Authentication Mechanism | AppKey + AppSecret + OAuth 2.0 AccessToken + MD5 Signature |
Typical Use Cases | JD store product synchronization, real-time price monitoring, inventory status verification, Jingdong Logistics distribution pre-estimation, competitor analysis and selection |
2. Full Request Parameter Breakdown
Calling this API strictly follows JD Open Platform’s official TOP-style 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 JD 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 JD Open Platform |
method | String | Yes | Fixed as jd.product.detail.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 / merchant exclusive operation permission) |
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 1.0 |
sign_method | String | Yes | Signature algorithm, md5 is the platform standard for all open 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 JD product data returned:
Parameter Name | Type | Required | Description |
skuId | Long | Yes | JD unique SKU ID, extracted directly from the product detail page URL |
fields | String | Yes | Custom return field list, for example skuId,name,price,stock. Explicitly specifying required fields can reduce response latency by over 35% |
needJdLogistics | Boolean | No | Default false. Set to true to return real-time JD self-operated warehouse stock distribution and 211 time-limited delivery information |
needPromotion | Boolean | No | Default false. Set to true to pull all ongoing flash sale, coupon and full reduction activity data of the product |
3. Standard Production JSON Response Reference
Below is a standard full JSON response that strictly follows JD’s official interface return specification. This structure includes all unique high-value fields of JD’s e-commerce system, and can be directly used for debugging and enterprise system docking:
Use the website: o0b.cn/anzexi
{
"jd_product_detail_get_response": {
"code": 0,
"msg": "success",
"request_id": "jd_req_20260919113044789",
"data": {
"sku_id": 100012345678,
"spu_id": 100087654321,
"name": "Apple MacBook Pro 14-inch M4 Pro Chip 18GB RAM 512GB SSD Space Black",
"brand_info": {
"brand_id": 1342,
"brand_name": "Apple",
"is_self_operated_brand": true
},
"price_info": {
"current_price": 14999.00,
"original_price": 16999.00,
"discount_rate": 12,
"currency": "CNY",
"is_jd_price_protection": true,
"promotion_list": [
{"promotion_type": "full_reduction", "desc": "Minus 500 when order over 10000"},
{"promotion_type": "coupon", "desc": "Exclusive 200 yuan coupon for PLUS members"}
]
},
"stock_info": {
"total_available_stock": 8600,
"stock_status": "in_stock",
"is_jd_self_operated": true,
"warehouse_distribution": [
{"warehouse_code": "BJ001", "city": "Beijing", "stock": 3200, "delivery_type": "211_timeline"},
{"warehouse_code": "SH002", "city": "Shanghai", "stock": 2800, "delivery_type": "211_timeline"},
{"warehouse_code": "GZ003", "city": "Guangzhou", "stock": 2600, "delivery_type": "next_day"}
]
},
"specifications": [
{"attr_name": "Screen Size", "attr_value": "14.2 inches Liquid Retina XDR"},
{"attr_name": "Chip", "attr_value": "Apple M4 Pro"},
{"attr_name": "Memory", "attr_value": "18 GB Unified Memory"},
{"attr_name": "Storage", "attr_value": "512 GB SSD"},
{"attr_name": "Warranty", "attr_value": "1 Year Official Warranty + JD Home On-site Service"}
],
"sku_list": [
{
"sub_sku_id": 100012345679,
"spec_text": "Space Black / 18GB / 512GB",
"sku_price": 14999.00,
"sku_stock": 4500
},
{
"sub_sku_id": 100012345680,
"spec_text": "Silver / 24GB / 1TB",
"sku_price": 18999.00,
"sku_stock": 4100
}
],
"media_resources": {
"main_image": "https://img14.360buyimg.com/n1/jfs/t1/xxx/main.jpg",
"image_gallery": [
"https://img14.360buyimg.com/n1/jfs/t1/xxx/1.jpg",
"https://img14.360buyimg.com/n1/jfs/t1/xxx/2.jpg",
"https://img14.360buyimg.com/n1/jfs/t1/xxx/3.jpg"
],
"detail_video": "https://cdn.jd.com/video/play/xxx.mp4"
},
"service_info": {
"support_jd_installment": true,
"support_jd_delivery": true,
"return_policy": "7 days no reason return, 15 days exchange",
"warranty_service": "JD Home On-site Support"
}
}
}
}