淘宝 API 上货 / 商品搬家 业务场景实现 + JSON 返回示例

（简单直白、程序员直接可用）

一、业务场景说明

淘宝 API 上货 / 搬家 = 自动把商品从其他平台（1688、拼多多、抖音、淘宝其他店铺）搬到淘宝店 不用人工复制标题、图片、详情、SKU，全自动上架。

能实现什么？

• 自动抓取商品数据（标题、图片、价格、SKU、详情、属性）
• 自动处理图片、替换水印、格式化描述
• 自动发布为淘宝新商品
• 批量搬家、批量上架、批量更新
• 店铺间商品一键迁移、多店铺货

---

二、核心 API 接口

• 商品发布：taobao.item.add
• 商品编辑：taobao.item.update
• 图片上传：taobao.item.img.upload
• 商品详情获取：taobao.item.get

---

三、Python 业务实现逻辑（极简流程）

python

运行

# 1. 从源平台/店铺获取商品数据（1688/拼多多/淘宝）
# 2. 格式化数据（标题、SKU、详情图、属性）
# 3. 上传图片到淘宝图片空间
# 4. 调用淘宝API 发布/上架商品
# 5. 返回商品ID、上架状态

---

四、商品发布 API 请求 JSON（入参示例）

json

{
    "method": "taobao.item.add",
    "app_key": "你的app_key",
    "session": "授权session",
    "title": "2025夏季新款纯棉宽松T恤",
    "price": "59.00",
    "num": 200,
    "cid": 50015261,
    "desc": "<p>高品质纯棉T恤，透气舒适</p>",
    "pic_url": "https://img.taobao.com/xxx.jpg",
    "property_alias": "颜色:白色;尺码:M|L|XL"
}

---

五、淘宝 API 上货 / 搬家 JSON 返回示例

成功发布商品返回：

json

{
    "item_add_response": {
        "item": {
            "num_iid": 786500123456,
            "title": "2025夏季新款纯棉宽松T恤",
            "price": "59.00",
            "num": 200,
            "cid": 50015261,
            "created": "2025-04-20 15:30:22",
            "status": "onsale",
            "msg": "商品发布成功"
        }
    }
}

商品搬家 / 编辑返回：

json

{
    "item_update_response": {
        "item": {
            "num_iid": 786500123456,
            "title": "2025夏季新款纯棉T恤（修改版）",
            "price": "55.00",
            "num": 300,
            "updated": "2025-04-20 16:10:11",
            "msg": "商品编辑成功"
        }
    }
}

---

六、业务价值（给企业 / 程序员带来什么）

• 10 分钟完成过去 1 天的上货量
• 自动搬家、自动处理图片、自动填属性
• 多店同步、多平台铺货
• 降低 80% 人工操作
• 避免重复劳动、减少错误
• 支持批量上货、定时上货

---

七、一句话总结

淘宝 API 上货 / 搬家 = 全自动商品发布 + 跨平台铺货 + 批量上架 JSON 返回商品 ID、状态、价格、库存，程序员可直接对接 ERP、上货工具、店铺管理系统。