一、引言
在電商運(yùn)營與開發(fā)的廣闊領(lǐng)域中，優(yōu)惠券作為極具影響力的營銷利器，對于提升用戶購物意愿、促進(jìn)商品銷售發(fā)揮著關(guān)鍵作用。淘寶平臺以其海量的商品資源和龐大的用戶群體，構(gòu)建了一套豐富且復(fù)雜的優(yōu)惠券體系。而淘寶商品詳情優(yōu)惠券 API 接口的開放，猶如為開發(fā)者和商家打開了一扇通往精準(zhǔn)營銷與高效用戶服務(wù)的大門。借助這一接口，能夠精準(zhǔn)獲取與商品詳情緊密關(guān)聯(lián)的優(yōu)惠券信息，滿足電商數(shù)據(jù)整合、個性化營銷活動策劃、用戶精細(xì)化運(yùn)營等多方面的迫切需求，為打造更具競爭力的電商應(yīng)用與服務(wù)奠定堅實基礎(chǔ)。供稿者：Taobaoapi2014
二、接口概述
（一）功能介紹
- 優(yōu)惠券精準(zhǔn)檢索：該接口允許開發(fā)者依據(jù)商品 ID，精準(zhǔn)篩選出與特定商品相關(guān)的優(yōu)惠券。無論是商品專屬優(yōu)惠券，還是店鋪通用但適用于該商品的優(yōu)惠券，都能一網(wǎng)打盡。例如，輸入一款熱門手機(jī)的商品 ID，接口可返回該手機(jī)在促銷活動中的滿減優(yōu)惠券、贈品優(yōu)惠券等，幫助用戶在購買商品時享受更多優(yōu)惠。
- 優(yōu)惠券詳情深度獲取：對于檢索到的優(yōu)惠券，通過接口能獲取其詳細(xì)信息。包括優(yōu)惠券面額，如滿 300 元減 50 元中的 50 元；使用門檻，即滿減條件中的消費金額限制；領(lǐng)取條件，如是否為新用戶專享、特定會員等級可領(lǐng)等；有效期，明確優(yōu)惠券的可使用時間段；適用范圍，確定是僅適用于指定商品，還是整個店鋪的部分或全部商品；以及最重要的優(yōu)惠券領(lǐng)取鏈接，方便用戶直接領(lǐng)取使用。
- 優(yōu)惠券動態(tài)狀態(tài)監(jiān)測：接口還具備監(jiān)測優(yōu)惠券實時狀態(tài)的功能。可實時查詢某張優(yōu)惠券是否已被用戶領(lǐng)取，以及剩余可領(lǐng)取數(shù)量。這對于電商平臺及時調(diào)整優(yōu)惠券展示策略，避免向用戶展示已領(lǐng)完的優(yōu)惠券，提升用戶體驗至關(guān)重要。
（二）數(shù)據(jù)輸入
- 商品 ID：這是調(diào)用該接口的核心參數(shù)。商品 ID 是淘寶平臺賦予每個商品的唯一標(biāo)識，如同商品的 “身份證”。在淘寶商品鏈接中，通常清晰顯示商品 ID。
- 可選篩選參數(shù)：部分接口支持一些可選篩選參數(shù)，用于進(jìn)一步細(xì)化優(yōu)惠券檢索結(jié)果。例如，可設(shè)置優(yōu)惠券面額范圍，篩選出特定價格區(qū)間內(nèi)的優(yōu)惠券，如只獲取面額在 20 元至 100 元之間的優(yōu)惠券；還可指定優(yōu)惠券類型，如普通滿減券、折扣券、贈品券等；或者按照有效期進(jìn)行篩選，獲取在未來一周內(nèi)即將生效或即將過期的優(yōu)惠券，以滿足不同業(yè)務(wù)場景下的個性化需求。
（三）數(shù)據(jù)輸出
- 優(yōu)惠券列表：當(dāng)輸入商品 ID 及相關(guān)篩選參數(shù)后，接口返回的是一個 JSON 格式的優(yōu)惠券列表。列表中的每個元素都是一個包含詳細(xì)優(yōu)惠券信息的 JSON 對象，大致結(jié)構(gòu)如下：
[ { "coupon_id": "123456789", "coupon_amount": 50, "min_order_amount": 300, "領(lǐng)取條件": "新用戶專享", "start_time": "2024 - 10 - 01 00:00:00", "end_time": "2024 - 10 - 15 23:59:59", "適用范圍": "指定商品：手機(jī)（商品ID：654321）", "領(lǐng)取鏈接": "https://xxx.taobao.com/coupon領(lǐng)取" }, { "coupon_id": "987654321", "coupon_amount": 100, "min_order_amount": 500, "領(lǐng)取條件": "店鋪V3會員及以上", "start_time": "2024 - 10 - 05 00:00:00", "end_time": "2024 - 10 - 20 23:59:59", "適用范圍": "店鋪內(nèi)全品類商品", "領(lǐng)取鏈接": "https://yyy.taobao.com/coupon領(lǐng)取" }]
- 優(yōu)惠券狀態(tài)信息：在查詢優(yōu)惠券實時狀態(tài)時，接口返回一個簡潔的 JSON 對象，明確顯示優(yōu)惠券的領(lǐng)取狀態(tài)。例如：{"coupon_id": "123456789", "is_claimed": true, "remaining_count": 100}，表示該優(yōu)惠券已被領(lǐng)取，且剩余可領(lǐng)取數(shù)量為 100 張；若is_claimed為false，則表明優(yōu)惠券尚未被領(lǐng)取。
三、Python 請求示例
import requests
import hashlib
import time
import json
# # 封裝好的第三方數(shù)據(jù)商平臺接口，復(fù)制鏈接獲取測試。
demo url=http://c0b.cc/R4rbK2 wechat id:Taobaoapi2014
app_key = "your_app_key"
app_secret = "your_app_secret"
# 接口地址
url = "https://eco.taobao.com/router/rest"
# 商品ID
product_id = "654321"
# 生成簽名
timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
params = {
"app_key": app_key,
"method": "taobao.tbk.item.coupon.get",
"timestamp": timestamp,
"format": "json",
"v": "2.0",
"num_iid": product_id,
"coupon_start_fee": 20, # 篩選最小面額20元的優(yōu)惠券
"coupon_end_fee": 100 # 篩選最大面額100元的優(yōu)惠券
}
param_str = ""
for key in sorted(params.keys()):
param_str += key + str(params[key])
sign_str = app_secret + param_str + app_secret
sign = hashlib.md5(sign_str.encode('utf - 8')).hexdigest().upper()
params["sign"] = sign
# 發(fā)送請求
response = requests.get(url, params = params)
# 解析響應(yīng)數(shù)據(jù)
if response.status_code == 200:
data = json.loads(response.text)
if "results" in data and "tbk_coupon" in data["results"]:
coupons = data["results"]["tbk_coupon"]
for coupon in coupons:
print("優(yōu)惠券ID:", coupon["coupon_id"])
print("優(yōu)惠券面額:", coupon["coupon_amount"])
print("使用門檻:", coupon["min_order_amount"])
print("-------------------")
else:
print("未獲取到優(yōu)惠券信息，錯誤信息:", data["error_response"]["msg"])
else:
print("請求失敗，狀態(tài)碼:", response.status_code)
