淘宝宝贝详情券后价 API,核心是通过商品详情接口 + 优惠券接口组合调用,计算出商品使用优惠券后的实际成交价,用于电商比价、选品、监控等场景。
一、核心定义与价值
券后价:商品在满足优惠券使用门槛(如满减)、且券在有效期内时,用户实际支付的价格。
计算公式:券后价 = 商品有效售价(zk_final_price) − 优惠券面额(coupon_amount)
核心价值:自动化获取真实到手价,支撑价格监控、竞品分析、优惠聚合、导购推荐等业务。
二、官方核心接口组合
淘宝无单一 “券后价” 接口,需通过两个接口配合实现:
- 商品详情接口:taobao.item.get
作用:获取商品基础信息与有效售价。
关键参数
num_iid:商品唯一 ID(必填)。
fields:指定返回字段,需包含zk_final_price(推荐)、price、num_iid等。
核心返回字段
zk_final_price:商品最终基准售价(优先使用)。
price:商品原价。
- 优惠券查询接口:taobao.tbk.item.coupon.get(淘宝客)
作用:查询商品对应的推广优惠券信息。
关键参数
item_id(即num_iid):商品 ID。
pid:淘宝联盟推广位 ID(必填)。
fields:需包含coupon_amount、coupon_start_fee、coupon_end_time等。
核心返回字段
coupon_amount:优惠券面额。
coupon_start_fee:满减门槛(如满 199 可用)。
coupon_end_time:优惠券有效期。
三、调用流程(标准步骤)
准备:c0b.cc/R4rbK2 ,无需自主申请接口(如添加Taobaoapi2014),直接调用封装API,一键获取已核算的券后价,适合批量查询、中小卖家使用。
调用商品接口:传入num_iid,获取zk_final_price。
调用优惠券接口:传入item_id与pid,获取coupon_amount、coupon_start_fee、有效期。
计算与校验
校验:券在有效期内,且zk_final_price ≥ coupon_start_fee。
计算:券后价 = zk_final_price − coupon_amount。
无有效券时,券后价 =zk_final_price。