企业级实战:淘宝商品详情 API 简要说明
一、接口说明
- 接口标识:
taobao.item.get/taobao.item.get_full - 作用:通过商品 ID(
num_iid)获取淘宝 / 天猫商品完整结构化数据 - 适用场景:商品中台、ERP 同步、跨平台铺货、价格监控、数据分析
- 传输格式:
JSON - 鉴权方式:
AppKey + AppSecret签名,企业版需店铺授权session
二、核心请求参数(极简)
num_iid:商品 ID(必传)fields:指定返回字段(可选)format=json:数据格式
三、企业级 JSON 返回参考(精简标准结构)
json
{ "item_get_response": { "item": { "num_iid": 680123456789, "title": "2026夏季新款纯棉透气短袖T恤", "price": "89.00", "promotion_price": "59.00", "num": 560, "sales": 12860, "cid": 50015261, "category_name": "女装>T恤", "pic_url": "https://img.taobao.com/imgextra/i1/xxx.jpg", "location": "广东 广州", "nick": "XX品牌旗舰店", "seller_id": 123456789, "modified": "2026-05-16 10:22:33", "sku_list": { "sku": [ { "sku_id": 12345678901, "price": "59.00", "quantity": 120, "properties_name": "颜色:白色;尺码:L" } ] }, "desc": "<p>商品详情描述HTML</p>" }, "request_id": "req_2405161022001234" } }
四、关键字段(企业必用)
num_iid:商品唯一 IDtitle:商品标题price / promotion_price:原价 / 活动价num:库存sales:销量pic_url:主图sku_list:多规格信息modified:最后更新时间(增量同步用)request_id:全链路排错标识
五、企业级稳定性要点(极简)
- 控制 QPS,避免限流
- 超时重试(指数退避)
- 字段非空 + 格式校验
- Redis 缓存热点商品
- 异常日志 + 监控告警
- 接口异常使用缓存兜底