在电商领域，商品详情页面是用户了解商品详细信息的重要途径。为了方便开发者快速获取商品信息，阿里巴巴旗下的1688平台提供了商品详情API接口。本文将介绍如何使用1688商品详情API接口获取商品信息，并通过代码示例进行详细说明。
一、API接口简介
1688商品详情API接口是一个基于HTTP协议的Web服务接口，通过调用该接口，可以获取到商品的详细信息，包括商品名称、价格、描述、图片等。开发者可以根据自己的需求，灵活地使用这些信息来构建自己的应用。
二、API接口调用流程
- 注册账号，获取 Key和 Secret。
- 使用Key和 Secret生成签名（Sign），用于验证请求的合法性。
- 构造API请求URL，包含必要的参数，如method、app_key、timestamp、format等。
- 发送HTTP请求，获取API返回的数据。
- 解析API返回的数据，提取所需信息。
三、API接口参数说明
- 公共参数
名称 |
类型 |
必须 |
描述 |
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 |
宝贝详情数据 |
|
num_iid |
String |
0 |
宝贝ID |
|
title |
String |
0 |
商品标题 |
|
desc_short |
String |
0 |
商品简介 |
|
price |
Float |
0 |
价格 |
|
total_price |
Float |
0 |
||
suggestive_price |
Float |
0 |
||
orginal_price |
Float |
0 |
原价 |
|
nick |
String |
0 |
卖家昵称(以上2种参数都有可能输出，凡是_sopid@开头的即为加密openid) |
|
num |
Int |
0 |
||
min_num |
Int |
0 |
最小起批量 |
|
detail_url |
String |
0 |
宝贝链接 |
|
pic_url |
String |
0 |
宝贝图片 |
|
brand |
String |
0 |
品牌 |
|
brandId |
Int |
0 |
品牌id |
|
rootCatId |
Int |
0 |
顶级分类ID |
|
cid |
Int |
0 |
||
desc |
String |
0 |
||
item_imgs |
Mix |
0 |
商品图片 |
|
item_weight |
String |
0 |
||
post_fee |
Float |
0 |
邮费 |
|
express_fee |
Float |
0 |
EMS费用 |
|
ems_fee |
Float |
0 |
物流费用 |
|
shipping_to |
String |
0 |
发货至 |
|
video |
video[] |
0 |
商品视频 |
|
sample_id |
String |
0 |
||
props_name |
String |
0 |
商品属性名 |
|
prop_imgs |
prop_imgs[] |
0 |
商品属性图片列表 |
|
property_alias |
String |
0 |
属性别名 |
|
props |
Mix |
0 |
商品详情 |
|
total_sold |
Int |
0 |
||
scale |
Int |
0 |
||
sellUnit |
Int |
0 |
||
skus |
skus[] |
0 |
商品规格信息列表 |
|
seller_id |
Int |
0 |
卖家ID |
|
sales |
Int |
0 |
销售额 |
|
shop_id |
Int |
0 |
店铺ID |
|
props_list |
Mix |
0 |
商品属性 |
|
tmall |
Boolean |
0 |
是否天猫 |
|
data_from |
String |
0 |
错误信息 |
|
error |
String |
0 |
错误信息 |
|
unit |
String |
0 |
单位 |
|
is_support_mix |
Boolean |
0 |
||
mix_amount |
Int |
0 |
||
mix_Begin |
Int |
0 |
||
mix_number |
Int |
0 |
||
sales_data |
Date |
0 |
||
location |
String |
0 |
发货地 |
|
props_img |
Mix |
0 |
属性图片 |
|
sales_info |
Mix |
0 |
||
desc_img |
Mix |
0 |
详情图片列表 |
|
shop_item |
Mix |
0 |
||
relate_items |
Mix |
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":[ ], "_ddf":"sop", "props_img":{ "0:0":"https://cbu01.alicdn.com/img/ibank/11884977080_1818272533.jpg", "0:1":"https://cbu01.alicdn.com/img/ibank/11954549680_1818272533.jpg", "0:2":"https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg", "0:3":"https://cbu01.alicdn.com/img/ibank/11921680795_1818272533.jpg", "0:4":"https://cbu01.alicdn.com/img/ibank/11954549050_1818272533.jpg", "0:5":"https://cbu01.alicdn.com/img/ibank/11921689268_1818272533.jpg", "0:6":"https://cbu01.alicdn.com/img/ibank/11954552765_1818272533.jpg", "0:7":"https://cbu01.alicdn.com/img/ibank/O1CN01PtW77W27pyekEhcAt_!!2206475177847-0-cib.jpg", "0:8":"https://cbu01.alicdn.com/img/ibank/O1CN01t2Q1ci27pyjXB0fxo_!!2206475177847-0-cib.jpg" }, "sales_info":{ "seller_num":"", "repeat_rate_purchase":"", "per_capita_purchases":"", "comment_num":"", "comment_url":"" }, "format_check":"ok", "shop_item":[ ], "relate_items":[ ] }, "error":"", "secache":"a1950f8cc13611671db129a5c7ae864a", "secache_time":1704529167, "secache_date":"2024-01-06 16:19:27", "translate_status":"", "translate_time":0, "language":{ "default_lang":"cn", "current_lang":"cn" }, "reason":"", "error_code":"0000", "cache":0, "api_info":"today:28 max:10000 all[28=28+0+0];expires:2024-05-30", "execution_time":"0.342", "server_time":"Beijing/2024-01-06 16:19:27", "client_ip":"106.6.33.199", "call_args":{ "num_iid":"601824709263" }, "api_type":"1688", "server_memory":"0.92MB", "request_id":"gw-4.65990d0ea4c43", "last_id":"2436414138" }
以下代码示例使用Python语言，调用1688商品详情API接口，获取商品信息，并将结果输出到控制台。
请将your_app_key和your_app_secret替换为你在平台申请的 Key和 Secret。运行代码后，你将看到返回的商品信息。
五、注意事项
- 为了保证数据的安全性，建议将 Secret保存在服务器端，而不是直接写在代码中。
- 由于网络延迟等原因，API请求可能会失败，建议对请求结果进行异常处理，提高程序的稳定性。
- 1688商品详情API接口有请求频率限制，具体请参考文档。
