1688商品详情API返回值深度解读：阿里巴巴中国站商品数据全掌握
在电商领域，数据的力量是无可估量的。特别是对于阿里巴巴中国站的商家来说，能够准确、及时地获取商品详情数据，对于制定营销策略、优化库存管理、提升用户购物体验等方面都具有重要意义。1688商品详情API（应用程序接口）为商家们提供了一个强大的工具，通过它，商家可以深度解读商品数据，全面掌握商品信息。
一、API返回值概览
1688商品详情API返回的数据种类繁多，主要包括商品的基本信息、图片信息、规格参数、销售数据以及关联信息等。这些信息为商家提供了商品从上架到销售全过程的详细数据支持。
- 商品基本信息：包括商品ID、标题、描述、价格、库存等，这些信息直接反映了商品的当前状态和市场定位。
- 图片信息：API通常会返回商品的主图、详情图等图片链接。这些图片是吸引买家的关键因素，也是展示商品特性的重要手段。
- 规格参数：商品的颜色、尺寸、材质等规格参数是买家选择商品的重要依据。通过API获取这些参数，可以帮助商家更好地管理库存和提供个性化推荐。
- 销售数据：如果API提供销售数据（如销量、评价等），这将是非常有价值的信息。它可以反映商品的市场表现，为商家提供定价、促销等决策的参考。
- 关联信息：一些API还可能返回与商品相关的其他信息，如相似商品推荐、关联搭配等。这些信息可以帮助商家制定交叉销售和捆绑销售的策略。
二、深度解读API返回值
- 商品定位与市场策略：通过分析商品的基本信息，商家可以了解商品的定位、价格区间以及目标用户群体。这些信息有助于商家制定针对性的市场策略，如定价策略、促销活动等。
- 用户需求与购买行为：通过解析销售数据和评价信息，商家可以深入了解用户的购买行为和需求。例如，用户对于商品的价格敏感度、对商品特性的偏好等。这些信息对于优化商品详情页、提升转化率具有重要意义。
- 库存管理与供应链优化：规格参数和销售数据可以帮助商家更好地管理库存和预测销售趋势。商家可以根据这些数据调整库存量、优化采购计划以及改进供应链管理。
- 个性化推荐与交叉销售：通过分析关联信息和用户购买行为，商家可以制定个性化的推荐策略。例如，向购买过某类商品的用户推荐相关商品或搭配方案，提高交叉销售和捆绑销售的比例。
1688.item_get
公共参数
请求地址: https://api-gw.onebound.cn/1688/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=610947572360
参数说明：num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| item | item[] | 0 | 宝贝详情数据 |
响应示例
{
"item":{
"num_iid":601824709263,
"title":"韩版仿兔毛围巾秋冬毛毛围巾学生毛毛绒围脖冬季女套头防寒户外",
"desc_short":"",
"price":"2.2",
"total_price":0,
"suggestive_price":0,
"orginal_price":"2.2",
"nick":"_sopid@BBBEbRNm7OS0uGCXPJucMBy2w",
"num":3786174,
"min_num":2,
"detail_url":"https://detail.1688.com/offer/601824709263.html",
"pic_url":"https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg",
"brand":"",
"brandId":"",
"rootCatId":0,
"cid":325,
"crumbs":[
],
"created_time":"",
"modified_time":"",
"delist_time":"",
"desc":"<div id=\"offer-template-0\"></div><div > </div>\r\n<div ><span ><strong> <span >材质：双面仿兔毛毛绒面料，</span></strong></span></div>\r\n<div ><span ><strong><span >不掉毛（不是薄薄的单面哦）</span></strong></span></div>\r\n<div ><span ><strong ><span >厚款3.39元</span></strong></span></div>\r\n<div ><span ><strong><span ><span >普通款2.38元</span></span></strong></span></div>\r\n<div ><span ><strong><span ><span >每条围巾都是独立OPP袋子包装，放心选购！</span></span></strong></span></div>\r\n<div ><span ><strong><span >现货供应，厂家直销，没有中间商赚差价，有大量可以谈价，有量有价</span></strong></span></div>\r\n<div ><span ><strong><span >（抖音，快手，直播电商福利品，天猫，淘宝，PDD，跨境电商供应商）</span></strong></span></div>\r\n<div ><strong><span ><span ><span >这款围巾是不掉毛的，有些激光高温裁剪残留的浮毛，抖抖就好了哦。</span></span></span></strong></div>\r\n<div > </div>\r\n<div ><span ><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01emutXa27pyd6vYZzm_!!2206475177847-0-cib.jpg\" alt=\"undefined\"/><br/><strong>此图拉拉袋包装的为客户定做款（大货是OPP透明袋独立包装）</strong><br/><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01kFnNOl1MP9H5642lo_!!2272041426.jpg\" align=\"absmiddle\"/></span></div>\r\n<div ><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/TB2lZSUX7iHJuJjSZFjXXcGvXXa_!!2272041426.jpg\" align=\"absmiddle\"/><img src=\"https://img.alicdn.com/imgextra/i2/2272041426/TB2rvmVXYSGJuJjSZFqXXXo2pXa_!!2272041426.jpg\" align=\"absmiddle\"/></div>\r\n<div > </div>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01EKuyER1MP9LVqRODf_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01fH7zeu1MP9LXYMDb9_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01o03kWB1MP9LUPh2vD_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01zAl3p11MP9LTi5nZh_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01Zv9KBT1MP9LUIKRow_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01VlbKPj1MP9LU0NVFN_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01MjaoVZ1MP9LTiFjny_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01junsnm1MP9LX5bOdM_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i2/2272041426/O1CN014Dv2oq1MP9LU0KgIb_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01jNA7KZ1MP9LUHdDBF_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01JZW4Hn1MP9LUHd91D_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01nSbj2H1MP9LVqZ2mg_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p><img src=\"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01HmPSpT1MP9LSDyrsr_!!2272041426.jpg\" align=\"absmiddle\"/></p>\r\n<p> </p>\r\n<p> </p>\r\n<div >..........</div><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.65990d0ea4c43&p=1778786759&k=92716&t=1704529167\" style=\"display:none\" />",
"desc_img":[
"https://cbu01.alicdn.com/img/ibank/O1CN01emutXa27pyd6vYZzm_!!2206475177847-0-cib.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01kFnNOl1MP9H5642lo_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/TB2lZSUX7iHJuJjSZFjXXcGvXXa_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i2/2272041426/TB2rvmVXYSGJuJjSZFqXXXo2pXa_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01EKuyER1MP9LVqRODf_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01fH7zeu1MP9LXYMDb9_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01o03kWB1MP9LUPh2vD_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01zAl3p11MP9LTi5nZh_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01Zv9KBT1MP9LUIKRow_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01VlbKPj1MP9LU0NVFN_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01MjaoVZ1MP9LTiFjny_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01junsnm1MP9LX5bOdM_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i2/2272041426/O1CN014Dv2oq1MP9LU0KgIb_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01jNA7KZ1MP9LUHdDBF_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01JZW4Hn1MP9LUHd91D_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01nSbj2H1MP9LVqZ2mg_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01HmPSpT1MP9LSDyrsr_!!2272041426.jpg"
],
"item_imgs":[
{
"url":"https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg"
},
{
"url":"https://cbu01.alicdn.com/img/ibank/11921665153_1818272533.jpg"
},
{
"url":"https://cbu01.alicdn.com/img/ibank/11884953047_1818272533.jpg"
},
{
"url":"https://cbu01.alicdn.com/img/ibank/11954549050_1818272533.jpg"
},
{
"url":"https://cbu01.alicdn.com/img/ibank/12483429103_1818272533.jpg"
}
],
"item_weight":"",
"item_size":"",
"location":"浙江省 金华市",
"post_fee":"",
"express_fee":"",
"ems_fee":"",
"shipping_to":"",
"has_discount":"",
"video":"https://cloud.video.taobao.com/play/u/2206475177847/p/1/e/6/t/1/238604472723.mp4",
"is_virtual":"",
"sample_id":"",
"is_promotion":"",
"props_name":"0:0:颜色:红色;0:1:颜色:黑色;0:2:颜色:白色;0:3:颜色:灰色;0:4:颜色:杏色;0:5:颜色:粉色;0:6:颜色:咖啡色;0:7:颜色:米色;0:8:颜色:卡其色",
"prop_imgs":{
"prop_img":[
{
"properties":"0:0",
"url":"https://cbu01.alicdn.com/img/ibank/11884977080_1818272533.jpg"
},
{
"properties":"0:1",
"url":"https://cbu01.alicdn.com/img/ibank/11954549680_1818272533.jpg"
},
{
"properties":"0:2",
"url":"https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg"
},
{
"properties":"0:3",
"url":"https://cbu01.alicdn.com/img/ibank/11921680795_1818272533.jpg"
},
{
"properties":"0:4",
"url":"https://cbu01.alicdn.com/img/ibank/11954549050_1818272533.jpg"
},
{
"properties":"0:5",
"url":"https://cbu01.alicdn.com/img/ibank/11921689268_1818272533.jpg"
},
{
"properties":"0:6",
"url":"https://cbu01.alicdn.com/img/ibank/11954552765_1818272533.jpg"
},
{
"properties":"0:7",
"url":"https://cbu01.alicdn.com/img/ibank/O1CN01PtW77W27pyekEhcAt_!!2206475177847-0-cib.jpg"
},
{
"properties":"0:8",
"url":"https://cbu01.alicdn.com/img/ibank/O1CN01t2Q1ci27pyjXB0fxo_!!2206475177847-0-cib.jpg"
}
]
},
"property_alias":"0:0:红色;0:1:黑色;0:2:白色;0:3:灰色;0:4:杏色;0:5:粉色;0:6:咖啡色;0:7:米色;0:8:卡其色",
"props":[
{
"name":"品牌",
"value":"高着"
},
{
"name":"编织方法",
"value":"经编"
},
{
"name":"功能",
"value":"保暖"
},
{
"name":"适合季节",
"value":"冬季"
},
{
"name":"货号",
"value":"WJ618"
},
{
"name":"产地",
"value":"浙江义乌"
},
{
"name":"款式",
"value":"中长"
},
{
"name":"颜色",
"value":"红色"
},
{
"name":"颜色",
"value":"黑色"
},
{
"name":"颜色",
"value":"白色"
},
{
"name":"颜色",
"value":"灰色"
},
{
"name":"颜色",
"value":"杏色"
},
{
"name":"颜色",
"value":"粉色"
},
{
"name":"颜色",
"value":"咖啡色"
},
{
"name":"颜色",
"value":"米色"
},
{
"name":"颜色",
"value":"卡其色"
},
{
"name":"主要下游平台",
"value":"淘宝"
},
{
"name":"主要下游平台",
"value":"京东"
},
{
"name":"主要下游平台",
"value":"ebay"
},
{
"name":"主要下游平台",
"value":"亚马逊"
},
{
"name":"主要下游平台",
"value":"wish"
},
{
"name":"主要下游平台",
"value":"快手"
},
{
"name":"主要下游平台",
"value":"速卖通"
},
{
"name":"主要下游平台",
"value":"天猫"
},
{
"name":"主要下游平台",
"value":"独立站"
},
{
"name":"主要下游平台",
"value":"LAZADA"
},
{
"name":"主要下游平台",
"value":"拼多多"
},
{
"name":"主要下游平台",
"value":"抖音"
},
{
"name":"有可授权的自有品牌",
"value":"否"
},
{
"name":"是否跨境出口专供货源",
"value":"是"
},
{
"name":"上市年份/季节",
"value":"2021年秋季"
},
{
"name":"宽度(CM)",
"value":"12cm"
},
{
"name":"风格",
"value":"百搭"
},
{
"name":"风格",
"value":"优雅"
},
{
"name":"风格",
"value":"极简"
},
{
"name":"风格",
"value":"休闲风"
},
{
"name":"风格",
"value":"时尚OL"
},
{
"name":"风格",
"value":"简约"
},
{
"name":"风格",
"value":"欧美"
},
{
"name":"风格",
"value":"轻奢风"
},
{
"name":"风格",
"value":"chic风"
},
{
"name":"风格",
"value":"高级感"
},
{
"name":"面料名称",
"value":"毛绒"
},
{
"name":"风格分类",
"value":"时尚通勤"
},
{
"name":"处理工艺",
"value":"经编"
},
{
"name":"流行元素分类",
"value":"无"
}
],
"total_sold":3786174,
"skus":{
"sku":[
{
"price":4.99,
"total_price":4.99,
"orginal price":4.99,
"properties":"0:0",
"properties_name":"0:0:颜色:红色",
"quantity":0,
"sku_id":5330445855404,
"spec_id":"87b07b1e746bd546e97a0f5888726ae3"
},
{
"price":4.99,
"total_price":4.99,
"orginal price":4.99,
"properties":"0:1",
"properties_name":"0:1:颜色:黑色",
"quantity":0,
"sku_id":5330445855410,
"spec_id":"e664b2e7c4adae52d35767f51a9219f6"
},
{
"price":4.99,
"total_price":4.99,
"orginal price":4.99,
"properties":"0:2",
"properties_name":"0:2:颜色:白色",
"quantity":0,
"sku_id":5330445855398,
"spec_id":"18dc5ba8c7dc3df0eb8b731977df2372"
},
{
"price":4.99,
"total_price":4.99,
"orginal price":4.99,
"properties":"0:3",
"properties_name":"0:3:颜色:灰色",
"quantity":8020,
"sku_id":5330445855408,
"spec_id":"05808df6001a6ffa6fa13ae7df588b36"
},
{
"price":4.99,
"total_price":4.99,
"orginal price":4.99,
"properties":"0:4",
"properties_name":"0:4:颜色:杏色",
"quantity":0,
"sku_id":5330445855412,
"spec_id":"1ab2b4cd3cc2b51ed4055978ca4b8579"
},
{
"price":4.99,
"total_price":4.99,
"orginal price":4.99,
"properties":"0:5",
"properties_name":"0:5:颜色:粉色",
"quantity":0,
"sku_id":5330445855402,
"spec_id":"7a394d5d7d8560fae263cd2ffe9ee444"
},
{
"price":4.99,
"total_price":4.99,
"orginal price":4.99,
"properties":"0:6",
"properties_name":"0:6:颜色:咖啡色",
"quantity":0,
"sku_id":5330445855396,
"spec_id":"423651c0792f75de75484ae9bd5fe535"
},
{
"price":4.99,
"total_price":4.99,
"orginal price":4.99,
"properties":"0:7",
"properties_name":"0:7:颜色:米色",
"quantity":0,
"sku_id":5330445855400,
"spec_id":"45b9c574ac45662aba79f2cb72d20112"
},
{
"price":4.99,
"total_price":4.99,
"orginal price":4.99,
"properties":"0:8",
"properties_name":"0:8:颜色:卡其色",
"quantity":0,
"sku_id":5330445855406,
"spec_id":"f7931f4b9892a8c41b76205cb1d50627"
}
]
},
"seller_id":null,
"sales":0,
"shop_id":null,
"props_list":{
"0:0":"颜色:红色",
"0:1":"颜色:黑色",
"0:2":"颜色:白色",
"0:3":"颜色:灰色",
"0:4":"颜色:杏色",
"0:5":"颜色:粉色",
"0:6":"颜色:咖啡色",
"0:7":"颜色:米色",
"0:8":"颜色:卡其色"
},
"seller_info":{
"nick":null,
"user_num_id":null,
"sid":null,
"title":null,
"zhuy":null,
"shop_name":null
},
"tmall":"false",
"error":"",
"warning":"",
"url_log":[
],
"unit":null,
"is_support_mix":null,
"mix_amount":null,
"mix_begin":null,
"mix_number":null,
"priceRange":[
[
2,
"2.2"
]
],
"priceRangeOriginal":[
],
异常示例复制
{
"error": "item-not-found",
"reason": "商品没找到",
"error_code": "2000",
"success": 0,
"cache": 0,
"api_info": "today:0 max:10000",
"execution_time": 0.081,
"server_time": "Beijing/2020-06-10 23:44:00",
"call_args": [],
"api_type": "1688",
"request_id": "15ee0ffc041242"
}
错误码解释
| 状态代码(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 | 未知错误 | 否 |
1142
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
