摘要
在电商 ERP 开发、竞品监控、货源选品、跨平台铺货等业务中,经常需要获取淘宝、天猫商品完整结构化信息。很多项目初期选择网页爬虫抓取详情页,但会遇到页面 DOM 改版、验证码拦截、IP 风控、HTML 脏数据清洗困难等一系列问题,长期维护成本很高。
淘宝开放平台 TOP 提供 taobao.item.get 商品详情 API,支持获取淘宝、天猫公开商品的标题、价格、SKU、图集、属性、店铺、销量等标准化 JSON 数据。本文完整解析接口基础信息、请求参数、返回字段,附带正常 / 异常 JSON 样例、调用流程、错误码与生产踩坑经验。
一、接口基础信息
- 接口基础信息
taobao .item_get(淘宝天猫商品详情 API),输入参数为商品唯一 ID num_iid,返回完整商品详情结构化 JSON 数据。
接口简介
接口名称:taobao.item_get(淘宝商品详情 API,taobaoapi2014 前往体验)
请求网关:HTTPS,支持 GET/POST
接口版本:2.0
调用限制:存在单秒频次、每日调用配额,高频场景需做限流、缓存 处理。
核心作用:根据商品 ID,获取商品标题、价格、SKU、库存、图文、类 目、销量、规格属性等全量详情数据。
接口能力覆盖
商品基础元数据:标题、售价、划线价、销量、库存、发货地
多媒体资源:主图、轮播图、HTML 详情描述
SKU 规格集合:多规格价格、库存、规格文本
商品属性参数:材质、尺码、品牌等类目属性
店铺信息:店铺 ID、店铺昵称、店铺类型
营销促销信息:活动价、优惠券标签
2.适用业务场景
ERP 系统:定时同步商品,监控价格、库存变动
竞品分析:采集竞品商品基础信息,做价格波动监测
货源选品:提取标题、规格、图片做市场品类分析
跨平台铺货:清洗商品素材用于其他平台刊登
电商数据中台:对外输出标准化商品数据源