京东商品详情API是开发者获取京东平台上商品详细信息的重要工具。通过调用API并解析返回的响应数据，您可以快速获取商品的各项属性，如商品ID、标题、价格、图片等。下面，我们将为您详细介绍京东商品详情API的返回值说明，帮助您更好地理解和使用这一工具。
一、API调用前提
在使用京东商品详情API之前，您需要在京东开放平台注册账号，并创建应用获取API密钥。API密钥是您调用API接口的必要条件，务必妥善保管。
二、API返回值概述
京东商品详情API的返回值通常是一个包含多个字段的JSON对象。这些字段包含了商品的详细信息，以下是一些常见的返回值字段及其说明：
- 商品ID：每个商品在京东平台上都有一个唯一的商品ID，用于标识商品的身份。
- 商品标题：商品的名称或标题，通常包含了商品的品牌、型号、主要功能等关键信息。
- 商品图片：商品的图片链接或URL，您可以根据这些链接获取商品的图片信息。
- 商品价格：商品的销售价格，通常以元为单位。
- 商品库存：商品的库存数量，有助于您了解商品的库存状况。
- 商品详情：商品的详细描述信息，包括商品的材质、尺寸、包装等详细信息。
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": "货号",
