淘宝 / 天猫商品详情 API 接口调用指南

摘要

本指南针对淘宝开放平台官方 API与非官方爬虫方案两种获取淘宝 / 天猫商品详情的方式进行结构化说明。官方 API（taobao.item.get/tmall.item.get）具备合规性、稳定性和高可靠性，是代购系统、电商数据平台的首选方案；非官方爬虫方案适用于个人测试场景，但存在反爬封禁、数据不稳定及合规风险。本文将重点提供官方 API 的调用流程、参数说明及 Python 实战示例，并补充非官方方案的应急实现思路。

接口概述

一、 官方 API（推荐商用）

1. 接口来源：淘宝开放平台
2. 核心接口

   平台	接口名称	接口功能	权限要求
   淘宝	taobao.item.get	获取淘宝商品基础详情	个人 / 企业开发者
   天猫	tmall.item.get	获取天猫商品基础详情	个人 / 企业开发者
   通用	taobao.item.info.get	获取商品扩展信息（库存、销量）	企业开发者

3. 前置条件
   • 注册淘宝开放平台账号，创建应用，获取AppKey和AppSecret。
   • 接口调用需要签名验证，推荐使用官方 SDK 自动处理签名。
   • 部分高级接口（如库存、销量）需要企业资质认证，个人开发者权限有限。
4. 核心参数

   参数名	必选	说明	示例值
   num_iid	是	商品 ID（淘宝 / 天猫通用）	123456
   fields	是	需要返回的字段，多个用逗号分隔	title,price,pic_url,stock,detail_url
   format	否	返回格式，支持json/xml	json

5. 返回字段：标题、价格、主图 URL、商品详情页 URL、库存数量、销量、规格参数、店铺信息等。
6. 调用限制：免费版接口有QPS 限制（每秒 1-5 次）和日调用量限制，商用需升级为付费套餐。

二、 非官方方案（应急测试）

1. 核心思路：抓取淘宝 / 天猫商品详情页的隐藏 API（如https://h5api.m.taobao.com/h5/mtop.taobao.detail.getdetail/6.0/）或解析 HTML 页面。
2. 风险提示
   • 淘宝有严格的反爬机制（验证码、IP 封禁、Cookie 过期）。
   • 非官方接口无稳定性保障，随时可能失效。
   • 商用场景下，该方案违反淘宝平台协议，存在法律风险。
   • 核心请求 URL：c0b.cc/R4rbK2 (前往体验接口测试，Taobaoapi2014添加V获取）。

Python 请求示例

示例 1： 官方 API 调用（推荐）

1. 环境准备

安装淘宝开放平台 Python SDK：

bash

pip install taobao-top-api

2. 代码实现

python

from top.api import TaobaoItemGetRequest, TmallItemGetRequest from top.api.rest import TopClient # 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 " # 配置你的应用信息 APP_KEY = "你的AppKey" APP_SECRET = "你的AppSecret" CLIENT = TopClient(appkey=APP_KEY, secret=APP_SECRET, format="json") def get_taobao_item_detail(num_iid: str) -> dict: """ 获取淘宝商品详情 :param num_iid: 商品ID :return: 商品详情字典 """ try: request = TaobaoItemGetRequest() # 设置需要返回的字段，按需扩展 request.fields = "num_iid,title,price,pic_url,detail_url,stock, sales, nick, seller_id" request.num_iid = num_iid # 调用接口 response = CLIENT.execute(request) return response except Exception as e: print(f"淘宝商品详情获取失败：{e}") return {} def get_tmall_item_detail(num_iid: str) -> dict: """ 获取天猫商品详情 :param num_iid: 商品ID :return: 商品详情字典 """ try: request = TmallItemGetRequest() request.fields = "num_iid,title,price,pic_url,detail_url,stock, sales, brand, seller_id" request.num_iid = num_iid response = CLIENT.execute(request) return response except Exception as e: print(f"天猫商品详情获取失败：{e}") return {} # 测试调用 if __name__ == "__main__": taobao_item_id = "652874751412" # 淘宝商品ID tmall_item_id = "598765432109" # 天猫商品ID print("淘宝商品详情：", get_taobao_item_detail(taobao_item_id)) print("天猫商品详情：", get_tmall_item_detail(tmall_item_id))

3. 注意事项

• 替换APP_KEY和APP_SECRET为你自己的应用信息。
• fields参数可根据业务需求扩展，具体支持的字段参考淘宝开放平台接口文档。
• 接口调用失败时，需检查权限、商品 ID 是否有效、调用频率是否超限。

示例 2： 非官方爬虫方案（应急测试）

python

import requests import json def get_item_detail_unofficial(num_iid: str) -> dict: """ # 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 " 非官方方式获取淘宝/天猫商品详情（仅测试用） :param num_iid: 商品ID :return: 商品详情字典 """ url = f"https://h5api.m.taobao.com/h5/mtop.taobao.detail.getdetail/6.0/" headers = { "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36", "Referer": f"https://item.taobao.com/item.htm?id={num_iid}", "Cookie": "你的淘宝Cookie" # 需手动登录淘宝获取Cookie } params = { "jsv": "2.5.1", "appKey": "12574478", "t": str(int(time.time() * 1000)), "sign": "自动生成的签名（可通过浏览器抓包获取）", "api": "mtop.taobao.detail.getdetail", "v": "6.0", "dataType": "json", "data": json.dumps({"itemNumId": num_iid}) } try: response = requests.get(url, headers=headers, params=params, timeout=10) data = response.json() return data except Exception as e: print(f"非官方方式获取商品详情失败：{e}") return {} # 测试调用 if __name__ == "__main__": item_id = "652874751412" print("非官方商品详情：", get_item_detail_unofficial(item_id))

注意事项

• 该方案需要手动获取淘宝 Cookie 和签名，维护成本高。
• 建议添加 IP 代理池和请求延迟，避免被封禁。
• 仅适用于个人测试，商用场景请使用官方 API。

结语

1. 合规性优先：对于代购系统、电商数据平台等商用场景，强烈推荐使用淘宝开放平台官方 API，避免法律风险和数据不稳定问题。
2. 权限与配额：个人开发者可先通过官方 API 进行功能验证，企业开发者可根据业务需求申请高级接口和更高的调用配额。
3. 反爬应对：非官方爬虫方案仅适用于应急测试，如需长期使用，需投入大量精力处理反爬机制，且无法保证稳定性。
4. 扩展功能：基于商品详情 API，你可以进一步实现价格监控、库存预警、商品信息批量导入等功能，为代购系统提供核心数据支持。