1688接口文档中关于商品列表获取接口的详细说明

在 1688 开放平台中，商品列表获取接口主要用于批量获取商品信息，适用于私域电商同步商品库、批量上架等场景。以下是该接口的详细说明（基于官方文档整理）：

一、接口基本信息

• 接口名称：alibaba.product.list.get（阿里标准商品列表查询）
• 接口地址：https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.list.get/1.0
• 请求方式：GET
• 权限要求：需申请对应 API 权限（部分接口需企业认证）
• 限流规则：默认单 appkey 每秒最多 20 次调用（具体以开放平台提示为准）

二、请求参数

参数分为公共参数和业务参数，需按规则拼接并生成签名。

1. 公共参数（必传）

参数名	类型	说明
app_key	String	开发者应用的唯一标识（在开放平台控制台获取）
method	String	接口名称，固定为com.alibaba.product.alibaba.product.list.get
format	String	响应格式，固定为json
v	String	版本号，固定为1.0
timestamp	String	请求时间戳，格式yyyy-MM-dd HH:mm:ss
sign_method	String	签名方法，固定为md5
sign	String	签名（按 1688 规则生成）
session	String	用户授权的sessionkey（部分场景需传）

2. 业务参数（按需传递）

参数名	类型	说明
categoryId	Long	商品类目 ID（用于筛选某类目下的商品）
startPrice/endPrice	Double	价格区间筛选（单位：元）
startQuantity/endQuantity	Long	库存区间筛选
keywords	String	搜索关键词（支持商品标题、规格等模糊匹配）
page	Integer	页码，默认 1，最大支持 100 页
pageSize	Integer	每页条数，默认 20，最大支持 50 条
sort	String	排序方式：price_asc（价格升序）、price_desc（价格降序）、create_time_desc（最新发布）等

三、响应参数（JSON 格式）

返回结果包含商品列表及分页信息，核心字段如下：

json

{
  "alibaba_product_list_get_response": {
    "totalCount": 120,  // 总商品数
    "currentPage": 1,   // 当前页码
    "pageSize": 20,     // 每页条数
    "result": [
      {
        "productId": "123456",  // 商品ID
        "title": "夏季纯棉T恤男", // 商品标题
        "price": "39.90",       // 价格（元）
        "originalPrice": "59.90", // 原价
        "stock": 1200,          // 库存数
        "categoryId": 101,      // 类目ID
        "categoryName": "男装", // 类目名称
        "imageUrl": "https://xxx.jpg", // 主图URL
        "createTime": "2023-05-10 14:30:00", // 发布时间
        "status": "ON_SALE"     // 状态（ON_SALE：在售，OFF_SALE：下架）
      },
      // 更多商品...
    ]
  }
}

四、调用示例（Python）

以下是批量获取商品列表的代码示例（需替换为你的实际参数）：

1688商品列表获取接口调用示例

五、常见问题

1. 签名错误：检查参数排序是否按 ASCII 码升序，签名拼接是否包含appsecret首尾。
2. 权限不足：在开放平台控制台确认是否已申请该接口权限，部分接口需企业资质。
3. 数据不全：商品详情（如规格、详情页）需调用alibaba.product.get接口单独获取。
4. 分页限制：超过 100 页的数据无法获取，需通过其他条件缩小筛选范围。

六、参考文档

• 官方详细文档：登录 1688开放平台 后，在「文档中心」搜索alibaba.product.list.get。
• 错误码查询：在开放平台文档中查看「公共错误码」和「商品类错误码」。

实际开发时，建议结合业务需求筛选参数，避免无意义的全量查询，以提高接口效率。