taobao.item.get 是淘宝开放平台获取单个宝贝完整详情的核心 API,通过商品 ID(num_iid)一键拉取结构化数据,是反向海淘、代购、比价、ERP 同步的基础能力。
一、接口定位与核心能力
1. 接口基本信息
- 接口名:
taobao.item.get(基础版) - 完整版:
taobao.item_get_full(含详情 HTML、运费、售后) - 请求方式:POST/GET(推荐 POST)
- 返回格式:JSON(默认)/ XML
- 版本:
2.0
2. 核心数据能力(一键获取)
- 基础信息:
num_iid、标题、主图、价格、原价、销量、类目、店铺信息 - 规格 SKU:多规格价格、库存、属性、SKU 图
- 商品属性:材质、品牌、尺寸、颜色等结构化属性
- 营销信息:促销价、优惠券、包邮、活动标签
- 详情内容:商品描述(HTML / 文本)、售后服务
3. 适用场景
- 反向海淘 / 代购系统:商品采集、详情展示、价格监控
- 电商 ERP:商品信息同步、库存管理
- 比价 / 选品工具:竞品分析、价格预警
- 自建商城:一键上架淘宝商品
二、调用前置条件(必做)
1. 账号与应用
- 完成个人 / 企业认证(企业认证支持完整 SKU / 库存字段)
- 创建服务型应用,获取
AppKey+AppSecret(核心凭证)
2. 权限申请
- 在开放平台申请
taobao.item.get权限 - 免费版:基础字段、每日限额(个人约 1000 次 / 天)
- 企业版:完整字段、更高调用量(需提交业务场景审核)
3. 关键限制(2026 最新)
- 个人账号:≤10 次 / 分钟,QPS≤2,无 SKU / 库存权限
- 企业账号:≤100 次 / 分钟,QPS≤50,支持完整字段
- 触发限流返回
code=10014,需指数退避重试(1s→2s→4s)