淘宝 API 接口依据功能定位可分为商品管理类、订单处理类、用户与营销类、物流与支付类、数据分析类、工具与扩展类等六大核心类别,以下是其详细分类及应用案例介绍:

淘宝 API 接口详细分类

  1. 商品管理类 API
    • 核心接口taobao.item.get获取商品详情;taobao.item.search按关键词搜索商品 ID 列表;taobao.item.update修改商品信息;taobao.item.sku.get获取商品规格。
  2. 订单处理类 API
    • 核心接口taobao.trade.get查询订单详情;taobao.trade.create创建新订单;taobao.trade.shipping更新物流状态;taobao.refund.apply处理退款申请。
  3. 用户与营销类 API
    • 核心接口taobao.user.get获取用户基本信息;taobao.promotion.get查询促销活动;taobao.coupon.send发放优惠券;taobao.recommend.get获取个性化商品推荐。
  4. 物流与支付类 API
    • 核心接口taobao.logistics.trace查询物流轨迹;taobao.payment.confirm确认支付结果;taobao.waybill.apply申请电子面单。
  5. 数据分析类 API
    • 核心接口taobao.report.get获取销售报表;taobao.shop.data查询店铺统计数据;taobao.item.sales分析商品销量趋势。
  6. 工具与扩展类 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"] 商品详情图片

应用案例

  1. 商品管理类 API 应用案例:某服装品牌通过taobao.item.update接口实现新品批量上架,效率提升 300%。比价网站利用taobao.item.search接口实时抓取竞品价格,优化定价策略。
  2. 订单处理类 API 应用案例:跨境电商通过taobao.trade.shipping接口对接国际物流系统,实现全程可视化追踪。大促期间利用taobao.trade.create接口自动分拣订单,处理效率提升 50%。
  3. 用户与营销类 API 应用案例:某美妆品牌通过taobao.user.get接口分析用户购买记录,定向推送专属优惠券,复购率提升 30%。电商平台利用taobao.recommend.get接口实现 “千人千面” 首页推荐,转化率提高 18%。
  4. 物流与支付类 API 应用案例:物流企业通过taobao.logistics.trace接口为买家提供实时物流更新,纠纷率下降 40%。支付平台集成taobao.payment.confirm接口实现 T+0 结算,资金周转效率提升 2 倍。
  5. 数据分析类 API 应用案例:某代运营公司通过taobao.report.get接口生成动态定价模型,毛利率提升 12%。品牌方利用taobao.shop.data接口优化广告投放策略,ROI 提高 25%。
  6. 工具与扩展类 API 应用案例:移动端 APP 通过taobao.image.upload接口实现商品图片快速上传,发布效率提升 70%。客服系统集成taobao.message.push接口自动发送物流提醒,用户满意度提高 35%。
Logo

电商企业物流数字化转型必备!快递鸟 API 接口,72 小时快速完成物流系统集成。全流程实战1V1指导,营造开放的API技术生态圈。

更多推荐