一、引言
京东JD商品详情API是京东开放给第三方应用的一个重要接口,通过该接口,开发者可以获取到京东平台上商品的详细信息。这些信息包括但不限于商品标题、价格、图片、规格、参数、店铺信息等,对于商家进行商品管理、用户进行购物决策、以及开发者进行数据分析等都具有重要意义。特别是在电商数据驱动的个性化推荐领域,JD商品详情API的返回值提供了丰富的数据支持。
二、京东JD商品详情API返回值解读
- 商品ID
- 定义:商品的唯一标识符,用于在京东平台上唯一确定一个商品。
- 作用:在个性化推荐中,商品ID是核心数据之一,用于标识和区分不同的商品,确保推荐的准确性。
- 商品标题
- 定义:商品的名称或标题,通常用于展示给用户,帮助用户了解商品的基本信息。
- 作用:在个性化推荐中,商品标题可以用于关键词匹配,根据用户的搜索或浏览记录,推荐相关或相似的商品。
- 商品价格
- 定义:商品的销售价格,包括原价、促销价等。
- 作用:价格是影响用户购物决策的重要因素之一。在个性化推荐中,可以根据用户的价格偏好,推荐符合其预算的商品。
- 商品图片
- 定义:商品的图片链接或URL。
- 作用:图片是商品展示的重要形式,可以更直观地展示商品的外观和特点。在个性化推荐中,商品图片可以用于吸引用户的注意力,提高点击率和购买转化率。
- 商品规格和参数
- 定义:商品的详细规格信息,如尺寸、颜色、材质等;以及附加参数信息,如品牌、产地、保修期等。
- 作用:规格和参数是用户了解商品具体信息的关键。在个性化推荐中,可以根据用户的偏好和需求,推荐符合其需求的商品规格和参数。
- 店铺信息
- 定义:商品所属店铺的相关信息,如店铺名称、店铺评分等。
- 作用:店铺信息是用户了解商家信誉和服务质量的重要依据。在个性化推荐中,可以结合店铺信息,推荐信誉好、服务优质的商家的商品,提高用户的购物体验。
-
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": "回力"
}
],
三、电商数据驱动的个性化推荐
利用京东JD商品详情API返回的丰富数据,可以实现以下电商数据驱动的个性化推荐功能:
- 实时数据获取与更新
- 通过调用JD商品详情API接口,实时获取商品的最新信息,包括价格变动、库存变化等。这有助于确保个性化推荐的准确性和时效性。
- 用户行为分析
- 分析用户的购买历史、浏览记录等数据,了解用户的喜好和需求。基于这些数据,可以为用户推荐符合其偏好的商品。
- 精准营销与推荐
- 结合用户的行为数据和搜索记录,进行精准营销和个性化推荐。例如,根据用户的购买记录推荐相似的商品或相关联的商品;为特定用户定制专属的优惠活动和促销方案等。
- 数据分析与挖掘
- 通过对大量商品数据的分析和挖掘,发现商品的销售趋势、用户偏好等信息。这些信息可以为商家提供决策支持,指导商品的生产、采购和销售等环节。