一、接口简介
1.接口全称:taobao.item.get
协议:HTTPS GET/POST,返回 JSON/XML
定位:淘宝开放平台 TOP 核心单品查询接口,根据商品 num_iid(商品 ID)获取淘宝 / 天猫商品结构化全量数据,是铺货、ERP、竞品监控、导购、跨境供应链底层依赖接口
限流基准:基础应用 QPS=2,企业级可提额;单次仅支持 1 个商品 ID 批量查用taobao.item.batchget
- 业务核心入参
num_iid:商品唯一数字 ID(URL id=xxxx 取值),单请求仅支持 1 个
fields:核心控制字段,按需传入,过度请求会限流 / 无权限
场景化 fields 组合(直接复制使用)
轻量比价 / 卡片展示
num_iid,title,price,pic_url,item_imgs,approve_status
无货源跨平台铺货(最全)
num_iid,title,price,desc,item_imgs,sku,skus,props_name,cid,category,stock_num,outer_id,delist_time,item_weight,item_size
ERP 库存价格监控
num_iid,price,sku,skus,stock_num,approve_status,modified
竞品数据分析
num_iid,title,price,sold,volume,shop_id,shop_name,cid,props_name,desc
仅商品图文详情
num_iid,desc,item_imgs,pic_url - 签名生成标准流程
剔除sign参数,剩余参数按 key ASCII 升序排序
拼接 app_secret + k1v1k2v2... + app_secret
MD5 UTF-8 加密,转大写字符串作为 sign
Python 标准签名函数见文末代码示例
二、八大全业务场景(落地逻辑 + 字段需求 + 开发方案)
场景 1:无货源跨平台铺货(最高频场景:淘宝→拼多多 / 抖音 / 1688/Ozon/Temu)
业务需求
批量采集淘宝商品,自动清洗图片、标题、SKU、规格,一键上架多电商平台,搭建铺货 ERP
依赖 fields
num_iid,title,price,item_imgs,desc,skus,props_name,cid,stock_num,item_weight
完整落地流程
批量商品 ID 队列,循环调用 item.get 获取全素材
数据清洗规则:
标题:过滤 “天猫 / 旗舰店 / 限时特惠” 等平台专属词,适配目标平台标题长度限制
图片:阿里 cdn 链接转存自有图床,避免盗图拦截
SKU 规格:拆分properties为颜色 / 尺码二维数组,匹配目标平台规格模板
价格:设置加价倍率,区分划线价、售价、活动价
调用目标平台上架 API 批量提交商品
定时轮询 item.get 监控源商品价格 / 库存变动,同步更新下游店铺
痛点与优化
限流 QPS=2:添加 Redis 缓存,单商品缓存 30 分钟,减少重复调用
详情 HTML 含悬浮窗、天猫活动标签:正则过滤无用 DOM 标签
场景 2:ERP / 自有店铺商品管理系统
业务需求
自有天猫 / 淘宝店铺内部商品库管理、库存预警、价格统一管控、上下架状态同步
依赖 fields
num_iid,title,price,skus,stock_num,approve_status,modified,delist_time
落地逻辑
全店商品定时全量拉取,存入数据库建立商品主表 + SKU 子表
增量同步:对比modified字段,仅更新变更商品
库存预警:单 SKU quantity 低于阈值推送企业微信 / 钉钉告警
价格监控:检测原价 / 活动价变动,记录价格日志,防止错价亏损
下架商品自动标记,前台商城隐藏商品入口
场景 3:淘客返利 / 导购小程序 / 比价网站
业务需求
商品卡片展示、实时券后价、同款比价、降价提醒、好物推荐
依赖 fields
num_iid,title,price,pic_url,item_imgs,shop_name,sold,volume
佣金、优惠券需搭配tbk.item.info.get淘客接口组合使用
业务流程
用户输入商品 ID / 粘贴链接,调用 item.get 渲染商品详情卡片
多商品批量拉取,做同款价格排序比价
定时轮询价格,价格下跌触发公众号 / 短信降价提醒
提取销量sold做爆款排序推荐
场景 4:竞品监控 & 行业市场数据分析
业务需求
同行竞品价格、销量、库存、规格变动监测,行业价格带分析、爆款挖掘
依赖 fields
num_iid,title,price,sold,volume,shop_id,cid,props_name,skus
落地方案
竞品清单入库,每 10 分钟轮询 item.get
指标采集:售价、SKU 阶梯价、月销量、总库存、规格增减
数据入库做时序图表:价格波动曲线、销量趋势
预警规则:竞品大幅降价、新增规格、库存清仓触发运营提醒
类目批量采集,统计类目主流定价区间,辅助选品定价
场景 5:跨境电商供应链 / 一件代发系统
业务需求
跨境 Temu/Ozon/Shopee 货源采集、国内代发货源库搭建、重量尺寸获取用于物流报价
依赖 fields
num_iid,title,price,item_imgs,desc,skus,item_weight,item_size,stock_num
核心业务逻辑
采集淘宝货源商品,翻译标题 / 详情为英文、俄文等多语言
通过item_weight计算国际物流运费,自动生成跨境售价
SKU 库存实时同步,避免跨境超卖
详情图批量本地化,适配跨境平台图片尺寸规范
场景 6:电商内容工具 / 自媒体好物库
业务需求
短视频 / 图文带货素材自动生成、商品文案批量产出、素材库搭建
依赖 fields
num_iid,title,pic_url,item_imgs,desc,props_name
使用方式
拉取商品主图、详情图自动打包素材包
解析商品参数props_name自动生成种草文案、短视频标题
搭建商品素材库,支持按类目、价格筛选带货商品
场景 7:商品质检 / 违规风控工具
业务需求
监控商品违规下架、库存清零、价格异常,批量排查店铺违规商品
依赖 fields
num_iid,approve_status,delist_time,stock_num,price
流程
批量拉取店铺全部商品状态
识别forbidden封禁商品、instock下架商品,记录下架时间
检测价格异常(0 元、超低价)标记风险商品,人工复核
场景 8:以图搜款配套数据源(CV 识图系统)
业务需求
识图返回商品 ID 后,调用 item.get 补齐完整商品信息,用于同款推荐
依赖 fields
num_iid,title,price,pic_url,item_imgs,skus
联动逻辑
图片检索返回 num_iid 列表
批量调用 item.get 获取商品基础信息,渲染同款商品列表