一文通,第三方接口如何实现批量上货,主流平台[淘宝|京东|1688|抖音)和跨境平台
一、国内主流平台批量上货接口
1. 淘宝 / 天猫(TOP 开放平台)
表格
| 核心接口 | 功能 | 说明 |
|---|---|---|
taobao.item.add | 发布新商品 | 最核心接口,需传类目ID、标题、价格、SKU、主图等 |
taobao.item.update | 编辑已有商品 | 修改价格、库存、标题、详情等 |
taobao.item.shelf / taobao.item.unshelf | 上架/下架 | 控制商品售卖状态 |
taobao.item.img.upload | 上传图片 | 主图、详情图需先上传获取图片URL |
taobao.itemcats.get | 获取类目树 | 发布前必须确定正确的类目ID |
taobao.item.propimg.upload | 上传属性图 | SKU颜色/规格对应的图片 |
接入流程:
- 在淘宝开放平台注册企业开发者账号(个人权限受限)
- 创建应用,申请 "商品发布" 权限(需审核)
- 商家通过 OAuth 2.0 授权你的应用访问其店铺
- 获取 Access Token 后调用接口
关键注意点:
- 类目必须准确:先用
taobao.itemcats.get查类目ID,不同类目要求的属性字段不同 - SKU 规格处理:颜色/尺寸组合需生成
sku_properties字段,格式如1627207:3232481;20509:28383 - 图片预上传:所有图片必须先调用上传接口获取淘宝图片空间的 URL,不能直接贴外部链接
2. 京东(JOS 开放平台)
京东的商品发布体系与淘宝类似,但字段命名和类目体系不同。
表格
| 核心接口 | 功能 |
|---|---|
jingdong.ware.write.add | 添加新商品 |
jingdong.ware.write.update | 修改商品信息 |
jingdong.ware.write.upOrDown | 商品上下架 |
jingdong.image.write.upload | 图片上传 |
jingdong.category.read.findAttrsByCategoryId | 获取类目属性 |
接入流程:
- 京东开放平台注册企业开发者
- 创建应用,申请 "商品管理" 权限
- 商家授权后获取 token
关键差异:
- 京东对 售后服务模板 有强制要求,发布时必须关联售后模板ID
- 京东自营和 POP(第三方)店铺的接口权限不同,需确认店铺类型
3. 拼多多(PDD Open API)
拼多多接口相对简单,免费额度较高,适合中小商家。
表格
| 核心接口 | 功能 |
|---|---|
pdd.goods.add | 创建新商品 |
pdd.goods.update | 修改商品 |
pdd.goods.sku.price.update | 批量修改SKU价格 |
pdd.stock.update | 批量修改库存 |
pdd.goods.image.upload | 图片上传 |
关键注意点:
- 拼多多对 商品标题 有敏感词过滤,发布前建议做合规校验
- 多规格商品(SKU)需通过
sku_list数组传入,每个 SKU 包含规格名、价格、库存、外部编码
4. 1688(阿里巴巴开放平台)
B2B 批发场景,接口侧重起订量、批发价、货期等字段。
表格
| 核心接口 | 功能 |
|---|---|
alibaba.product.add | 发布产品 |
alibaba.product.edit | 编辑产品 |
alibaba.product.repost | 重发产品(刷新排名) |
alibaba.category.get | 获取类目 |
关键差异:
- 必须填写 最小起订量(MOQ) 和 批发价格区间
- 支持 产品分组 和 运费模板 关联
5. 抖音电商(抖店开放平台)
表格
| 核心接口 | 功能 |
|---|---|
product.add | 创建商品 |
product.edit | 编辑商品 |
product.list | 获取商品列表 |
product.spec.add | 添加规格 |
关键注意点:
- 抖音对 商品类目 和 资质 审核严格,部分类目需要品牌授权或行业资质
- 视频/直播带货场景下,商品需额外绑定到直播间或短视频
二、跨境平台批量上货接口
1. Shopee / Lazada
表格
| 接口 | 功能 |
|---|---|
/api/v2/product/add_item | 创建商品 |
/api/v2/product/update_item | 更新商品 |
/api/v2/product/get_item_base_info | 获取商品信息 |
注意:
- 多站点(SG/MY/ID/TH/PH/VN)需分别授权,每个站点独立调用
2. TikTok Shop
表格
| 接口 | 功能 |
|---|---|
product.create | 创建商品 |
product.update | 更新商品 |
product.list | 获取商品列表 |
注意:
- 跨境店和本土店的字段要求不同,需区分报关参数和本地库存
- 需校验目标市场合规政策(如欧盟 CE 认证标注)
3. 亚马逊(SP-API)
表格
| 接口 | 功能 |
|---|---|
POST /listings/2021-08-01/items | 创建/更新 Listing |
GET /catalog/2022-04-01/items | 获取商品目录信息 |
POST /productTypeDefinitions | 获取商品类型定义(用于校验属性) |
注意:
- 需 AWS 账号 + 卖家店铺授权,签名使用 AWS SigV4,接入复杂度最高
- 多语言/多站点(US/EU/JP)需分别处理货币单位和语言
三、批量上货的技术实现方案
方案一:官方 API 直连(推荐)点击测试
适合有开发能力、追求稳定合规的团队。
plain
你的上货软件 → 调用各平台官方 API → 批量发布商品核心代码框架(Python 示例):
Python
import requestsimport hashlibimport timeimport hmacclass TaobaoUploader:
def __init__(self, app_key, app_secret, access_token):
self.app_key = app_key
self.app_secret = app_secret
self.access_token = access_token
self.gateway = "https://gw.api.taobao.com/router/rest"
def _sign(self, params):
# 参数排序 + HMAC-SHA256 签名
sorted_params = sorted(params.items())
query = ''.join(f"{k}{v}" for k, v in sorted_params)
sign = hmac.new(
self.app_secret.encode(),
query.encode(),
hashlib.sha256 ).hexdigest().upper()
return sign
def add_item(self, item_data):
"""发布单个商品"""
params = {
"method": "taobao.item.add",
"app_key": self.app_key,
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
"format": "json",
"v": "2.0",
"sign_method": "hmac-sha256",
"session": self.access_token,
# 商品必填字段
"num_iid": "", # 新发布留空
"title": item_data["title"],
"price": item_data["price"],
"num": item_data["stock"], # 库存
"cid": item_data["category_id"], # 类目ID
"desc": item_data["description"],
"props": item_data["properties"], # 商品属性
"sku_properties": item_data.get("sku_props", ""),
"sku_quantities": item_data.get("sku_quantities", ""),
"sku_prices": item_data.get("sku_prices", ""),
"sku_outer_ids": item_data.get("sku_outer_ids", ""),
}
params["sign"] = self._sign(params)
resp = requests.post(self.gateway, data=params, timeout=30)
return resp.json()
def batch_upload(self, items):
"""批量上货:循环调用,控制频率"""
results = []
for idx, item in enumerate(items):
try:
result = self.add_item(item)
results.append({"index": idx, "status": "success", "data": result})
# 控制频率:每10秒发一个,避免限流
if idx < len(items) - 1:
time.sleep(10)
except Exception as e:
results.append({"index": idx, "status": "failed", "error": str(e)})
return results方案二:第三方 ERP / SaaS 对接
如果你不想自己对接每个平台,可以接入成熟的电商 ERP,它们已经封装好了多平台 API:
表格
| 工具 | 支持平台 | 特点 |
|---|---|---|
| 店小秘 | 淘宝、拼多多、Shopee、Lazada、TikTok 等 | 全球用户超150万,跨平台采集+一键转化格式 |
| 芒果店长 | 多平台 | 轻量化,适合中小卖家 |
| 聚水潭 | 国内主流平台 | 深度对接库存、订单、供应链 |
| 万里牛 | 跨境+国内 | 跨境场景成熟 |
方案三:RPA 模拟人工(特殊场景)
部分平台(如 Shopee、敦煌网)对 API 批量行为有风控,API 上货可能导致新品权重降低。此时可用 RPA(机器人流程自动化) 模拟真人操作:
- 通过视觉识别和行为模拟,在卖家后台页面自动填写商品信息
- 配合指纹浏览器,随机化鼠标轨迹和输入速度
- 被平台算法识别为"真实活跃用户",SEO 初始权重更高
四、批量上货的关键注意事项
表格
| 问题 | 解决方案 |
|---|---|
| API 权限申请被拒 | 企业资质 + 详细使用场景说明,强调"提升商家运营效率"而非"数据采集" |
| 类目匹配错误 | 先用类目查询接口获取完整类目树,建立自有类目映射表 |
| 图片上传失败 | 压缩至 2MB 以内,格式 JPG/PNG,主图统一 800×800px,先上传获取平台图片 URL |
| SKU 规格混乱 | 建立标准化的 SKU 编码体系(如 颜色_尺码_款式),通过 outer_id 关联 |
| 频繁调用被限流 | 令牌桶算法控制并发,单应用淘宝约 500次/秒,京东 ≤200ms/次,超限用指数退避重试 |
| 跨平台字段不兼容 | 设计"标准商品数据模型",通过字段映射表转换到各平台格式 |
| 商品被判定重复铺货 | 标题做语义改写,主图差异化处理,避免完全相同的商品信息 |
| 库存超卖 | 发布时预留安全库存,通过库存同步 API 实时扣减 |
五、推荐接入路径
如果你现在已有上货软件,建议按以下步骤推进:
- 确定目标平台:先选 1-2 个核心平台(如淘宝+拼多多)跑通,再扩展
- 申请开发者账号:以企业身份注册各平台开放平台,申请"商品发布"权限
- 构建标准数据模型:统一你软件内部的商品字段,再映射到各平台
- 图片/资源预处理:搭建图片服务器或接入 OSS,实现图片自动压缩、上传、获取 URL
- 灰度测试:先用 10-20 个商品测试发布流程,验证字段映射和类目匹配
- 批量调度:用 APScheduler 或 Celery 实现定时/批量任务,加入失败重试和告警
- 监控与优化:跟踪发布成功率、审核通过率、商品曝光数据,持续优化