Introduction
As one of China’s largest and most trusted e-commerce ecosystems, JD.com operates a robust open API platform that powers millions of merchant ERP systems, supply chain management tools, and third-party data integration workflows. The official product detail interface is the core technical gateway for developers to access structured, real-time SKU data, covering JD’s unique logistics system, tiered pricing rules, and official inventory synchronization logic. Unlike generic web scraping solutions, this official RESTful API guarantees data accuracy, anti-scraping stability, and full compliance with JD’s developer terms, making it the industry standard for production-level B2C and B2B e-commerce integration. This guide breaks down the full technical architecture, mandatory request parameters, and provides a production-grade standard JSON response reference to help developers quickly build stable JD data integration pipelines.
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 |
|
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" } } } }
