首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >企业级实战:淘宝铺货核心API接口说明(含JSON返回)

企业级实战:淘宝铺货核心API接口说明(含JSON返回)

原创
作者头像
Anzexi58
发布2026-05-20 16:47:04
发布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)返回示例

代码语言:javascript
复制
{
  "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)返回示例

代码语言:javascript
复制
{
  "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. 商品批量铺货(简化返回,适配多商品)

代码语言:javascript
复制
{
  "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调用要点(极简)

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

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

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

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

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

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、铺货核心API说明(企业级极简)
    • 1. 货源商品获取接口(核心)
    • 2. 自有店铺上架接口(核心)
  • 二、铺货全流程API JSON返回参考(企业级标准)
    • 1. 货源商品获取(taobao.item_get_full)返回示例
    • 2. 自有店铺商品上架(taobao.item.add)返回示例
    • 3. 商品批量铺货(简化返回,适配多商品)
  • 三、铺货API核心字段说明(企业必用)
  • 四、企业级铺货API调用要点(极简)
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档