淘宝API接口的详细分类和应用案例
商品管理类 API 应用案例:某服装品牌通过taobao.item.update接口实现新品批量上架,效率提升 300%。比价网站利用taobao.item.search接口实时抓取竞品价格,优化定价策略。订单处理类 API 应用案例:跨境电商通过taobao.trade.shipping接口对接国际物流系统,实现全程可视化追踪。大促期间利用taobao.trade.create接口自动分拣订单,

淘宝 API 接口依据功能定位可分为商品管理类、订单处理类、用户与营销类、物流与支付类、数据分析类、工具与扩展类等六大核心类别,以下是其详细分类及应用案例介绍:
淘宝 API 接口详细分类
- 商品管理类 API
- 核心接口:
taobao.item.get获取商品详情;taobao.item.search按关键词搜索商品 ID 列表;taobao.item.update修改商品信息;taobao.item.sku.get获取商品规格。
- 核心接口:
- 订单处理类 API
- 核心接口:
taobao.trade.get查询订单详情;taobao.trade.create创建新订单;taobao.trade.shipping更新物流状态;taobao.refund.apply处理退款申请。
- 核心接口:
- 用户与营销类 API
- 核心接口:
taobao.user.get获取用户基本信息;taobao.promotion.get查询促销活动;taobao.coupon.send发放优惠券;taobao.recommend.get获取个性化商品推荐。
- 核心接口:
- 物流与支付类 API
- 核心接口:
taobao.logistics.trace查询物流轨迹;taobao.payment.confirm确认支付结果;taobao.waybill.apply申请电子面单。
- 核心接口:
- 数据分析类 API
- 核心接口:
taobao.report.get获取销售报表;taobao.shop.data查询店铺统计数据;taobao.item.sales分析商品销量趋势。
- 核心接口:
- 工具与扩展类 API
- 核心接口:
taobao.image.upload上传商品图片;taobao.message.push发送站内信 / 短信通知;taobao.oauth2.token用户授权与认证。
- 核心接口:
淘宝/天猫获得淘宝商品详情高级版 API 返回值说明
item_get_pro-获得淘宝商品详情高级版
taobao.item_get_pro
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
| secret | String | 是 | 调用密钥 |
| api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
| cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
| result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
| lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
| version | String | 否 | API版本 |
请求参数
请求参数:num_iid=520813250866
参数说明:num_iid:淘宝商品ID
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
|
num_iid |
Bigint | 0 | 520813250866 | 宝贝ID |
|
title |
String | 0 | 三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮 | 宝贝标题 |
|
desc_short |
String | 0 | 商品简介 | |
|
promotion_price |
Int | 0 | 优惠价 | |
|
price |
Float | 0 | 25.8 | 价格(商品原价以及券前价) |
|
total_price |
Float | 0 | 0 | |
|
suggestive_price |
Float | 0 | 0 | |
|
orginal_price |
String | 0 | 25.80 | 原价 |
|
nick |
String | 0 | 欢乐购客栈 | 掌柜昵称 |
|
num |
Int | 0 | 3836 | 库存 |
|
min_num |
Int | 0 | 0 | 最小购买数 |
|
detail_url |
String | 0 | http://item.taobao.com/item.htm?id=520813250866 | 宝贝链接 |
|
pic_url |
String | 0 | //gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg | 宝贝图片 |
|
brand |
String | 0 | 三刃木 | 品牌名称 |
|
brandId |
Int | 0 | 8879363 | 品牌ID |
|
rootCatId |
Int | 0 | 50013886 | 顶级分类ID |
|
cid |
Int | 0 | 50014822 | |
|
desc |
String | 0 | 商品详情 | |
|
ship_time |
String | 0 | 发货时间 | |
|
item_imgs |
Mix | 0 | [{ "url": "//gd3.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg"} | 商品图片 |
|
item_weight |
String | 0 | ||
|
express_fee |
Float | 0 | 0.00 | 快递费用 |
|
ems_fee |
Float | 0 | EMS费用 | |
|
post_fee |
Float | 0 | 物流费用 | |
|
shipping_to |
String | 0 | 发货至 | |
|
sample_id |
String | 0 | 商品风格标识ID | |
|
props_name |
String | 0 | 1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子; | 商品属性名 |
|
prop_imgs |
Mix | 0 | {"prop_img": [ {"properties": "1627207:1347647754", "url": "//gd2.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg"}]} | 商品属性图片列表 |
|
props_imgs |
Mix | 0 | {"prop_img": [ {"properties": "1627207:1347647754", "url": "//gd2.alicdn.com/imgextra/i3/2596264565/TB2.XeblVXXXXXkXpXXXXXXXXXX_!!2596264565.jpg"}]} | 商品属性图片列表 |
|
property_alias |
String | 0 | 20509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色 | 商品属性别名 |
|
props |
Mix | 0 | [{ "name": "产地","value": "中国" }] | 商品属性 |
|
total_sold |
Int | 0 | 10 | |
|
skus |
Mix | 0 | {"sku": [{"price": "39", "total_price": null, "orginal_price": "39.00", "properties": "1627207:1347647754", "properties_name": "1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子", "quantity": "305", "sku_id": "3166598625985"}] | 商品规格信息列表 |
|
seller_id |
Int | 0 | 2844096782 | 卖家ID |
|
sales |
Int | 0 | 138 | 销量 |
|
shop_id |
Int | 0 | 151372205 | 店铺ID |
|
props_list |
Mix | 0 | {20509:9974422: 尺码:36} | 商品属性 |
|
seller_info |
Mix | 0 | {"nick": "欢乐购客栈", "city": null, "level": 12, "bail": "2000", "rate": 96, "score": "4.8", "delivery_score": "4.8", "item_score": "4.8", "shop_type": null, "user_num_id": "2596264565", "sid": "127203758", "title": "欢乐购客栈", "zhuy": "//shop127203758.taobao.com", "company_name": null, "menu": [] } | 卖家信息 |
|
tmall |
Boolean | 0 | false | 是否天猫 |
|
error |
String | 0 | 错误信息 | |
|
favcount |
Int | 0 | 4824 | |
|
fanscount |
Int | 0 | 4824 | |
|
location |
String | 0 | 广东深圳 | 发货地 |
|
props_img |
Mix | 0 | 1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg | 属性图片 |
|
desc_img |
Mix | 0 | ["http://img.alicdn.com/imgextra/i1/2596264565/TB2sGR3lVXXXXblXpXXXXXXXXXX_!!2596264565.jpg_q90.jpg"] | 商品详情图片 |
应用案例
- 商品管理类 API 应用案例:某服装品牌通过
taobao.item.update接口实现新品批量上架,效率提升 300%。比价网站利用taobao.item.search接口实时抓取竞品价格,优化定价策略。 - 订单处理类 API 应用案例:跨境电商通过
taobao.trade.shipping接口对接国际物流系统,实现全程可视化追踪。大促期间利用taobao.trade.create接口自动分拣订单,处理效率提升 50%。 - 用户与营销类 API 应用案例:某美妆品牌通过
taobao.user.get接口分析用户购买记录,定向推送专属优惠券,复购率提升 30%。电商平台利用taobao.recommend.get接口实现 “千人千面” 首页推荐,转化率提高 18%。 - 物流与支付类 API 应用案例:物流企业通过
taobao.logistics.trace接口为买家提供实时物流更新,纠纷率下降 40%。支付平台集成taobao.payment.confirm接口实现 T+0 结算,资金周转效率提升 2 倍。 - 数据分析类 API 应用案例:某代运营公司通过
taobao.report.get接口生成动态定价模型,毛利率提升 12%。品牌方利用taobao.shop.data接口优化广告投放策略,ROI 提高 25%。 - 工具与扩展类 API 应用案例:移动端 APP 通过
taobao.image.upload接口实现商品图片快速上传,发布效率提升 70%。客服系统集成taobao.message.push接口自动发送物流提醒,用户满意度提高 35%。
更多推荐

所有评论(0)