淘宝商品详情、优惠券及券后价接口获取指南

2501_90907859

于 2025-03-19 10:43:32 发布

阅读量951

点赞数 27

分类专栏：淘宝开发API接口文章标签：前端数据库 linux

本文链接：https://blog.csdn.net/2501_90907859/article/details/146362815

版权

淘宝开发API接口专栏收录该内容

11 篇文章

订阅专栏

在电商领域，淘宝作为国内领先的电商平台，拥有海量的商品和丰富的优惠活动。对于技术开发者来说，获取淘宝商品的详情、优惠券以及券后价是实现电商应用功能的重要环节。本文将详细介绍如何通过淘宝开放平台的API接口获取这些信息，并提供实际的代码示例。

一、淘宝商品详情接口

淘宝商品详情接口（item_get）是淘宝开放平台提供的一个API接口，允许开发者通过商品ID获取商品的详细信息，包括标题、价格、销量、库存、图片、描述等。

请求参数

num_iid：商品ID，必填参数，用于指定要查询的商品。
is_promotion：是否获取促销价，取值为1或0，1表示获取促销价。
fields：可选参数，指定返回的字段列表，如title,price,desc等。

请求示例

http

GET /router/rest?method=taobao.item.get&app_key=YOUR_APP_KEY&app_secret=YOUR_APP_SECRET&timestamp=TIMESTAMP&v=2.0&format=json&fields=num_iid,title,price,detail_url,pic_url&num_iid=520813250866

返回数据

返回的数据通常包括以下字段：

num_iid：商品ID。
title：商品标题。
price：商品价格。
detail_url：商品详情页URL。
pic_url：商品主图URL。

二、淘宝优惠券接口

淘宝优惠券接口（item_search_coupon）用于根据商品ID或关键词查询相关的优惠券信息。通过该接口，可以获取优惠券的类型、金额、有效期、使用条件等。

请求参数

q：商品ID或关键词，用于搜索相关的优惠券。
adzone_id：推广位ID，用于统计推广效果。
page_no 和 page_size：分页参数，用于控制返回的优惠券数量。

请求示例

http

GET /router/rest?method=taobao.tbk.coupon.get&app_key=YOUR_APP_KEY&app_secret=YOUR_APP_SECRET&timestamp=TIMESTAMP&v=2.0&format=json&adzone_id=YOUR_ADZONE_ID&q=520813250866

返回数据

返回的数据包括优惠券的详细信息，例如：

num_iid：商品ID。
coupons：优惠券列表，包含优惠券的金额、有效期、使用条件等。

三、计算券后价

虽然淘宝API没有直接提供“券后价”字段，但可以通过获取商品的原价和适用的优惠券金额，自行计算券后价。

计算步骤

获取商品原价：通过item_get接口获取商品的原价。
获取优惠券金额：通过item_search_coupon接口获取适用的优惠券金额。
计算券后价：根据优惠券的使用条件，从商品原价中减去优惠券金额。

示例代码（Python）

Python

import requests
import json

# 配置API密钥和接口地址
APP_KEY = 'YOUR_APP_KEY'
APP_SECRET = 'YOUR_APP_SECRET'
ITEM_GET_URL = 'http://gw.api.taobao.com/router/rest'
COUPON_GET_URL = 'http://gw.api.taobao.com/router/rest'

# 获取商品原价
def get_item_price(item_id):
    params = {
        'method': 'taobao.item.get',
        'app_key': APP_KEY,
        'app_secret': APP_SECRET,
        'timestamp': '2024-11-27 12:00:00',
        'v': '2.0',
        'format': 'json',
        'fields': 'num_iid,title,price',
        'num_iid': item_id
    }
    response = requests.get(ITEM_GET_URL, params=params)
    data = json.loads(response.text)
    return float(data['item']['price'])

# 获取优惠券信息
def get_coupon_info(item_id):
    params = {
        'method': 'taobao.tbk.coupon.get',
        'app_key': APP_KEY,
        'app_secret': APP_SECRET,
        'timestamp': '2024-11-27 12:00:00',
        'v': '2.0',
        'format': 'json',
        'adzone_id': 'YOUR_ADZONE_ID',
        'q': item_id
    }
    response = requests.get(COUPON_GET_URL, params=params)
    data = json.loads(response.text)
    coupons = data.get('coupons', [])
    if coupons:
        return float(coupons[0]['amount'])
    return 0

# 计算券后价
def calculate_post_coupon_price(item_id):
    original_price = get_item_price(item_id)
    coupon_amount = get_coupon_info(item_id)
    post_coupon_price = original_price - coupon_amount
    return post_coupon_price

# 示例：计算商品的券后价
item_id = '520813250866'  # 示例商品ID
post_coupon_price = calculate_post_coupon_price(item_id)
print(f'商品ID为{item_id}的券后价为：{post_coupon_price}')