淘宝商品详情API接口全攻略-CRMEB社区

淘宝商品详情API接口全攻略

管理

编辑

删除

一、引言

在电商开发领域，获取准确且详细的商品信息对于众多业务场景至关重要。淘宝，作为国内电商行业的领军者，拥有海量丰富的商品资源。其开放的商品详情 API 接口，为开发者搭建了一座通往淘宝庞大商品数据库的桥梁。借助该接口，开发者能够获取到商品的全方位信息，从基本属性到复杂的营销信息，涵盖了商品详情页展示的几乎所有数据，极大地满足了电商数据整合、数据分析、商品推荐等业务需求。无论是构建电商导购平台、进行竞品分析，还是开发智能选品工具，淘宝商品详情 API 接口都发挥着不可或缺的作用。供稿者：Taobaoapi2014

二、接口概述

（一）功能介绍

淘宝商品详情 API 接口的核心功能是根据用户输入的商品 ID，精准返回该商品在淘宝平台上的详细信息。这些信息包括但不限于：

商品基础信息：商品名称、品牌、型号、颜色、尺码等，帮助用户清晰识别商品的基本属性。
价格信息：当前售价、原价、促销价格及对应的促销规则，为用户提供商品价格的全面了解，以便进行价格比较和促销活动分析。
商品图片与视频：主图、详情图以及可能存在的商品展示视频链接，让用户能够直观感受商品外观与细节。
商品描述：详细的商品介绍，包括材质、功能、使用方法等，有助于用户深入了解商品特性，辅助购买决策。
评价信息：商品的累计评价数量、好评率、中评率、差评率以及部分评价内容，帮助用户了解其他消费者对商品的真实反馈。
物流信息：如商品的发货地、默认物流方式及预计运费等，为用户提供物流成本与时效的预估。
店铺信息：所属店铺名称、店铺等级、店铺信誉等，展示商品所属商家的相关信息，增加用户对商品来源的信任度。

（二）数据输入

使用淘宝商品详情 API 接口时，最关键的输入参数就是商品 ID。商品 ID 是淘宝平台为每一个商品赋予的唯一标识，类似于商品的 “身份证号码”。在淘宝的商品链接中，通常可以找到该商品的 ID。

（三）数据输出

接口返回的数据格式一般为 JSON，这种格式简洁且易于在各种编程语言和应用程序中解析与处理。返回的数据结构大致如下：

{
    "product_id": "654321",
    "product_name": "某品牌智能手表",
    "brand": "品牌名称",
    "model": "具体型号",
    "colors": ["黑色", "白色", "蓝色"],
    "sizes": ["42mm", "46mm"],
    "price": {
        "current_price": 1999.00,
        "original_price": 2499.00,
        "promotion_price": 1799.00,
        "promotion_rules": "满1000减200，叠加店铺优惠券"
    },
    "images": [
        "https://image1.jpg",
        "https://image2.jpg",
        "https://image3.jpg"
    ],
    "description": "这款智能手表具备心率监测、睡眠监测、运动记录等功能，采用高品质材料制作...",
    "reviews": {
        "total_count": 500,
        "positive_rate": 0.92,
        "neutral_rate": 0.05,
        "negative_rate": 0.03,
        "sample_reviews": [
            {
                "user": "用户1",
                "content": "手表很好用，功能齐全，续航也不错",
                "rating": 5
            },
            {
                "user": "用户2",
                "content": "表带质量一般，其他还好",
                "rating": 4
            }
        ]
    },
    "logistics": {
        "shipping_place": "广东深圳",
        "default_logistics": "顺丰快递",
        "estimated_freight": 15.00
    },
    "store": {
        "store_name": "某品牌官方旗舰店",
        "store_level": "5钻",
        "store_credit": "99%"
    }
}

开发者可根据业务需求，从返回的 JSON 数据中提取所需字段，进行进一步的数据处理与展示。

三、Python 请求示例

import requests
import hashlib
import time
import json
# 封装好的第三方数据商平台接口，复制链接获取测试。 
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.item.get",
    "timestamp": timestamp,
    "format": "json",
    "v": "2.0",
    "fields": "num_iid,title,price,desc,image,shop_name",
    "num_iid": product_id
}
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
# 发送请求
response = requests.get(url, params = params)
# 解析响应数据
if response.status_code == 200:
    data = json.loads(response.text)
    if "item" in data:
        item = data["item"]
        print("商品名称：", item["title"])
        print("商品价格：", item["price"])
        print("商品描述：", item["desc"])
        print("店铺名称：", item["shop_name"])
    else:
        print("未获取到商品信息，错误信息：", data["error_response"]["msg"])
else:
    print("请求失败，状态码：", response.status_code)

上述代码通过 Python 的requests库向淘宝商品详情 API 接口发送 GET 请求。在请求前，先按照淘宝接口的签名规则生成签名，确保请求的合法性与安全性。若请求成功，接口返回数据后，通过json.loads()方法将响应内容解析为 Python 字典格式，然后提取并打印商品的名称、价格、描述及店铺名称等关键信息。若请求失败，代码会输出错误状态码或接口返回的错误信息，方便开发者定位与解决问题。通过这个示例，开发者可以快速掌握使用 Python 调用淘宝商品详情 API 接口的基本方法，并在此基础上根据自身业务需求进行拓展与优化。