淘宝宝贝详情券后价获取指南

5 阅读2分钟

淘宝宝贝详情券后价 API,核心是通过商品详情接口 + 优惠券接口组合调用,计算出商品使用优惠券后的实际成交价,用于电商比价、选品、监控等场景。

一、核心定义与价值

券后价:商品在满足优惠券使用门槛(如满减)、且券在有效期内时,用户实际支付的价格。

计算公式:券后价 = 商品有效售价(zk_final_price) − 优惠券面额(coupon_amount)

核心价值:自动化获取真实到手价,支撑价格监控、竞品分析、优惠聚合、导购推荐等业务。

二、官方核心接口组合

淘宝无单一 “券后价” 接口,需通过两个接口配合实现:

  1. 商品详情接口:taobao.item.get

作用:获取商品基础信息与有效售价

关键参数

num_iid:商品唯一 ID(必填)。

fields:指定返回字段,需包含zk_final_price(推荐)、price、num_iid等。

核心返回字段

zk_final_price:商品最终基准售价(优先使用)。

price:商品原价。

  1. 优惠券查询接口: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。