京东商品详情API技术说明文档（jd.item.get｜含原始 JSON + 落地结构化模型）

原创

wx19970108018

发布于 2026-06-17 16:30:40

1520

文章被收录于专栏：经验经验

京东商品详情 API jd.item.get 完整技术说明文档

文档概述

接口名称：jd.item_get（京东商品详情API）

接口用途：根据商品 SKU ID/Item ID 查询自营 / 第三方店铺完整商品元数据，支撑 ERP 同步、商品中台、竞品监控、店铺铺货、数据大屏等企业级场景

调用网关： c0b.cc/R4rbK2

传输协议：HTTPS POST/GET

数据格式：JSON（默认）、XML 可选

接口版本：v2.0

一、接口基础信息

1.1 公共请求参数（所有调用必传）

参数名	类型	是否必填	说明
app_key	String	是	应用密钥，开放平台创建应用获取
method	String	是	固定值：jd.item.get
timestamp	String	是	北京时间 yyyy-MM-dd HH:mm:ss，签名校验防重放
v	String	是	接口版本，固定 2.0
format	String	否	返回格式：json/xml，默认 json
sign	String	是	MD5 大写签名，签名规则：app_secret + 所有参数按key升序拼接 + app_secret 后 MD5
access_token	String	店铺授权场景必填	OAuth 店铺授权令牌，服务商托管店铺必须携带

1.2 业务入参（核心查询参数）

参数名	类型	必填	示例	说明
skuId	Long	二选一必填	100012345678	单品 SKU 编号（精准单规格查询，推荐）
itemId	Long	二选一必填	1001234567	商品主商品 ID（多 SKU 套装商品入口 ID）
fields	String	可选	skuId,title,price,stock,skuList,image,param	字段过滤，逗号分隔，不传返回全量字段，减少返回体积

1.3 标准请求示例（URL 拼接参数）

http

POST https://api.jd.com/routerjson
Content-Type: application/x-www-form-urlencoded

app_key=YOUR_APP_KEY
&method=jd.item.get
&timestamp=2026-06-17 16:30:00
&v=2.0
&format=json
&skuId=100012345678
&fields=skuId,title,brand,category,priceInfo,stockInfo,skuList,imageList,paramList,salesInfo,shopInfo
&sign=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
&access_token=YOUR_ACCESS_TOKEN

1.4 签名生成伪代码（Python）

python

import hashlib

def get_jd_sign(params: dict, app_secret: str) -> str:
    # 1. 剔除sign参数
    sign_params = {k:v for k,v in params.items() if k != "sign"}
    # 2. 按键名升序拼接key+value
    sorted_items = sorted(sign_params.items(), key=lambda x: x[0])
    raw_str = "".join([f"{k}{v}" for k, v in sorted_items])
    # 3. 前后拼接app_secret，MD5大写
    sign_source = f"{app_secret}{raw_str}{app_secret}"
    md5_val = hashlib.md5(sign_source.encode("utf-8")).hexdigest().upper()
    return md5_val

二、原始完整返回 JSON 示例（jd.item.get）

json

{
    "jd_item_get_response": {
        "code": 0,
        "msg": "success",
        "item": {
            "skuId": 100012345678,
            "itemId": 1001234567,
            "title": "华为Mate 60 Pro 12GB+512GB 雅丹黑 5G智能手机",
            "shortTitle": "Mate60 Pro 雅丹黑",
            "saleState": 1,
            "publishTime": "2025-09-10 08:30:00",
            "offlineTime": "",
            "brand": {
                "brandId": 1000123,
                "brandName": "华为(HUAWEI)",
                "brandLogo": "https://img10.360buyimg.com/brand/logo/huawei.png"
            },
            "category": {
                "cid1": 1713,
                "cid1Name": "手机通讯",
                "cid2": 1714,
                "cid2Name": "手机",
                "cid3": 1715,
                "cid3Name": "智能手机"
            },
            "priceInfo": {
                "marketPrice": "6999.00",
                "jdPrice": "6499.00",
                "promotionPrice": "6299.00",
                "memberPrice": "6199.00",
                "currency": "CNY",
                "promotionList": [
                    {
                        "promotionId": 98765,
                        "promotionName": "满6000减200",
                        "startTime": "2026-06-01 00:00:00",
                        "endTime": "2026-06-30 23:59:59",
                        "promotionType": "full_reduce"
                    }
                ]
            },
            "stockInfo": {
                "totalStockNum": 326,
                "stockState": 33,
                "stockDesc": "现货有货",
                "limitBuyNum": 2,
                "isPreSale": false,
                "preSaleDesc": ""
            },
            "imageInfo": {
                "mainImg": "https://img10.360buyimg.com/n1/jfs/t1/200000/30/32000/120000/abcdef123/1a2b3c4d.jpg",
                "imageList": [
                    "https://img10.360buyimg.com/n1/jfs/t1/200000/30/32000/120000/abcdef123/1a2b3c4d.jpg",
                    "https://img10.360buyimg.com/n1/jfs/t1/200000/30/32000/120001/abcdef123/2a2b3c4d.jpg",
                    "https://img10.360buyimg.com/n1/jfs/t1/200000/30/32000/120002/abcdef123/3a2b3c4d.jpg"
                ],
                "detailHtml": "<html>商品详情图文富文本...</html>"
            },
            "paramList": [
                {"name": "品牌", "value": "华为"},
                {"name": "型号", "value": "Mate 60 Pro"},
                {"name": "运行内存", "value": "12GB"},
                {"name": "机身存储", "value": "512GB"},
                {"name": "屏幕尺寸", "value": "6.8英寸"},
                {"name": "机身颜色", "value": "雅丹黑"}
            ],
            "skuList": [
                {
                    "subSkuId": 100012345678,
                    "skuTitle": "华为Mate 60 Pro 12GB+512GB 雅丹黑",
                    "propsText": "颜色:雅丹黑;内存:12GB+512GB",
                    "skuPrice": "6299.00",
                    "skuStock": 126,
                    "skuImg": "https://img10.360buyimg.com/n1/sku_black.jpg"
                },
                {
                    "subSkuId": 100012345679,
                    "skuTitle": "华为Mate 60 Pro 12GB+512GB 白沙银",
                    "propsText": "颜色:白沙银;内存:12GB+512GB",
                    "skuPrice": "6299.00",
                    "skuStock": 200,
                    "skuImg": "https://img10.360buyimg.com/n1/sku_white.jpg"
                }
            ],
            "salesInfo": {
                "totalSales": 126800,
                "monthSales": 3620,
                "commentCount": 89600,
                "goodCommentRate": "98.6%",
                "score": 4.9
            },
            "shopInfo": {
                "shopId": 1000888888,
                "shopName": "华为京东自营官方旗舰店",
                "shopType": "self",
                "shopScore": 4.95,
                "province": "北京市"
            },
            "serviceInfo": {
                "supportJdLogistics": true,
                "sevenDayReturn": true,
                "warrantyYear": "1年全国联保",
                "supportInvoice": true
            }
        }
    }
}

2.1 异常返回 JSON 示例（SKU 不存在）

json

{
    "error_response": {
        "code": 30001,
        "msg": "skuId不存在，请检查商品编号"
    }
}

三、顶层 & 核心字段完整说明

3.1 顶层返回结构

正常返回：jd_item_get_response 对象
- code：0 = 成功；非 0 = 业务异常码
- msg：返回描述文本
- item：商品完整详情主体对象
异常返回：error_response 对象
- code：错误码
- msg：错误原因文案

3.2 item 主对象一级字段

字段	类型	说明
skuId	Long	当前查询单品 SKU 唯一 ID
itemId	Long	商品主 ID（多规格商品父 ID）
title	String	完整商品标题
shortTitle	String	短标题（前端列表展示）
saleState	Int	上架状态：1 上架 0 下架
publishingTime	String	商品首次上架时间
offlineTime	String	下架时间，空 = 在售
brand	Object	品牌子对象
category	Object	三级分类对象
priceInfo	Object	价格、促销集合
stockInfo	Object	库存、限购、预售
imageInfo	Object	主图、轮播图、详情富文本
paramList	Array	商品规格参数数组
skuList	Array	全规格 SKU 列表
salesInfo	Object	销量、评价、评分
shopInfo	Object	店铺信息（自营 / 第三方）
serviceInfo	Object	售后、物流、发票服务

3.3 子对象字段拆解（建模核心）

3.3.1 brand 品牌

brandId：品牌 ID
brandName：品牌全称
brandLogo：品牌 Logo 地址

3.3.2 category 三级类目

cid1/cid1Name：一级类目

cid2/cid2Name：二级类目

cid3/cid3Name：三级类目

3.3.3 priceInfo 价格模块

marketPrice：专柜原价

jdPrice：京东日常售价

promotionPrice：当前活动到手价

memberPrice：PLUS 会员价

promotionList：促销活动数组（满减 / 优惠券 / 秒杀）

3.3.4 stockInfo 库存模块

totalStockNum：总库存数量

stockState：33 = 有货，34 = 无货，35 = 预售

limitBuyNum：单人限购件数

isPreSale：是否预售

preSaleDesc：预售发货说明

3.3.5 imageInfo 素材模块

mainImg：首图

imageList：轮播图数组

detailHtml：商品详情富文本 HTML（含图文）

3.3.6 skuList 多规格 SKU 数组

subSkuId：子 SKU 编号

skuTitle：规格标题

propsText：规格键值文本（颜色；尺寸；内存）

skuPrice：单品售价

skuStock：单品库存

skuImg：规格对应图片

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

开发经验

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

开发经验

#京东商品详情API

#京东数据采集

登录后参与评论

0 条评论

热度