提升效率神奇爬虫框架，阿里巴巴中国站获得1688商品详情 API接口数据调用

本文链接：https://blog.csdn.net/API_you847337137/article/details/137136439

阿里巴巴中国站获得的1688商品详情API接口功能非常强大且多样，为开发者提供了丰富的商品数据获取途径。以下是一些主要的功能：

获取商品详细信息：开发者可以通过API接口获取指定商品的详细信息，包括商品标题、描述、价格、库存等。这些信息对于电商应用、比价工具等具有极大的价值，可以帮助用户更全面地了解商品情况。
获取商品属性信息：除了基本的商品信息，API接口还能提供商品的属性列表和属性值，帮助用户更深入地了解商品的特性和参数。
获取商品规格参数：通过API接口，开发者可以查询商品的尺寸、重量等规格参数，这对于需要精确了解商品尺寸的应用场景非常有用。
获取商品图片信息：API接口还提供商品的图片信息，包括图片的URL和图片描述，这有助于展示商品的外观和细节，提升用户的购物体验。
获取商品评价信息：通过接口，开发者可以获取商品的评分和评论内容，这对于用户了解商品口碑和购买决策具有重要的参考价值。

item_get 获得1688商品详情
item_search 按关键字搜索商品
item_search_img 按图搜索1688商品（拍立淘）
item_search_suggest 获得搜索词推荐
item_fee 获得商品快递费用
seller_info 获得店铺详情
item_search_shop 获得店铺的所有商品
item_password 获得淘口令真实url
upload_img 上传图片到1688
item_search_seller 搜索店铺列表
img2text 图片识别商品接口
item_get_app 获取1688app上原数据
buyer_order_list 获取购买到的商品订单列表
cat_get 获得1688商品分类

公共参数

名称	类型	必须	描述
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":[

        ],
        "_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"
}

异常示例

{
  "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	未知错误	否