1688商品信息获取：API返回值详解

最新推荐文章于 2024-09-04 10:34:19 发布

api77

最新推荐文章于 2024-09-04 10:34:19 发布

阅读量814

点赞数 20

分类专栏：电商api api 文章标签： java 数据库服务器开发语言 python pygame django

本文链接：https://blog.csdn.net/api77/article/details/140630971

版权

电商api 同时被 2 个专栏收录

444 篇文章 3 订阅

订阅专栏

api

398 篇文章 1 订阅

订阅专栏

在阿里巴巴（1688）平台上，获取商品信息通常涉及到使用其提供的API接口。由于阿里巴巴的API接口和具体参数可能会随着平台更新而有所变化，以下是一个概括性的解析，帮助理解通过API获取商品信息时可能遇到的返回值结构和一些常见字段。

1. API调用概述

首先，你需要注册成为阿里巴巴的开发者，并获取相应的API访问权限和密钥（如App Key和App Secret）。然后，你可以根据阿里巴巴提供的API文档，构造请求URL，并发送HTTP请求来获取商品信息。

2. 返回值结构

API的返回值通常是一个JSON格式的数据包，它包含了请求的结果和相关信息。一个典型的返回值结构可能包括以下几个部分：

code：返回码，用于指示请求是否成功。通常，0或200表示成功，其他值表示不同的错误。
message：返回信息的描述，如果请求成功，这里可能是一些提示信息；如果请求失败，这里会包含错误描述。
data：这是实际的数据部分，包含了请求的商品信息。根据API的不同，data的结构也会有所不同。

3. 商品信息字段

在data部分，你将找到关于商品的详细信息。以下是一些常见的商品信息字段：

productId / itemId：商品的唯一标识符。
title：商品的标题。
price：商品的价格，可能包含原价、促销价等。
stock：商品的库存数量。
images：商品的图片列表，每个图片通常包含URL地址。
description：商品的详细描述，可能是HTML格式的文本。
attributes：商品的属性列表，如颜色、尺寸、材质等。
sellerInfo：卖家信息，包括卖家ID、卖家名称、卖家评分等。
categoryIds：商品所属的分类ID列表。
sales：商品的销售数量或评价数量。
tags：商品的标签或关键词。

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":[

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