淘宝全量商品详情 API 接口使用文档

淘宝商品详情 API 的抓取范围，核心取决于接口类型（开放平台 / 淘宝客）、账号权限（个人 / 企业）、字段指定（fields 参数） ，以下按 “可抓取范围 + 权限差异 + 不可抓取内容 + 实战要点” 四部分，给出清晰、可复用的总结。

淘宝开放平台的item_get接口是获取商品详情的核心工具，广泛应用于电商分析、比价系统、商品监控等场景。本文将从接口基础、对接流程、高级技巧到最佳实践，全面讲解如何高效对接该接口。

一、接口基础认知

1. 接口功能：item_get用于获取淘宝商品的详细信息，包括标题、价格、库存、规格、图片、销量、卖家信息等。
2. 接口地址：正式环境：https://eco.taobao.com/router/rest
3. 沙箱环境：https://gw-api.tbsandbox.com/router/rest（测试用）
4. 请求方式：HTTP POST/GET
5. 核心参数：

• app_key：应用唯一标识
• method：接口名称，固定为taobao.item.get
• format：返回格式，支持json或xml
• v：API 版本，当前为2.0
• sign：签名
• num_iid：商品 ID（必填）
• fields：需要返回的字段列表，如title,price,pics

二、对接前置准备

1. 注册开发者账号：访问淘宝开放平台注册账号，完成实名认证。
2. 创建应用：在开放平台控制台创建应用，获取app_key和app_secret（注意保密）。
3. 权限申请：申请item_get接口的调用权限，个人开发者和企业开发者权限有所不同。
4. 环境准备：

• 开发语言：支持任何可发起 HTTP 请求的语言（Python/Java/PHP 等）
• 工具：Postman（测试）、IDE（开发）

三、接口调用流程

1. 参数组装：按接口要求组装参数，特别注意fields参数可指定返回字段，减少数据传输量。
2. 签名生成：签名是接口安全的核心，生成规则：

• 将所有参数（除 sign 外）按参数名 ASCII 排序

• 拼接为key=value&key=value格式

• 拼接app_secret后进行 MD5 加密

• 加密结果转为大写即为sign

• 发送请求：将参数通过 GET 或 POST 方式发送到接口地址。

• 处理响应：解析返回的 JSON/XML 数据，处理可能的错误码。

四、代码实现示例（Python）

以下是使用 Python 调用item_get接口的示例代码：

# coding:utf-8

""" Compatible for python2.x and python3.x requirement: pip install requests """

from __future__ import print_function

import requests

# 封装好API供应商demo url=o0b.cn/ibrad， wechat id:  TaoxiJd-api 复制链接获取测试

# 请求示例 url 默认请求参数已经做URL编码 url = "tb/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=12345" headers = { "Accept-Encoding": "gzip",
 "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)