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

最新推荐文章于 2025-04-30 09:30:00 发布

api77

最新推荐文章于 2025-04-30 09:30:00 发布

阅读量931

点赞数 20

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

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

版权

在阿里巴巴（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>此图拉拉袋包装的为客户定做款ÿ