京东JD商品详情API返回值案例：商品数据驱动的电商决策

最新推荐文章于 2026-06-23 21:03:17 发布

原创最新推荐文章于 2026-06-23 21:03:17 发布 · 1.2k 阅读

29 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#大数据 #java #python #django #pygame

电商api 同时被 2 个专栏收录

545 篇文章

订阅专栏

api

422 篇文章

订阅专栏

京东JD商品详情API是一个强大的工具，它允许开发者获取京东平台上商品的详细信息，从而帮助电商企业做出更为精准和明智的决策。以下是一个基于商品数据驱动的电商决策案例，展示了如何利用京东JD商品详情API的返回值来推动业务增长。

场景设定

假设我们是一家电商公司，正在寻找新的商品以扩充我们的产品线，并希望提高销售额和客户满意度。为了实现这一目标，我们决定使用京东JD商品详情API来获取潜在商品的详细信息，并基于这些数据做出决策。

步骤一：注册与认证

首先，我们在京东开放平台注册账号，并完成实名认证。通过实名认证后，我们获得了API调用权限，并创建了应用以获取API密钥。

步骤二：获取API密钥

在京东开放平台中，我们为创建的应用申请了API密钥。这个密钥是我们调用京东JD商品详情API的凭证，需要妥善保管。

步骤三：调用API并获取数据

我们使用API密钥和要查询的商品ID，发送请求到京东JD商品详情API接口。API返回了一个包含多个字段的JSON对象，其中包括商品的名称、品牌、价格、销量、评价等详细信息。

步骤四：数据处理与分析

我们对获取的商品数据进行了处理和分析，以了解这些商品的特性和市场表现。我们关注的关键指标包括：

商品销量：评估商品的市场受欢迎程度。
用户评价：了解用户对商品的满意度和反馈。
价格变动：观察商品价格的变化趋势，以预测市场动向。
竞争情况：分析同类商品的竞争态势，确定潜在的竞争优势。

步骤五：基于数据做出决策

根据对商品数据的分析，我们做出了以下决策：

选品决策：我们选择了销量高、评价好、价格合理的商品作为潜在的新品。这些商品具有较高的市场潜力和客户满意度，有助于提升我们的销售额和品牌形象。
定价策略：我们根据同类商品的价格水平和市场趋势，为新品制定了合理的定价策略。这有助于确保我们在市场竞争中保持优势，同时满足消费者对价格的期望。
营销策略：基于商品特点和用户评价，我们制定了有针对性的营销策略。例如，针对用户反馈中的痛点问题，我们可以提供个性化的解决方案或增值服务，以提高客户满意度和忠诚度。
库存管理：根据商品的销量和库存情况，我们优化了库存管理水平。通过合理预测销量和制定补货计划，我们确保了商品的供应稳定性，降低了库存积压和缺货风险。

jd.item_get

公共参数

请求地址: https://api-gw.onebound.cn/jd/item_get

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=10335871600

参数说明：num_iid:JD商品ID

响应参数

Version: Date:

名称	类型	必须	示例值	描述
item	item[]	0		获得JD商品详情

响应示例

{
	"item": {
	    "num_iid": "100061393554",
	    "title": "回力外套男连帽开衫卫衣男春秋季潮流宽松休闲简约高街针织运动上衣",
	    "desc_short": "",
	    "price": 99,
	    "total_price": "",
	    "suggestive_price": "",
	    "orginal_price": 99,
	    "nick": "回力服饰京东自营旗舰店",
	    "num": 2400,
	    "detail_url": "https://item.jd.com/100061393554.html",
	    "pic_url": "http://img13.360buyimg.com/n12/jfs/t1/102528/7/43477/54986/654886adF5942d5a8/8e0604d47fafa774.jpg",
	    "brand": "回力",
	    "brandId": "",
	    "rootCatId": "",
	    "cid": 9732,
	    "desc": "<img src=\"http://img30.360buyimg.com/sku/jfs/t1/141528/9/38969/148435/64f9daa3F47ad4db1/1f70c526189c7b0a.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/86458/36/42802/42878/64f9daa3F0f3c32ed/2c1f5f38c34417f5.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/108848/9/42926/31906/64f9daa3F9a3a76f6/ebcef65f6cd4dcc2.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/116390/24/42377/66764/64f9daa3Fe2819550/6c8bebe5f123ab1e.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/97506/30/32691/48491/64f9daa3Ff13fc8d6/28981ecfac62a699.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/172839/6/40006/52968/64f9daa3Fc685c70c/c27ba345b1d2e633.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/187653/28/37655/76702/64f9daa3F98b3ddc9/2249b4c88c638d37.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/102767/37/38077/131849/64f9daa3F56a039ec/8d3ad5cc32e44b82.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/46794/36/27461/108749/64f9daa3Fbc6530e6/a386b772c539a9ca.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/189583/15/40332/109556/652e3579F2172cb50/9af850e5930e29d7.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/140302/14/40517/88372/64f9daa3F66ddc57f/36793a81c9dcc236.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/235758/38/36/59760/652e3348F66bd14ac/81e9313cd4a90169.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/178474/30/37529/94689/64f9daa3Fde599f7a/ee302d1e087c1a13.jpg\" /><img src=\"http://img30.360buyimg.com/sku/jfs/t1/178138/32/36857/299260/64f9daa3F3de29b1b/65db1bd588134e4e.jpg\" /><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.65f7a44a42484&p=1778787634&k=i_key&t=1710728267\" style=\"display:none\" />",
	    "item_imgs": [
	        {
	            "url": "http://img13.360buyimg.com/n12/jfs/t1/102528/7/43477/54986/654886adF5942d5a8/8e0604d47fafa774.jpg"
	        },
	        {
	            "url": "http://img13.360buyimg.com/n12/jfs/t1/203326/26/40643/58766/64f9d9bdF42d299d2/c63a7a1e2d733d9b.jpg"
	        },
	        {
	            "url": "http://img13.360buyimg.com/n12/jfs/t1/6009/33/22617/70571/64e88b13F0e150eff/ac19e310c2a05b18.jpg"
	        },
	        {
	            "url": "http://img13.360buyimg.com/n12/jfs/t1/139357/10/38389/58281/64ce1317F463fc9a5/22ebdb9d5324f434.jpg"
	        },
	        {
	            "url": "http://img13.360buyimg.com/n12/jfs/t1/96651/35/40854/75683/64ce1317F666a7db3/08355c841c27427b.jpg"
	        },
	        {
	            "url": "http://img13.360buyimg.com/n12/jfs/t1/93068/25/41957/117547/64ce1317F161a9be8/0c728de179b4c4ff.jpg"
	        },
	        {
	            "url": "http://img13.360buyimg.com/n12/jfs/t1/196684/19/35713/46717/64ce1317F67ca16e5/5390ae8d8603a4a2.jpg"
	        },
	        {
	            "url": "http://img13.360buyimg.com/n12/jfs/t1/199352/3/38942/38665/64ce1317F50c7bacd/2b0098766af6c0fe.jpg"
	        },
	        {
	            "url": "http://img13.360buyimg.com/n12/jfs/t1/93213/19/40402/77871/64ce1318F9d7ecfef/f0841c6e94c3c4bb.jpg"
	        }
	    ],
	    "item_weight": "",
	    "post_fee": "",
	    "freight": "",
	    "express_fee": "",
	    "ems_fee": "",
	    "shipping_to": "",
	    "video": {
	        "url": "https://jvod.300hu.com/vod/product/64f404d7-7400-47d5-aa5a-14344773cfd1/f88d6b0d860a4f49b6df21e30cdbfeb9.mp4?source=2&h265=h265/113074/31caa5da0c77447cabe97ebf3db02125.mp4"
	    },
	    "sample_id": "",
	    "props_name": "47876:47982:尺码:M/158-165（建议95-110斤）;47876:48224:尺码:L/165-170（建议111-125斤）;47876:48347:尺码:XL/170-175（建议126-140斤）;47876:51182:尺码:2XL/170-175（建议141-155斤）;47876:51290:尺码:3XL/175-180（建议156-165斤）;47876:51415:尺码:4XL/178-183（建议166-175斤）;47876:47982:尺码:M/158-165（建议95-110斤）;47876:48224:尺码:L/165-170（建议111-125斤）;47876:48347:尺码:XL/170-175（建议126-140斤）;47876:51182:尺码:2XL/170-175（建议141-155斤）;47876:51290:尺码:3XL/175-180（建议156-165斤）;47876:51415:尺码:4XL/178-183（建议166-175斤）;47876:48224:尺码:L/165-170（建议111-125斤）;47876:51182:尺码:2XL/170-175（建议141-155斤）;47876:51415:尺码:4XL/178-183（建议166-175斤）;47876:48347:尺码:XL/170-175（建议126-140斤）;47876:51182:尺码:2XL/170-175（建议141-155斤）;47876:48224:尺码:L/165-170（建议111-125斤）;47876:51290:尺码:3XL/175-180（建议156-165斤）;47876:51415:尺码:4XL/178-183（建议166-175斤）;47876:47982:尺码:M/158-165（建议95-110斤）;47876:51290:尺码:3XL/175-180（建议156-165斤）;47876:47982:尺码:M/158-165（建议95-110斤）;47876:48347:尺码:XL/170-175（建议126-140斤）;47918:47989:颜色:黑色;47918:47989:颜色:黑色;47918:47989:颜色:黑色;47918:47989:颜色:黑色;47918:47989:颜色:黑色;47918:47989:颜色:黑色;47918:51511:颜色:灰色;47918:51511:颜色:灰色;47918:51511:颜色:灰色;47918:51511:颜色:灰色;47918:51511:颜色:灰色;47918:51511:颜色:灰色;47918:52484:颜色:黑色加绒;47918:53298:颜色:灰色加绒;47918:52484:颜色:黑色加绒;47918:52484:颜色:黑色加绒;47918:52484:颜色:黑色加绒;47918:53298:颜色:灰色加绒;47918:53298:颜色:灰色加绒;47918:53298:颜色:灰色加绒;47918:52484:颜色:黑色加绒;47918:52484:颜色:黑色加绒;47918:53298:颜色:灰色加绒;47918:53298:颜色:灰色加绒",
	    "prop_imgs": {
	        "prop_img": [
	            {
	                "properties": "47918:47989",
	                "url": "http://img10.360buyimg.com/n12/jfs/t1/102528/7/43477/54986/654886adF5942d5a8/8e0604d47fafa774.jpg"
	            },
	            {
	                "properties": "47918:51511",
	                "url": "http://img10.360buyimg.com/n12/jfs/t1/178926/26/41818/105748/65434809F4c0c9310/f2fe554054c0300a.jpg"
	            },
	            {
	                "properties": "47918:52484",
	                "url": "http://img10.360buyimg.com/n12/jfs/t1/128712/20/41487/68673/6512c9b7Fffbd23b0/0b74cb3de4d04609.jpg"
	            },
	            {
	                "properties": "47918:53298",
	                "url": "http://img10.360buyimg.com/n12/jfs/t1/9850/34/22290/106675/6512ca04F6c6da0b7/6c13cf40109e35fb.jpg"
	            }
	        ]
	    },
	    "props_imgs": {
	        "prop_img": [
	            {
	                "properties": "47918:47989",
	                "url": "http://img10.360buyimg.com/n12/jfs/t1/102528/7/43477/54986/654886adF5942d5a8/8e0604d47fafa774.jpg"
	            },
	            {
	                "properties": "47918:51511",
	                "url": "http://img10.360buyimg.com/n12/jfs/t1/178926/26/41818/105748/65434809F4c0c9310/f2fe554054c0300a.jpg"
	            },
	            {
	                "properties": "47918:52484",
	                "url": "http://img10.360buyimg.com/n12/jfs/t1/128712/20/41487/68673/6512c9b7Fffbd23b0/0b74cb3de4d04609.jpg"
	            },
	            {
	                "properties": "47918:53298",
	                "url": "http://img10.360buyimg.com/n12/jfs/t1/9850/34/22290/106675/6512ca04F6c6da0b7/6c13cf40109e35fb.jpg"
	            }
	        ]
	    },
	    "property_alias": "",
	    "props": [
	        {
	            "name": "商品名称",
	            "value": "回力男士卫衣"
	        },
	        {
	            "name": "商品编号",
	            "value": "100061393554"
	        },
	        {
	            "name": "商品毛重",
	            "value": "500.00g"
	        },
	        {
	            "name": "商品产地",
	            "value": "中国大陆"
	        },
	        {
	            "name": "货号",
	            "value": "LA311A81005"
	        },
	        {
	            "name": "材质",
	            "value": "涤纶(聚酯纤维)93.6%，氨纶(聚氨酯弹性纤维)6.4%"
	        },
	        {
	            "name": "版型",
	            "value": "宽松型"
	        },
	        {
	            "name": "适用季节",
	            "value": "春季，秋季"
	        },
	        {
	            "name": "上市时间",
	            "value": "2023年秋季"
	        },
	        {
	            "name": "领型",
	            "value": "连帽"
	        },
	        {
	            "name": "适用人群",
	            "value": "青少年，青年"
	        },
	        {
	            "name": "流行元素",
	            "value": "印花"
	        },
	        {
	            "name": "袖型",
	            "value": "常规袖"
	        },
	        {
	            "name": "厚度",
	            "value": "常规"
	        },
	        {
	            "name": "风格",
	            "value": "百搭风"
	        },
	        {
	            "name": "穿着方式",
	            "value": "开衫"
	        },
	        {
	            "name": "品牌",
	            "value": "回力"
	        }
	    ],
	    "total_sold": "-1",
	    "skus": {
	        "sku": [
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:47982;47918:47989",
	                "properties_name": "47876:47982:尺码:M/158-165（建议95-110斤）;47918:47989:颜色:黑色",
	                "quantity": 100,
	                "sku_id": "100061393512"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:48224;47918:47989",
	                "properties_name": "47876:48224:尺码:L/165-170（建议111-125斤）;47918:47989:颜色:黑色",
	                "quantity": 100,
	                "sku_id": "100061393540"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:48347;47918:47989",
	                "properties_name": "47876:48347:尺码:XL/170-175（建议126-140斤）;47918:47989:颜色:黑色",
	                "quantity": 100,
	                "sku_id": "100061393554"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:51182;47918:47989",
	                "properties_name": "47876:51182:尺码:2XL/170-175（建议141-155斤）;47918:47989:颜色:黑色",
	                "quantity": 100,
	                "sku_id": "100061393556"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:51290;47918:47989",
	                "properties_name": "47876:51290:尺码:3XL/175-180（建议156-165斤）;47918:47989:颜色:黑色",
	                "quantity": 100,
	                "sku_id": "100061393558"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:51415;47918:47989",
	                "properties_name": "47876:51415:尺码:4XL/178-183（建议166-175斤）;47918:47989:颜色:黑色",
	                "quantity": 100,
	                "sku_id": "100061393562"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:47982;47918:51511",
	                "properties_name": "47876:47982:尺码:M/158-165（建议95-110斤）;47918:51511:颜色:灰色",
	                "quantity": 100,
	                "sku_id": "100061393564"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:48224;47918:51511",
	                "properties_name": "47876:48224:尺码:L/165-170（建议111-125斤）;47918:51511:颜色:灰色",
	                "quantity": 100,
	                "sku_id": "100061393566"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:48347;47918:51511",
	                "properties_name": "47876:48347:尺码:XL/170-175（建议126-140斤）;47918:51511:颜色:灰色",
	                "quantity": 100,
	                "sku_id": "100064720071"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:51182;47918:51511",
	                "properties_name": "47876:51182:尺码:2XL/170-175（建议141-155斤）;47918:51511:颜色:灰色",
	                "quantity": 100,
	                "sku_id": "100064720073"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,
	                "properties": "47876:51290;47918:51511",
	                "properties_name": "47876:51290:尺码:3XL/175-180（建议156-165斤）;47918:51511:颜色:灰色",
	                "quantity": 100,
	                "sku_id": "100064720089"
	            },
	            {
	                "price": 99,
	                "total_price": 0,
	                "orginal_price": 99,

错误码解释

状态代码(error_code)	状态信息	详细描述	是否收费
0000	success	接口调用成功并返回相关数据	是
2000	Search success but no result	接口访问成功，但是搜索没有结果	是
4000	Server internal error	服务器内部错误	否
4001	Network error	网络错误	否
4002	Target server error	目标服务器错误	否
4003	Param error	用户输入参数错误	忽略
4004	Account not found	用户帐号不存在	忽略
4005	Invalid authentication credentials	授权失败	忽略
4006	API stopped	您的当前API已停用	忽略
4007	Account stopped	您的账户已停用	忽略
4008	API rate limit exceeded	并发已达上限	忽略
4009	API maintenance	API维护中	忽略
4010	API not found with these values	API不存在	忽略
4012	Please add api first	请先添加api	忽略
4013	Number of calls exceeded	调用次数超限	忽略
4014	Missing url param	参数缺失	忽略
4015	Wrong pageToken	参数pageToken有误	忽略
4016	Insufficient balance	余额不足	忽略
4017	timeout error	请求超时	否
5000	unknown error	未知错误	否