电商自动化实战：淘宝/天猫item_get商品详情API全量采集教程（Python源码）

在电商精细化运营场景中，商品数据采集是选品分析、竞品监控、无货源铺货、市场调研的核心基础工作。传统人工复制商品标题、价格、SKU规格、图文素材、店铺信息的方式，不仅耗时费力，且无法实现批量、定时、自动化处理，严重限制运营效率。

针对该场景，OpenClaw 推出标准化 taobao.item_get 商品详情API，支持通过商品ID一键抓取淘宝、天猫全维度公开商品数据。接口数据结构规范、适配稳定，可完美替代原生爬虫，规避IP封禁、风控拦截等问题。

一、接口整体概述

1.1 接口基础介绍

接口名称：taobao.item_get 获取淘宝/天猫商品详情数据

核心能力：通过传入商品唯一ID，单次请求返回商品基础信息、价格体系、促销数据、SKU规格、图文素材、销售数据、店铺资质等全套结构化数据。

1.2 适用业务场景

智能选品分析：批量采集类目商品销量、定价、卖点信息，筛选高潜力爆款货源；
竞品动态监控：定时抓取同行商品价格、规格、上下架变动，快速调整运营策略；
无货源批量铺货：一键采集商品图文、属性参数、SKU规格，快速生成标准化铺货数据包；
行业数据分析：统计类目定价区间、库存分布、销量数据，支撑市场调研与运营决策；
自研系统对接：为电商ERP、进销存系统、采集工具、AI自动化框架提供稳定数据源。

1.3 特殊类目说明

受平台权限限制，药品、五金工具、天猫国际、百亿补贴等特殊类目，会存在少量字段缺失的情况，属于平台正常限制，非接口异常。

二、接口参数详细解析

2.1 基础请求信息

请求方式：GET 接口请求地址：https://api-gw.onebound.cn/taobao/item_get

2.2 公共参数

参数名	类型	是否必填	参数说明
key	String	是	接口调用授权凭证
secret	String	是	接口安全校验密钥
cache	String	否	缓存开关，默认yes，提升批量访问速度
result_type	String	否	返回格式，jsonu适配中文无乱码
lang	String	否	返回语言，默认cn简体中文

2.3 核心业务请求参数

参数名	是否必填	参数说明
num_iid	是	淘宝/天猫商品唯一ID
is_promotion	否	是否获取促销价，1开启、0关闭

2.4 标准请求URL示例

复制代码

https://api-gw.onebound.cn/taobao/item_get/?key=<你的apiKey>&secret=<你的apiSecret>&num_iid=652874751412&is_promotion=1

2.5 核心返回字段释义

接口所有商品数据统一封装在 item 对象内，核心可商用字段分类如下：

基础信息字段

num_iid（商品ID）、title（商品标题）、detail_url（商品链接）、location（发货地）、tmall（是否天猫店铺）

价格体系字段

price（在售售价）、orginal_price（商品原价）、promotion_price（活动促销价）

销量库存字段

sales（累计销量）、num（模糊库存）、min_num（最小起购量）

素材资源字段

pic_url（主图）、item_imgs（轮播图集）、prop_imgs（规格图）、video（商品视频）

规格属性字段

props（商品参数属性）、props_name（销售属性名称）、skus（全量SKU规格、价格、库存）

店铺信息字段

nick（掌柜昵称）、shop_id（店铺ID）、seller_info（店铺完整资料）

三、完整可运行 Python 源码

以下代码经过标准化封装，集成接口请求、异常捕获、数据格式化解析、结构化输出功能，无需二次修改逻辑，替换密钥和商品ID即可直接运行。

复制代码

# -*- coding: utf-8 -*-
"""
淘宝/天猫商品详情API采集工具
接口：taobao.item_get
功能：一键采集商品价格、SKU、图片、属性、销量、店铺全量数据
适用：选品分析、竞品监控、批量铺货、系统对接
运行环境：Python3.7+
"""
import requests

# ====================== 自定义配置区域 ======================
API_KEY = "你的调用key"
API_SECRET = "你的调用secret"
GOODS_ID = "652874751412"  # 目标商品ID
IS_PROMOTION = 1  # 1=开启获取促销价 0=关闭
# ===========================================================

BASE_API_URL = "https://api-gw.onebound.cn/taobao/item_get"

def get_taobao_item_detail(num_iid, is_promotion=1):
    """
    调用接口获取商品完整详情数据
    :param num_iid: 商品唯一ID
    :param is_promotion: 是否拉取促销价格
    :return: 原始JSON数据
    """
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "num_iid": num_iid,
        "is_promotion": is_promotion,
        "result_type": "jsonu",
        "cache": "yes"
    }
    try:
        response = requests.get(BASE_API_URL, params=params, timeout=15)
        return response.json()
    except Exception as e:
        print(f"接口请求异常：{str(e)}")
        return None

def parse_goods_data(data):
    """格式化解析并输出商品核心结构化数据"""
    if not data:
        print("未获取到有效数据")
        return

    if data.get("error_code") != "0000":
        print(f"接口调用失败：{data.get('reason', '未知错误')}")
        return

    item_data = data.get("item", {})
    print("=" * 70)
    print("【商品基础信息】")
    print(f"商品ID：{item_data.get('num_iid')}")
    print(f"商品标题：{item_data.get('title')}")
    print(f"商品链接：{item_data.get('detail_url')}")
    print(f"发货地：{item_data.get('location', '暂无')}")
    print(f"是否天猫店铺：{item_data.get('tmall')}")

    print("\n【价格信息】")
    print(f"在售售价：{item_data.get('price')} 元")
    print(f"商品原价：{item_data.get('orginal_price')} 元")
    print(f"促销价格：{item_data.get('promotion_price', '暂无促销')} 元")

    print("\n【销量库存信息】")
    print(f"商品库存：{item_data.get('num', '暂无统计')}")
    print(f"累计销量：{item_data.get('sales', '暂无统计')}")
    print(f"最小起购量：{item_data.get('min_num', 0)}")

    print("\n【店铺信息】")
    print(f"掌柜昵称：{item_data.get('nick', '暂无')}")
    print(f"店铺ID：{item_data.get('shop_id', '暂无')}")

    # 解析轮播图片
    img_list = item_data.get("item_imgs", [])
    if img_list:
        print(f"\n【商品轮播图集】共{len(img_list)}张")
        for index, img in enumerate(img_list, 1):
            print(f"{index}. {img.get('url')}")

    # 解析SKU规格数据
    sku_data = item_data.get("skus", {}).get("sku", [])
    if sku_data:
        print(f"\n【商品SKU规格列表】共{len(sku_data)}个规格")
        for sku in sku_data:
            print(f"规格名称：{sku.get('properties_name')}")
            print(f"规格售价：{sku.get('price')} 元 | 剩余库存：{sku.get('quantity')}")
            print("-" * 40)
    print("=" * 70)

if __name__ == "__main__":
    print("===== 淘宝商品全量数据采集工具 =====")
    result = get_taobao_item_detail(GOODS_ID, IS_PROMOTION)
    parse_goods_data(result)

四、部署使用步骤

1、安装依赖库，首次运行仅需执行一次：

复制代码

pip install requests

2、在配置区替换为个人 $API_KEY、API_SECRET$ 调用凭证；

3、修改 GOODS_ID 为目标采集商品ID，按需开关促销价采集；

4、直接运行脚本，自动格式化输出商品全套核心数据。

五、商用落地应用场景

5.1 竞品价格动态监控

搭配定时任务循环调用接口，实时监控同行商品调价、促销活动、规格变更、上下架动态，帮助运营快速调整定价与活动策略。

5.2 无货源批量铺货

一键批量抓取商品标题、主图、详情图、属性参数、SKU规格，自动整理标准化铺货素材，大幅降低人工上新成本，提升铺货效率。

5.3 类目市场选品分析

批量采集同类目商品数据，统计主流定价区间、热销规格、爆款卖点，系统化分析市场趋势，精准筛选高潜力货源。

5.4 私有商品库搭建

对接数据库持久化存储商品数据，自动收录类目货源，搭建专属私有商品资源库，支撑长期选品与供货复盘。

5.5 多规格精细化管理

统一采集全量SKU的价格、库存、规格名称，实现多规格商品数据统一管理，适配精细化运营与库存把控。

六、官方错误码对照表

错误码	状态说明	是否扣费
0000	调用成功，数据正常返回	是
2000	无对应商品查询结果	是
4003	请求参数格式错误	否
4005	接口授权失败	否
4008	接口并发调用超限	否
4013	当日调用次数已用尽	否
4016	账户余额不足	否

七、接口核心使用优势

数据维度完整：单次请求集齐商品基础、价格、销量、素材、SKU、店铺全套数据，无需多次调用；
接入门槛极低：标准GET请求，兼容Python、PHP、Java等多语言，新手可快速上手；
高效稳定：支持缓存机制，响应速度快，适配批量、高频采集场景；
规避风控：官方合规接口，持续适配平台更新，杜绝爬虫IP封禁、账号风控问题；
拓展性极强：可对接定时任务、数据库、AI框架、可视化系统，快速搭建自动化运营体系。

八、总结

taobao.item_get商品详情API是淘宝、天猫电商自动化运营的基础核心工具，覆盖选品、监控、铺货、数据分析、系统对接全场景。相较于传统手动采集和原生爬虫，该接口具备更高的稳定性、合规性与效率。

本文提供的源码开箱即用、注释完善、适配生产环境，开发者可直接部署使用，将重复性的数据采集、整理工作自动化，大幅降低人工运营成本，聚焦选品优化、策略调整、店铺转化等核心业务，实现精细化、智能化电商运营。