企业级实战：淘宝铺货核心API接口说明（含JSON返回）

原创

Anzexi58

发布于 2026-05-20 16:47:04

1530

文章被收录于专栏：API接口开发API接口开发

前言

一、铺货核心API说明（企业级极简）

淘宝铺货核心依赖两类API，分别对应「获取货源商品数据」和「自有店铺上架商品」，适配跨店铺货、多平台同步、批量上架等企业场景，全程合规调用，避免爬虫风险。

1. 货源商品获取接口（核心）

接口标识：taobao.item_get_full（完整版，推荐铺货用）
用途：获取目标货源商品（淘宝/1688）的完整数据（标题、主图、详情、SKU、价格），用于铺货前的数据同步
鉴权：AppKey + AppSecret 签名，无需店铺授权（仅获取公开数据）
核心请求参数：num_iid（货源商品ID，必传）、fields（指定返回字段，可选）

2. 自有店铺上架接口（核心）

接口标识：taobao.item.add（新品上架）、taobao.item.update（商品更新）
用途：将获取到的货源数据，批量/单个上架到自有淘宝店铺，完成铺货
鉴权：AppKey + AppSecret + session（店铺授权，仅可操作自身店铺）
核心请求参数：num_iid（可选，更新用）、title、price、pic_url、cid、sku_list（必传）

二、铺货全流程API JSON返回参考（企业级标准）

以下为铺货核心链路的完整JSON返回示例，字段精简、可直接用于开发解析，适配企业铺货系统。

1. 货源商品获取（taobao.item_get_full）返回示例

{
  "item_get_response": {
    "item": {
      "num_iid": 680123456789,
      "title": "2026夏季新款纯棉透气短袖T恤 宽松百搭多色",
      "price": "89.00",
      "promotion_price": "59.00",
      "cid": 50015261,
      "category_name": "女装>T恤",
      "pic_url": "https://img.taobao.com/imgextra/i1/xxx.jpg",
      "image_list": [
        "https://img.taobao.com/imgextra/i1/xxx1.jpg",
        "https://img.taobao.com/imgextra/i1/xxx2.jpg"
      ],
      "desc": "<p>面料：100%纯棉</p><p>尺码：M/L/XL</p>",
      "sku_list": {
        "sku": [
          {
            "sku_id": 12345678901,
            "price": "59.00",
            "quantity": 500,
            "properties_name": "颜色:白色;尺码:L"
          },
          {
            "sku_id": 12345678902,
            "price": "59.00",
            "quantity": 420,
            "properties_name": "颜色:黑色;尺码:XL"
          }
        ]
      },
      "location": "广东 广州",
      "modified": "2026-05-19 11:30:22"
    },
    "request_id": "top_req_260519113000123"
  }
}

2. 自有店铺商品上架（taobao.item.add）返回示例

{
  "item_add_response": {
    "num_iid": 680987654321,
    "item_id": 680987654321,
    "title": "2026夏季新款纯棉透气短袖T恤 宽松百搭多色",
    "status": "onsale",
    "cid": 50015261,
    "created": "2026-05-19 11:35:40",
    "msg": "商品上架成功",
    "request_id": "top_req_260519113500456"
  }
}

3. 商品批量铺货（简化返回，适配多商品）

{
  "items_batch_add_response": {
    "total_count": 10,
    "success_count": 9,
    "fail_count": 1,
    "success_items": [
      {
        "num_iid": 680987654321,
        "title": "2026夏季新款纯棉透气短袖T恤",
        "status": "onsale"
      },
      {
        "num_iid": 680987654322,
        "title": "休闲百搭牛仔裤",
        "status": "onsale"
      }
    ],
    "fail_items": [
      {
        "title": "夏季运动鞋",
        "error_msg": "类目ID错误，无法上架"
      }
    ],
    "request_id": "top_req_260519114000789"
  }
}

三、铺货API核心字段说明（企业必用）

num_iid：商品唯一ID（货源商品/自有上架商品，铺货关联核心）
title：商品标题（铺货需适配自身店铺风格，可微调）
price/promotion_price：原价/促销价（铺货定价核心）
sku_list：SKU规格+库存（多规格商品铺货必备）
pic_url/image_list：主图+详情图（铺货展示核心）
cid：类目ID（必须与自有店铺类目匹配，否则上架失败）
status：商品状态（onsale=在售，铺货成功标识）
request_id：全链路追踪，铺货失败排错必备

四、企业级铺货API调用要点（极简）

获取货源数据时，过滤异常商品（价格≤0、无主图、SKU为空）；
上架前，适配自身店铺类目（cid匹配）、调整标题/价格，避免违规；
批量铺货时，控制QPS（≤5），避免限流，失败商品单独重试；
做好数据校验，确保上架后商品信息与货源一致，减少售后。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key

登录后参与评论

0 条评论

热度

企业级实战：淘宝铺货核心API接口说明（含JSON返回）

企业级实战：淘宝铺货核心API接口说明（含JSON返回）

一、铺货核心API说明（企业级极简）

1. 货源商品获取接口（核心）

2. 自有店铺上架接口（核心）

二、铺货全流程API JSON返回参考（企业级标准）

1. 货源商品获取（taobao.item_get_full）返回示例

2. 自有店铺商品上架（taobao.item.add）返回示例

3. 商品批量铺货（简化返回，适配多商品）

三、铺货API核心字段说明（企业必用）

四、企业级铺货API调用要点（极简）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐