万邦api博客

基于 Python 实现淘宝京东商品数据 API 批量获取

Thu, 09 Apr 2026 17:10:59 +0800

在电商数据分析、竞品监控、选品优化、ERP系统对接等场景中，批量获取淘宝、京东平台的商品数据是高频需求。本文将从零开始，手把手教你用 Python 实现两大平台商品数据 API 的批量调用，涵盖前置准备、签名生成、代码封装、批量请求优化、数据解析全流程，提供可直接复制运行的代码，新手也能快速上手，避开平台调用坑点。

核心目标：通过 Python 封装淘宝、京东开放平台 API，实现多商品 ID 的批量数据抓取（支持商品标题、价格、库存、销量、图片等核心字段），解决批量调用中的限流、签名错误、数据解析混乱等常见问题，兼顾实用性和可扩展性。

一、前置准备（必做步骤）

批量调用淘宝、京东 API 的前提是完成开放平台的账号认证、应用创建和权限申请，这一步是基础，缺一不可，避免后续出现权限不足、签名失败等问题。

1.1 淘宝开放平台准备

注册并认证：访问淘宝开放平台，注册开发者账号，完成个人/企业实名认证（企业认证可解锁更多接口权限，个人认证足够满足基础批量获取需求）。
创建应用：登录后进入「控制台」→「应用管理」→「新建应用」，填写应用名称、应用场景（如“电商数据采集”），提交审核（审核速度较快，一般1-2个工作日）。
获取核心参数：应用审核通过后，在应用详情页获取 AppKey 和 AppSecret（接口调用的核心凭证，请勿泄露）。
申请接口权限：在应用详情页→「接口管理」，搜索并申请以下两个核心接口（批量获取必备）：

taobao.item.get（单商品详情查询，基础接口，用于单个商品数据验证）
taobao.item_get_batch（批量商品详情查询，核心接口，单次最多支持50个商品ID批量查询）

沙箱测试（可选）：若担心正式环境调用出错，可开通沙箱环境，用沙箱账号、沙箱 AppKey 进行测试，避免触发正式环境限流。

1.2 京东开放平台准备

注册并认证：访问京东开放平台（京东云·开放平台），注册开发者账号，完成实名认证。
创建应用：进入「开发者控制台」→「应用管理」→「创建应用」，选择应用类型（个人开发者选“第三方应用”），填写相关信息并提交审核。
获取核心参数：应用审核通过后，获取 AppKey、AppSecret 和 AccessToken（京东 API 调用需额外获取 AccessToken，可通过平台提供的接口获取，有有效期，需定期刷新）。
申请接口权限：在应用详情页→「接口权限」，搜索并申请以下核心接口：

jingdong.item.read.get（单商品详情查询，用于验证）
jingdong.item.list.get（批量商品详情查询，核心接口，单次最多支持20个商品ID批量查询）

1.3 Python 环境准备

安装所需依赖库，直接执行以下命令（均为Python基础库，无需额外配置）：

pip install requests # 发送HTTP请求，核心库 pip install jsonpath # 解析JSON数据（处理嵌套字段更便捷，可选） pip install tenacity # 实现重试机制，解决网络抖动、限流等问题

二、核心原理说明

淘宝、京东 API 调用的核心逻辑一致：构建请求参数 → 生成安全签名（防止请求被篡改） → 发送HTTP请求 → 解析返回的JSON数据 → 提取目标字段。

关键注意点：

签名机制：两大平台均要求对请求参数进行签名，签名规则略有差异，但核心都是“参数排序+密钥拼接+加密”，下文代码已封装好签名逻辑，直接替换自己的参数即可。
限流控制：淘宝、京东 API 均有调用频次限制（如淘宝基础接口每分钟最多100次，京东单次批量查询不超过20个ID），批量调用时需控制并发和请求间隔，避免触发限流（429错误）。
数据格式：返回数据均为JSON格式，部分字段嵌套较深，需用JSONPath或原生索引提取，下文会提供两种解析方式。

三、完整代码实现（可直接复制运行）

本文采用“类封装”方式，将淘宝、京东 API 的调用逻辑分别封装为独立类，便于后续扩展和维护，支持批量传入商品ID、自动处理签名、异常捕获和重试，最终输出结构化商品数据（可直接保存为CSV/Excel）。

3.1 通用工具类（签名、重试、异常处理）

import requests import hashlib import time from tenacity import retry, stop_after_attempt, wait_exponential, retry_if_exception_type from requests.exceptions import RequestException import jsonpath class ApiUtils: """通用API工具类：封装签名生成、重试机制、异常处理""" @staticmethod def generate_sign(params, app_secret, platform="taobao"): """ 生成淘宝/京东API签名（核心方法） :param params: 请求参数（字典） :param app_secret: 应用密钥（AppSecret） :param platform: 平台（taobao/jd） :return: 签名字符串 """ # 按参数名ASCII码升序排列（两大平台均要求） sorted_params = sorted(params.items(), key=lambda x: x[0]) # 拼接参数字符串 sign_str = app_secret + "".join([f"{k}{v}" for k, v in sorted_params]) + app_secret # MD5加密，转大写（两大平台签名加密方式一致） sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper() return sign @staticmethod @retry( stop=stop_after_attempt(3), # 最多重试3次 wait=wait_exponential(multiplier=1, min=1, max=5), # 指数退避：1s、2s、4s retry=retry_if_exception_type((RequestException, ConnectionError, TimeoutError)) ) def send_request(url, params=None, method="GET"): """ 发送HTTP请求，带重试机制 :param url: 请求地址 :param params: 请求参数 :param method: 请求方式（GET/POST） :return: 响应JSON数据 """ try: if method == "GET": response = requests.get(url, params=params, timeout=10) else: response = requests.post(url, data=params, timeout=10) response.raise_for_status() # 触发HTTP错误（如404、500） return response.json() except Exception as e: print(f"请求失败，原因：{str(e)}，将进行重试") raise # 抛出异常，触发重试机制

3.2 淘宝API批量调用类

class TaobaoApiClient: def __init__(self, app_key, app_secret): """ 初始化淘宝API客户端 :param app_key: 淘宝AppKey :param app_secret: 淘宝AppSecret """ self.app_key = app_key self.app_secret = app_secret self.gateway = "https://eco.taobao.com/router/rest" # 淘宝API网关 self.common_params = { "app_key": self.app_key, "format": "json", "v": "2.0", "sign_method": "md5", "timestamp": time.strftime("%Y-%m-%d %H:%M:%S") # 实时时间戳 } def get_single_item(self, num_iid): """ 单个商品详情查询（用于验证） :param num_iid: 淘宝商品ID（从商品详情页URL提取） :return: 单个商品结构化数据 """ # 构建请求参数（公共参数+业务参数） params = { **self.common_params, "method": "taobao.item.get", "num_iid": num_iid, "fields": "num_iid,title,price,stock,volume,pic_url,brand,category" # 需返回的字段 } # 生成签名 params["sign"] = ApiUtils.generate_sign(params, self.app_secret, platform="taobao") # 发送请求 response = ApiUtils.send_request(self.gateway, params=params, method="GET") # 解析数据（处理异常场景） if "error_response" in response: raise Exception(f"淘宝API调用失败：{response['error_response']['msg']}") return self._parse_item_data(response["item"]) def batch_get_items(self, num_iids): """ 批量获取商品详情（核心方法） :param num_iids: 商品ID列表（最多50个） :return: 批量商品结构化数据列表 """ if len(num_iids) > 50: raise ValueError("淘宝批量查询单次最多支持50个商品ID") # 构建请求参数 params = { **self.common_params, "method": "taobao.item_get_batch", "item_ids": ",".join(num_iids), # 商品ID用逗号分隔 "fields": "num_iid,title,price,stock,volume,pic_url,brand,category" } # 生成签名 params["sign"] = ApiUtils.generate_sign(params, self.app_secret, platform="taobao") # 发送请求 response = ApiUtils.send_request(self.gateway, params=params, method="GET") # 解析数据 if "error_response" in response: raise Exception(f"淘宝批量API调用失败：{response['error_response']['msg']}") items = response.get("item_get_batch_response", {}).get("items", {}).get("item", []) return [self._parse_item_data(item) for item in items] @staticmethod def _parse_item_data(item): """解析商品数据，提取核心字段，返回结构化字典""" return { "platform": "taobao", "item_id": item.get("num_iid", ""), "title": item.get("title", ""), "price": float(item.get("price", 0.0)), # 价格转浮点数 "stock": int(item.get("stock", 0)), # 库存转整数 "sales": int(item.get("volume", 0)), # 销量转整数 "image_url": item.get("pic_url", ""), "brand": item.get("brand", ""), "category": item.get("category", "") }

3.3 京东API批量调用类

class JdApiClient: def __init__(self, app_key, app_secret, access_token): """ 初始化京东API客户端 :param app_key: 京东AppKey :param app_secret: 京东AppSecret :param access_token: 京东AccessToken（需定期刷新） """ self.app_key = app_key self.app_secret = app_secret self.access_token = access_token self.gateway = "https://api.jd.com/routerjson" # 京东API网关 self.common_params = { "app_key": self.app_key, "format": "json", "v": "2.0", "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"), "access_token": self.access_token } def get_single_item(self, sku_id): """ 单个商品详情查询（用于验证） :param sku_id: 京东商品ID（从商品详情页URL提取） :return: 单个商品结构化数据 """ params = { **self.common_params, "method": "jingdong.item.read.get", "sku_id": sku_id, "fields": "sku_id,title,price,image_url,brand_info,category_info,sku_stock" } # 生成签名 params["sign"] = ApiUtils.generate_sign(params, self.app_secret, platform="jd") # 发送请求（京东API推荐用POST方式） response = ApiUtils.send_request(self.gateway, params=params, method="POST") # 解析数据 if "error_response" in response: raise Exception(f"京东API调用失败：{response['error_response']['msg']}") item = response.get("jingdong_item_read_get_response", {}).get("result", {}).get("item", {}) return self._parse_item_data(item) def batch_get_items(self, sku_ids): """ 批量获取商品详情（核心方法） :param sku_ids: 商品ID列表（最多20个） :return: 批量商品结构化数据列表 """ if len(sku_ids) > 20: raise ValueError("京东批量查询单次最多支持20个商品ID") params = { **self.common_params, "method": "jingdong.item.list.get", "sku_ids": ",".join(sku_ids), "fields": "sku_id,title,price,image_url,sku_stock" } # 生成签名 params["sign"] = ApiUtils.generate_sign(params, self.app_secret, platform="jd") # 发送请求 response = ApiUtils.send_request(self.gateway, params=params, method="POST") # 解析数据 if "error_response" in response: raise Exception(f"京东批量API调用失败：{response['error_response']['msg']}") items = response.get("jingdong_item_list_get_response", {}).get("result", {}).get("items", {}).get("item", []) return [self._parse_item_data(item) for item in items] @staticmethod def _parse_item_data(item): """解析京东商品数据，统一字段格式（与淘宝保持一致）""" return { "platform": "jd", "item_id": item.get("sku_id", ""), "title": item.get("title", ""), "price": float(item.get("price", 0.0)), "stock": int(item.get("sku_stock", 0)), "sales": 0, # 京东API需单独调用销量接口，此处暂设为0，可自行扩展 "image_url": item.get("image_url", ""), "brand": item.get("brand_info", {}).get("brand_name", ""), "category": item.get("category_info", {}).get("cid1_name", "") }

3.4 主程序（批量调用示例）

if __name__ == "__main__": # -------------------------- 配置参数（替换为自己的）-------------------------- # 淘宝配置 TAOBAO_APP_KEY = "你的淘宝AppKey" TAOBAO_APP_SECRET = "你的淘宝AppSecret" # 京东配置 JD_APP_KEY = "你的京东AppKey" JD_APP_SECRET = "你的京东AppSecret" JD_ACCESS_TOKEN = "你的京东AccessToken" # 批量商品ID（替换为自己需要查询的商品ID） TAOBAO_ITEM_IDS = ["520813250866", "123456789012", "987654321098"] # 最多50个 JD_ITEM_IDS = ["100012345678", "100087654321", "100098765432"] # 最多20个 try: # 1. 初始化客户端 taobao_client = TaobaoApiClient(TAOBAO_APP_KEY, TAOBAO_APP_SECRET) jd_client = JdApiClient(JD_APP_KEY, JD_APP_SECRET, JD_ACCESS_TOKEN) # 2. 批量获取淘宝商品数据 print("开始批量获取淘宝商品数据...") taobao_items = taobao_client.batch_get_items(TAOBAO_ITEM_IDS) print(f"淘宝商品数据获取完成，共{len(taobao_items)}个商品") # 3. 批量获取京东商品数据 print("\n开始批量获取京东商品数据...") jd_items = jd_client.batch_get_items(JD_ITEM_IDS) print(f"京东商品数据获取完成，共{len(jd_items)}个商品") # 4. 合并数据（可选），输出结构化结果 all_items = taobao_items + jd_items print("\n批量获取的所有商品数据：") for item in all_items: print(f"{item['platform']} | 商品ID：{item['item_id']} | 标题：{item['title']} | 价格：{item['price']}元 | 库存：{item['stock']}件") # 5. 保存数据到CSV（可选，便于后续分析） import csv with open("电商商品批量数据.csv", "w", encoding="utf-8-sig", newline="") as f: fieldnames = ["platform", "item_id", "title", "price", "stock", "sales", "image_url", "brand", "category"] writer = csv.DictWriter(f, fieldnames=fieldnames) writer.writeheader() writer.writerows(all_items) print("\n数据已保存到：电商商品批量数据.csv") except Exception as e: print(f"程序执行失败：{str(e)}")

四、实战优化与避坑指南（重点）

很多开发者在批量调用 API 时，会遇到限流、签名错误、数据缺失等问题，以下优化方案和避坑点，能大幅提升程序稳定性和效率。

4.1 限流控制优化

分批次调用：淘宝单次最多50个ID，京东单次最多20个ID，当需要查询的商品ID超过限制时，分批次调用，每批次之间添加间隔（如1-2秒），避免触发限流。 # 分批次处理京东商品ID（示例） jd_all_ids = ["100012345678", "100087654321", ...] # 假设100个ID batch_size = 20 # 京东单次最大批量数 for i in range(0, len(jd_all_ids), batch_size): batch_ids = jd_all_ids[i:i+batch_size] jd_items = jd_client.batch_get_items(batch_ids) time.sleep(1) # 每批次间隔1秒
动态调整并发：若批量数据量极大（如1000个ID），可使用协程（aiohttp）实现并发调用，控制最大并发数（如30），提升效率的同时避免限流，具体代码可参考协程优化方案。
限流后处理：若触发429限流错误，可通过响应头的X-RateLimit-Remaining字段，动态调整请求间隔和并发数，或添加更长时间的等待后重试。

4.2 常见坑点及解决方案

坑点	解决方案
签名错误（最常见）	1. 检查AppSecret大小写是否与平台一致；2. 确保参数字段按ASCII码升序排序；3. 时间戳与服务器时间差不超过5分钟；4. 避免参数值包含特殊字符（需URL编码）。
权限不足	1. 确认已申请对应接口权限；2. 个人认证接口权限有限，可升级为企业认证；3. 检查应用审核状态（需审核通过才能调用接口）。
数据解析失败（字段缺失）	1. 检查接口请求的fields参数，确保包含需要的字段；2. 部分商品可能缺失品牌、销量等字段，添加默认值（如0、空字符串）；3. 复杂嵌套字段用JSONPath解析，避免索引报错。
AccessToken过期（京东专属）	1. 定期调用京东开放平台的token刷新接口，更新AccessToken；2. 在代码中添加token过期异常捕获，自动刷新并重新调用接口。
网络抖动导致请求失败	使用tenacity库实现重试机制，设置3-5次重试，指数退避等待，避免因临时网络问题导致程序中断。

4.3 功能扩展建议

销量数据补充：京东API的基础批量接口不返回销量，可单独调用jingdong.sku.sales.get接口获取，整合到商品数据中。
数据持久化：除了保存为CSV，可将数据存入MySQL、Redis等数据库，便于后续数据分析和查询。
日志记录：添加日志模块（logging），记录每次API调用的状态、错误信息，便于问题排查。
多平台适配：可扩展拼多多、亚马逊等其他电商平台的API调用，封装统一接口，实现多平台商品数据批量获取。

五、总结

本文完整实现了基于Python的淘宝、京东商品数据API批量获取，核心亮点的是：类封装设计便于扩展和维护，内置签名生成、重试机制、异常处理，解决了批量调用中的常见痛点，代码可直接复制替换参数运行，适合电商数据分析、竞品监控等多种场景。

需要注意的是，调用电商平台API时，需严格遵守平台的开发者规范，不得用于恶意爬取、违规数据采集等行为，避免应用被封禁。

如果在实际使用中遇到具体问题（如签名错误、权限申请、限流处理），可以在评论区留言，我会及时回复解答。

最后，觉得有用的话，记得点赞+收藏，关注我，后续会分享更多电商API实战、Python数据分析相关干货！

小红书笔记评论API调用获取小红书笔记评论二级评论

Tue, 31 Mar 2026 10:43:36 +0800

编辑

smallredbook.item_review 获取小红书笔记评论

公共参数点此获取测试key

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iid=670202b0000000002a032d2d&cursor=

参数说明：num_iid:笔记ID
cursor:翻页参数(第一页默认为空)

响应参数

Version: Date:

名称	类型	必须	示例值	描述
items	items[]	0		商品评论数据
num_iid	String	0	63e77ef7000000001300a9e3	商品ID
has_more	String	0	true	判断是否有下一页
cursor	String	0	640c7908000000001603586a	翻页参数
item	item[]	0
num_iid	String	0	63e77ef7000000001300a9e3	商品ID
rate_date	String	0	2023-03-11 02:57:49	评论时间
rate_content	String	0	运纽约多少钱	评论内容
like_count	String	0	12	点赞数
display_user_nick	String	0	༜༄༼钰༽༄༜	用户名
user_id	String	0	5fabfd6b0000000001001261	用户ID
add_feedback	MIX		纽约可以的	评论回复

响应示例

"items": {		"page_size": 2000,		"total_results": 2000,		"has_more": true,		"cursor": "{\"cursor\":\"69c8f6fa000000000c03336d\",\"index\":2,\"pageArea\":\"UNFOLDED\"}",		"_ddf": "bil",		"item": [
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-30 13:23:02",				"rate_content": "哇哇哇，竟然来秘鲁了[飞吻R]",				"like_count": 2,				"display_user_nick": "CHERYL潘潘",				"user_id": "a659aa4dba8c5d993b2f7be70e244",				"add_feedback": "朋友遍天下"
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-29 23:41:13",				"rate_content": "上周刚去哈哈",				"like_count": 2,				"display_user_nick": "StewieSeth",				"user_id": "aa5ff5c079477d51d6b7c66ec119d",				"add_feedback": "有没有体验 #s藤水[搜索高亮]#"
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-29 13:38:13",				"rate_content": "ip正确",				"like_count": 2,				"display_user_nick": "momo",				"user_id": "a265c40dd828dcddde581a241672e",				"add_feedback": null
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-29 01:35:40",				"rate_content": "姐 你来 #Lima[搜索高亮]#  带你吃好吃的 [暗中观察R]",				"like_count": 1,				"display_user_nick": "粥三三",				"user_id": "a4f5b1402098724ffe13df78df667",				"add_feedback": "求姐妹介绍几家好吃的餐厅[皱眉R]！我11月份又要去利马玩，这次想多吃几家。"
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-31 09:16:55",				"rate_content": "来不来这里[偷笑R]",				"like_count": 0,				"display_user_nick": "WHY",				"user_id": "ae482fc602f117183ef17148ba923",				"add_feedback": null
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-29 21:45:32",				"rate_content": "欢迎！",				"like_count": 2,				"display_user_nick": "南美追星人Gloria💙",				"user_id": "ab5732a48735405162226bd6e160c",				"add_feedback": null
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-31 08:05:04",				"rate_content": "就为了去图15这个小屋嘛[汗颜R][捂脸R] 可千万小心保护好自己呀",				"like_count": 0,				"display_user_nick": "我不在乎",				"user_id": "a0058f18fb34636f47fecf7510d14",				"add_feedback": null
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-29 08:34:52",				"rate_content": "静初，正在秘鲁看你的电影，就刷到小红书你到秘鲁了。",				"like_count": 2,				"display_user_nick": "宁静致远_",				"user_id": "adaaa5a1a663786863f6f3ec6ff6f",				"add_feedback": null
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-31 08:04:57",				"rate_content": "注意安全，玩儿的开心[飞吻R]",				"like_count": 0,				"display_user_nick": "love-Sushi",				"user_id": "a0fd93e73a532d0acc9bb0b07ea46",				"add_feedback": null
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-29 22:23:49",				"rate_content": "#Iquitos[搜索高亮]# 相对危险一些，多注意安全。其实秘鲁最吸引我的还是美食，去了三四次甚至都没上马丘比丘，就在利马安心吃[偷笑R]",				"like_count": 2,				"display_user_nick": "世界杯帽子戏法选手",				"user_id": "a0fbe5715f8a882b7ad8d9c17c5e3",				"add_feedback": "昨天刚从 #利马到巴西[搜索高亮]# ，没感觉什么好吃啊，也可能是我不太吃得惯他们的国菜[失望R]"
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-31 07:42:27",				"rate_content": "随喜圆满",				"like_count": 0,				"display_user_nick": "Joy淨英",				"user_id": "a7cc93fffefa6740a4dfa7dfa0281",				"add_feedback": null
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-30 10:15:55",				"rate_content": "前几天刚听您的岩中花述，没想到您会来南美洲旅游欸，旅途愉快顺利！",				"like_count": 0,				"display_user_nick": "Shalom",				"user_id": "ac1886200c8574202fb305ec8a127",				"add_feedback": null
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-29 11:41:10",				"rate_content": "一定好做好防蚊虫措施噢，去年我和朋友们也是勇闯亚马逊～不一样的体验",				"like_count": 2,				"display_user_nick": "是美妙_Daisy",				"user_id": "abe74c06a846126c5b94a41267577",				"add_feedback": "哈哈哈我的明年小目标"
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-30 01:02:01",				"rate_content": "亚马逊热带雨林没有手机信号",				"like_count": 0,				"display_user_nick": "陪你看世界",				"user_id": "ac5d8f6ac4fbad0d3658df6171899",				"add_feedback": null
			},
			{				"num_iid": "69c7fd2f0000000023014e6a",				"rate_date": "2026-03-29 17:56:06",				"rate_content": "才从秘鲁玩回来，利马还行，马丘很棒，库斯科很chill，亚马逊雨林探秘很值得，还有好多很棒的地区待静初姐姐探秘，静初姐姐注意安全，旅行开心[红色心形R][红色心形R][红色心形R]",				"like_count": 13,				"display_user_nick": "高氮白",				"user_id": "afb9aa8b2d4538148504d42235f7f",				"add_feedback": null
			}
		]
	},

唯品会商品列表与商品详情API接口

Mon, 30 Mar 2026 16:50:40 +0800

vip.item_search 关键字搜索商品

vip.item_get 获取指定商品详情数据

公共参数

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：q=鞋子&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=

参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:

响应参数

名称	类型	示例值	描述
item	item[]		获取商品详情
num_iid	String	1710613157-6918711233889249157	商品ID
title	String	【清凉运动】森马夏季新款复古运动风男式休闲中裤短裤男	商品标题
desc_short	String		商品简介
price	Float	35.00	价格
total_price	Float
suggestive_price	Float
orginal_price	Float	159.00	原价
nick	String		卖家昵称
num	Int	6
min_num	Int	0	最小量
detail_url	String	https://detail.vip.com/detail-1710613157-6918711233889249157.html	商品链接
pic_url	String	https://a.vpimg4.com/upload/merchandise/pdcvis/104218/2020/0814/160/7932992b-c2f6-4ed2-a97b-69824fa7ba10.jpg	商品图片
brand	String	森马	品牌名称
brandId	Int	1710613157	品牌ID
rootCatId	Int		顶级分类ID
cid	Int	390576
crumbs	Mix		导航列表
created_time	Int	1537845115000
modified_time	Int	1683886534000
delist_time	Int	2145888000000
desc	String	\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/1540464613-651972905622466560-651972905622466562-601.jpg\"\u003E\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/2056028139-651972905622466560-651972905622466562-602.jpg\"\u003E\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/2103507544-651972905622466560-651972905622466562-603.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/805209464-651972905622466560-651972905622466562-604.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/965265007-651972905622466560-651972905622466562-605.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/1456204603-651972905622466560-651972905622466562-606.jpg\"\u003E\u003Cimg src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/245784564-651972905622466560-651972905622466562-607.jpg\"\u003E\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/478942397-651972905622466560-651972905622466562-608.jpg\"\u003E\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/563202406-651972905622466560-651972905622466562-609.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/576808585-651972905622466560-651972905622466562-610.jpg\"\u003E\u003Cimg src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/492548576-651972905622466560-651972905622466562-611.jpg\"\u003E\u003Cimg src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/475079584-651972905622466560-651972905622466562-612.jpg\"\u003E\u003Cimg src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/643984351-651972905622466560-651972905622466562-613.jpg\"\u003E\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/723627373-651972905622466560-651972905622466562-614.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/353669547-651972905622466560-651972905622466562-615.jpg\"\u003E\u003Cimg src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/241322868-651972905622466560-651972905622466562-616.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/270393169-651972905622466560-651972905622466562-617.jpg\"\u003E\u003Cimg src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.6719bcf88920c&p=3702633547&k=i_key&t=1729740025\" style=\"display:none\" /\u003E	商品详情
desc_img	Mix	["https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/1540464613-651972905622466560-651972905622466562-601.jpg"]	商品描述图片
item_imgs	Mix	[{"url": "https://a.vpimg2.com/upload/merchandise/pdcvis/104218/2020/0814/160/7932992b-c2f6-4ed2-a97b-69824fa7ba10_750x750_75.jpg"}]	商品图片
item_weight	String
item_size	String
location	String		发货地
post_fee	Float		物流费用
express_fee	String		快递费用
ems_fee	String		EMS费用
shipping_to	String		发货至
has_discount	String
video	Mix		商品视频
is_virtual	String
sample_id	String		商品风格标识
is_promotion	String	false
props_name	String	XL:黑色9000;M:黑色9000;XS:黑色9000;L:黑色9000;S:黑色9000;XXL:黑色9000;XXXL:黑色9000;	商品属性名
prop_imgs	Mix	{"prop_img": []}	商品属性图片列表
property_alias	String		商品属性别名
props	Mix
total_sold	Int	0
skus	skus[]		商品规格信息
seller_id	Int		卖家ID
sales	Int	1	销量
shop_id	Int		店铺ID
props_list	Mix	{"134:0": "颜色:黑色9000","453:0": "规格:XL","453:1": "规格:M","453:2": "规格:XS","453:3": "规格:L","453:4": "规格:S","453:5": "规格:XXL","453:6": "规格:XXXL"}	商品属性
seller_info	seller_info[]		卖家信息
tmall	Mix	false
error	String		错误信息
warning	String
url_log	Mix
stuff_status	String
data_from	String	ztk
method	String
promo_type	String	null
props_img	Mix
rate_grade	String
priceRange	Mix
shop_item	Mix
relate_items	Mix
shop_url	String		店铺链接
sn	String	12B049261107-9000

API分享：获取淘宝商品价格|详情|主图|sku信息

Mon, 30 Mar 2026 16:33:19 +0800

摘要：在电商数据分析、竞品监控、商品比价、批量上架等场景中，淘宝商品的详情主图与SKU信息（规格、价格、库存、对应图片）是核心数据。手动下载主图、整理SKU信息效率极低，本文将详解3种全自动获取方案（API正规调用、Python爬虫实现、第三方工具批量采集），涵盖环境准备、代码实现、反爬应对、数据存储全流程，新手可直接复用代码，高效完成数据采集需求，同时规避平台反爬风险，兼顾合规性与实操性。

关键词：淘宝商品数据；主图获取；SKU采集；Python爬虫；淘宝API；全自动采集

一、前言

随着电商行业的快速发展，无论是电商运营、数据分析从业者，还是个人开发者，经常需要批量获取淘宝商品的详情主图（首图、轮播图）和SKU信息（如颜色、尺寸、价格、库存、SKU对应图）。手动操作不仅耗时耗力，且容易出现数据遗漏、格式混乱等问题，尤其面对上百、上千个商品时，全自动采集成为必然选择。

本文将针对淘宝商品详情主图+SKU信息的全自动获取，提供3种不同难度的实现方案，适配不同需求场景：API方案（合规稳定，适合长期使用）、Python爬虫方案（灵活定制，适合技术开发者）、第三方工具方案（零代码，适合非技术人员）。每种方案均附详细步骤和实操代码，确保大家能快速落地使用，同时重点讲解反爬机制应对技巧，避免账号或IP被封禁。

二、API测试

编辑

1、注册开发平台账号，获取api测试key和密钥

2、查看API文档，请求参数、响应参数

3、传参测试API

4、接收响应数据，检查数据是否准确

三、数据存储与后续处理

无论采用哪种方案，采集到的主图和SKU信息都需要进行合理存储和处理，便于后续使用：

4.1 数据存储方式

Excel/Csv：适合少量数据（几百个商品），便于查看、编辑和分享，本文代码中已实现导出Excel功能。
数据库：适合大量数据（上千个商品），推荐使用MySQL、SQLite等数据库，将SKU信息和主图URL存入数据库，便于后续查询和批量处理。
本地文件夹：主图图片建议按商品ID分类保存（如创建“商品ID_商品标题”文件夹，存放该商品的所有主图和SKU图），便于管理和查看。

4.2 后续处理技巧

主图下载：采集到主图URL后，可通过Python代码批量下载图片（使用requests.get()请求URL，保存到本地）。
数据去重：批量采集时，可能出现重复数据，可通过pandas的drop_duplicates()方法去重，或在数据库中设置唯一索引（如商品ID+SKU ID）。
数据清洗：清洗无效数据（如空价格、空规格），统一数据格式（如价格转为数值类型、库存统一单位），便于后续分析。
定时采集：若需要定期获取商品数据（如监控竞品价格、库存），可使用Windows任务计划、Linux Crontab，结合Python脚本，实现定时全自动采集。

四、常见问题与解决方案

在全自动获取过程中，可能会遇到各种问题，以下是常见问题及解决方案，帮助大家快速排查：

5.1 问题1：API调用失败，提示“授权失效”

解决方案：Session有效期已过，重新获取Session（通过淘宝开放平台授权流程）；检查AppKey、AppSecret是否正确，应用是否审核通过。

5.2 问题2：爬虫爬取失败，提示“页面加载超时”“IP被封禁”

解决方案：检查网络连接；更换代理IP；增加请求间隔；更新Cookie；关闭浏览器自动化检测配置；分批次爬取，降低请求频率。

5.3 问题3：采集到的主图是缩略图，不是高清图

解决方案：淘宝主图URL通常包含尺寸参数（如“_400x400.jpg”“_50x50.jpg”），删除尺寸参数或改为“_800x800.jpg”“_1000x1000.jpg”，即可获取高清图；部分接口返回的主图URL本身就是高清图，可直接使用。

5.4 问题4：SKU信息缺失，无法获取部分SKU的价格、库存

解决方案：API方案：检查fields参数是否包含SKU相关字段，确保账号有获取SKU信息的权限；爬虫方案：确保模拟点击所有SKU选项，等待页面加载完成后再提取；部分商品SKU信息未公开，无法获取，属于正常情况。

5.5 问题5：第三方工具采集的数据不完整

解决方案：更新工具到最新版本；登录淘宝账号后再采集；检查商品URL是否正确；更换其他第三方工具尝试。

调用API批量获取淘宝商品数据标题价格链接商品类目演示

Fri, 27 Mar 2026 14:07:23 +0800

编辑

淘宝商品详情数据是从选品→定价→运营→供应链→用户→市场的全链路决策依据，既能帮商家提升效率与营收，也能支撑第三方服务、行业研究与技术创新。特别是商品标题、价格、SKU、销量、评价、库存、主图 / 详情图、参数、促销信息等。

taobao.item_get是用于获取单个商品的详情数据的API。通过代码对接可以实现自动批量获取商品数据。

调用示例

-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.服务器.cn/taobao/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=1027821174834&is_promotion=1"

调用API后，可获取以下响应数据。

"item": {		"num_iid": "1027821174834",		"title": "迷你猫咪掌心尺高颜值尺子小学生专用便携多功能亚克力绘图直尺",		"desc_short": "",		"price": "3.90",		"total_price": 0,		"suggestive_price": 0,		"orginal_price": "3.90",		"nick": "午后杂物社",		"num": 600,		"min_num": 0,		"detail_url": "https://item.taobao.com/item.htm?id=1027821174834",		"pic_url": "//img.alicdn.com/imgextra/i1/2220607898249/O1CN01uOb1hR2Ao6GxqT1FC_!!2220607898249.jpg",		"brand": "无品牌/无注册商标",		"brandId": null,		"rootCatId": null,		"cid": "201853304",		"crumbs": [],		"created_time": "",		"modified_time": "",		"delist_time": "",		"desc": "<div style=\"width: 750.0px;height: auto;overflow: hidden;\"><div style=\"width: 750.0px;height: auto;overflow: hidden;\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01M0ZJI42Ao6GyFzrw2_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01PB7Sfl2Ao6GySLtPG_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01ZmiYEl2Ao6Gxw2ie4_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01I3vV0A2Ao6GyDkyaB_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01AWiZ9S2Ao6GyfeFPx_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01Ne9dxL2Ao6GyZi0sa_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01wszWUE2Ao6GyG1oWF_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01wjqcdO2Ao6GyffBdP_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01l96CW72Ao6GyZjxRe_!!2220607898249.jpg\"><img style=\"display: block;width: 100.0%;\" src=\"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01amjiP42Ao6GySLxZ4_!!2220607898249.jpg\"></div></div><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.69c5dd407a85f&p=1965853903&k=i_key&t=1774574912\" style=\"display:none\" />",		"desc_img": [			"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01M0ZJI42Ao6GyFzrw2_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01PB7Sfl2Ao6GySLtPG_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01ZmiYEl2Ao6Gxw2ie4_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01I3vV0A2Ao6GyDkyaB_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01AWiZ9S2Ao6GyfeFPx_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01Ne9dxL2Ao6GyZi0sa_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i1/2220607898249/O1CN01wszWUE2Ao6GyG1oWF_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i3/2220607898249/O1CN01wjqcdO2Ao6GyffBdP_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01l96CW72Ao6GyZjxRe_!!2220607898249.jpg",			"https://img.alicdn.com/imgextra/i4/2220607898249/O1CN01amjiP42Ao6GySLxZ4_!!2220607898249.jpg"
		],		"item_imgs": [
			{				"url": "//img.alicdn.com/imgextra/i1/2220607898249/O1CN01uOb1hR2Ao6GxqT1FC_!!2220607898249.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i1/2220607898249/O1CN0177pAu52Ao6GxifvXE_!!2220607898249.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i4/2220607898249/O1CN01bGMUEU2Ao6GyWn788_!!2220607898249.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i2/2220607898249/O1CN01oEqiBo2Ao6GyL0et8_!!2220607898249.jpg"
			},
			{				"url": "//img.alicdn.com/imgextra/i1/2220607898249/O1CN01PJGfz92Ao6GyWCLOf_!!2220607898249.jpg"
			}
		],		"item_weight": "",		"item_size": "",		"location": "浙江金华",		"post_fee": null,		"express_fee": null,		"ems_fee": "",		"shipping_to": "",		"has_discount": "false",		"video": {			"url": "https://cloud.video.taobao.com/play/u/2220607898249/p/2/e/6/t/1/555455811151.mp4?appKey=38829"
		},		"is_virtual": "",		"sample_id": "",		"is_promotion": "false",		"props_name": "1627207:42777483765:颜色分类:迷你猫咪异性尺【1套5个】高颜值;1627207:42777483766:颜色分类:迷你猫咪异性尺【2套10个】高颜值;1627207:42777483767:颜色分类:迷你猫咪异性尺【3套15个】高颜值",		"prop_imgs": {			"prop_img": [
				{					"properties": "1627207:42777483765",					"url": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01LMiyUP2Ao6GyfYCpP_!!2220607898249.jpg"
				},
				{					"properties": "1627207:42777483766",					"url": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01h7tYXa2Ao6GzSAUgt_!!2220607898249.jpg"
				},
				{					"properties": "1627207:42777483767",					"url": "http://img.alicdn.com/imgextra/i4/2220607898249/O1CN01sNEVLA2Ao6GtArSJt_!!2220607898249.jpg"
				}
			]
		},		"property_alias": "",		"props": [
			{				"name": "品牌",				"value": "无品牌/无注册商标"
			},
			{				"name": "型号",				"value": "32"
			},
			{				"name": "适用学龄段",				"value": "小学"
			},
			{				"name": "颜色分类",				"value": "迷你猫咪异性尺【1套5个】高颜值,迷你猫咪异性尺【2套10个】高颜值,迷你猫咪异性尺【3套15个】高颜值"
			}
		],		"total_sold": "2",		"skus": {			"sku": [
				{					"price": 3.9,					"total_price": 0,					"orginal_price": 3.9,					"properties": "1627207:42777483765",					"properties_name": "1627207:42777483765:颜色分类:迷你猫咪异性尺【1套5个】高颜值",					"quantity": "200",					"sku_id": 6039400548950
				},
				{					"price": 5.9,					"total_price": 0,					"orginal_price": 5.9,					"properties": "1627207:42777483766",					"properties_name": "1627207:42777483766:颜色分类:迷你猫咪异性尺【2套10个】高颜值",					"quantity": "200",					"sku_id": 6039400548951
				},
				{					"price": 7.9,					"total_price": 0,					"orginal_price": 7.9,					"properties": "1627207:42777483767",					"properties_name": "1627207:42777483767:颜色分类:迷你猫咪异性尺【3套15个】高颜值",					"quantity": "200",					"sku_id": 6039400548952
				}
			]
		},		"seller_id": "2220607898249",		"sales": 2,		"shop_id": "238951494",		"props_list": {			"1627207:42777483765": "颜色分类:迷你猫咪异性尺【1套5个】高颜值",			"1627207:42777483766": "颜色分类:迷你猫咪异性尺【2套10个】高颜值",			"1627207:42777483767": "颜色分类:迷你猫咪异性尺【3套15个】高颜值"
		},		"seller_info": {			"nick": "午后杂物社",			"zhuy": "https://shop238951494.taobao.com/",			"shop_name": "午后杂物社"
		},		"tmall": false,		"error": "",		"warning": "",		"url_log": [],		"fav_count": null,		"fans_count": null,		"freight": null,		"props_imgs": {			"prop_img": [
				{					"properties": "1627207:42777483765",					"url": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01LMiyUP2Ao6GyfYCpP_!!2220607898249.jpg"
				},
				{					"properties": "1627207:42777483766",					"url": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01h7tYXa2Ao6GzSAUgt_!!2220607898249.jpg"
				},
				{					"properties": "1627207:42777483767",					"url": "http://img.alicdn.com/imgextra/i4/2220607898249/O1CN01sNEVLA2Ao6GtArSJt_!!2220607898249.jpg"
				}
			]
		},		"_ddf": "lh",		"promo_type": null,		"props_img": {			"1627207:42777483765": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01LMiyUP2Ao6GyfYCpP_!!2220607898249.jpg",			"1627207:42777483766": "http://img.alicdn.com/imgextra/i1/2220607898249/O1CN01h7tYXa2Ao6GzSAUgt_!!2220607898249.jpg",			"1627207:42777483767": "http://img.alicdn.com/imgextra/i4/2220607898249/O1CN01sNEVLA2Ao6GtArSJt_!!2220607898249.jpg"
		},		"format_check": "ok",		"shop_item": [],		"relate_items": []
	},

响应参数

名称	类型	必须	示例值	描述
item	item[]	1		宝贝详情数据【部分商品获取不到（药品、五金、天猫国际、百亿补贴类等）】
num_iid	Bigint	1	520813250866	宝贝ID
title	String	1	三刃木折叠刀过安检创意迷你钥匙扣钥匙刀军刀随身多功能小刀包邮	宝贝标题
desc_short	String	0		商品简介
promotion_price	Int	0		优惠价
price	Float	1	25.8	价格(当商品价格为0时，当前值为-1)，价格来自于未登入的划线价格，会有个别商品价格无法与页面匹配
total_price	Float	0	0
suggestive_price	Float	0	0
orginal_price	String	0	25.80	原价
nick	String	0	欢乐购客栈	掌柜昵称
num	Int	0	3836	库存(没有精确，是模糊值)
min_num	Int	0	0	最小购买数
detail_url	String	0	http://item.taobao.com/item.htm?id=520813250866	宝贝链接
pic_url	String	1	//gd2.alicdn.com/imgextra/i4/2596264565/TB2p30elFXXXXXQXpXXXXXXXXXX_!!2596264565.jpg	宝贝图片
brand	String	0	三刃木	品牌名称
brandId	Int	0	8879363	品牌ID
rootCatId	Int	0	50013886	顶级分类ID
cid	Int	1	50014822
created_time	String	0
modified_time	String	0
delist_time	String	0
desc	String	0		商品详情【暂时不支持】
desc_img	Mix	0	[]	商品详情图片【暂时不支持】
item_imgs	Mix	0	item_imgs[]	商品图片
location	String	0		发货地
video	video[]	0		商品视频【部分商品获取不到】
is_virtual	String	0
props_name	String	0	1627207:1347647754:颜色分类:长方形带开瓶器+送工具刀卡+链子;1627207:1347647753:颜色分类:椭圆形带开瓶器+送工具刀卡+链子;	商品属性名。格式为pid1:vid1:name1:value1;pid1:vid2:name2:value2。
prop_imgs	prop_imgs[]	0		商品属性图片列表
property_alias	String	0	20509:9974422:36;1627207:28326:红色;20509:9975710:38;1627207:28326:红色;20509:9981357:40;1627207:28326:红色	销售属性值别名。格式为pid1:vid1:alias1;pid1:vid2:alia2。
props	Mix	0	[{ "name": "产地","value": "中国" }]	商品属性
total_sold	Int	0
skus	skus[]	0		商品规格信息列表
seller_id	Int	0	2844096782	卖家ID
sales	Int	0	138	销量
shop_id	Int	0	151372205	店铺ID
props_list	Mix	0	{20509:9974422: 尺码:36}	商品属性
seller_info	seller_info[]	1		卖家信息
tmall	Boolean	0	false	是否天猫
error	String	0		错误信息
warning	String	0		警告信息
url_log	Mix	0	[]
favcount	Int	0	0
fanscount	Int	0	0
method	String	0	item_tmall:pget_item
promo_type	String	0
props_img	Mix	0	1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg	属性图片
shop_item	Mix	0	[]
relate_items	Mix	0	[]

批量获取淘宝商品列表的API分享：关键字搜索、店铺所有商品、图片搜索商品

Fri, 27 Mar 2026 14:03:18 +0800

批量获取淘宝的商品列表，需要确定请求参数。可以通过关键字搜索获取商品列表，也可以获取指定店铺的全部商品，还可以通过图片识别的方式来获取同款商品。

item_search 按关键字搜索淘宝商品
item_search_tmall 按关键字搜索天猫商品
item_search_pro 高级关键字搜索淘宝商品
item_search_img 按图搜索淘宝商品（拍立淘）
item_search_shop 获得店铺的所有商品

公共参数获取淘宝API测试

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter=

参数说明：q:搜索关键字
page:页数【最大翻页100页】

响应示例

{  "items": {    "page": "1",    "real_total_results": "360000",    "total_results": "360000",    "page_size": 10,    "pagecount": "200",    "_ddf": "szx",    "item": [
      {        "title": "高腰百搭羊羔绒阔腿裤冬季保暖",        "pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01TpegE82EAUGWQD2JI_!!0-item_pic.jpg",        "promotion_price": "50.00",        "orginal_price": "50.00",        "price": "50.00",        "sales": 0,        "num_iid": "756775095301",        "detail_url": "https://item.taobao.com/item.htm?id=756775095301"
      },
      {        "title": "德绒圆领打底衫短款修身内搭长袖T恤女秋冬纯色弧形小众百搭上衣",        "pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01xuzAuZ2LY21GBhlfE_!!3937219703-0-C2M.jpg",        "promotion_price": "44.40",        "orginal_price": "44.40",        "price": "44.40",        "sales": 0,        "num_iid": "825927041956",        "detail_url": "https://item.taobao.com/item.htm?id=825927041956"
      },
      {        "title": "美式辣妹螺纹修身女打底衫长袖",        "pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN010d2Jxj1ZOJwsXSEHg_!!862293184.jpg",        "promotion_price": "58.00",        "orginal_price": "58.00",        "price": "58.00",        "sales": 0,        "num_iid": "735775262176",        "detail_url": "https://item.taobao.com/item.htm?id=735775262176"
      },
      {        "title": "2024年新款高腰复古牛仔裤女秋季",        "pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01YfwUGX1h1tbd5rczJ_!!2206584264218-0-C2M.jpg",        "promotion_price": "59.85",        "orginal_price": "59.85",        "price": "59.85",        "sales": 0,        "num_iid": "837243885999",        "detail_url": "https://item.taobao.com/item.htm?id=837243885999"
      },
      {        "title": "【秋冬绝美可单穿慵懒小上衣】",        "pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01m6HRZH1zxkhIMd3OG_!!0-item_pic.jpg",        "promotion_price": "57.00",        "orginal_price": "57.00",        "price": "57.00",        "sales": 0,        "num_iid": "818387607863",        "detail_url": "https://item.taobao.com/item.htm?id=818387607863"
      },
      {        "title": "秋季新款复古高腰阔腿牛仔裤女宽松显瘦垂感拖地直筒长裤水洗做旧",        "pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01aJeIvR1mQEi3d7tnq_!!2206588314948-2-C2M.jpg",        "promotion_price": "74.85",        "orginal_price": "74.85",        "price": "74.85",        "sales": 0,        "num_iid": "819491929229",        "detail_url": "https://item.taobao.com/item.htm?id=819491929229"
      },
      {        "title": "美式复古豹纹牛仔裤女男夏季潮牌小众阔腿裤宽松垂感休闲长裤腰带",        "pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01fQC8Vc2LY21fSyrpo_!!3937219703-0-C2M.jpg",        "promotion_price": "55.80",        "orginal_price": "55.80",        "price": "55.80",        "sales": 0,        "num_iid": "797999211515",        "detail_url": "https://item.taobao.com/item.htm?id=797999211515"
      },
      {        "title": "u领冬季白色内搭长袖秋季上衣女秋冬打底衫短款秋衣春秋修身t恤",        "pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01XfN4ys1I8Qr51Xkzq_!!0-item_pic.jpg",        "promotion_price": "47.75",        "orginal_price": "47.75",        "price": "47.75",        "sales": 0,        "num_iid": "835469595962",        "detail_url": "https://item.taobao.com/item.htm?id=835469595962"
      },
      {        "title": "【李佳锜推荐】高领内搭打底衫女",        "pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01X1jpKO1Xzl0WvcLqA_!!0-item_pic.jpg",        "promotion_price": "59.00",        "orginal_price": "59.00",        "price": "59.00",        "sales": 0,        "num_iid": "690366689843",        "detail_url": "https://item.taobao.com/item.htm?id=690366689843"
      },
      {        "title": "高腰休闲宽松条纹运动裤",        "pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/O1CN01yL3DXE1ToWxdKP8UP_!!0-item_pic.jpg",        "promotion_price": "42.78",        "orginal_price": "42.78",        "price": "42.78",        "sales": 0,        "num_iid": "841863957500",        "detail_url": "https://item.taobao.com/item.htm?id=841863957500"
      }
    ],    "item_weight_update": 0
  },  "error_code": "0000",  "reason": "ok",  "secache": "a8881ed5637e3c7e84f03acdc86be64f",  "secache_time": 1729489209,  "secache_date": "2024-10-21 13:40:09",  "translate_status": "",  "translate_time": 0,  "language": {    "default_lang": "cn",    "current_lang": "cn"
  },  "error": "",  "cache": 0,  "api_info": "today:57 max:10000 all[2982=57+30+2895];expires:2030-10-30",  "execution_time": "1.911",  "server_time": "Beijing/2024-10-21 13:40:09",  "client_ip": "61.131.237.50",  "call_args": {    "q": "女装",    "start_price": "0",    "end_price": "0",    "page": "1",    "cat": "0"
  },  "api_type": "taobao",  "translate_language": "zh-CN",  "translate_engine": "",  "server_memory": "4.39MB",  "request_id": "gw-3.6715e9377d64c",  "last_id": "3628047818"}

1688 商品数据接口：B2B 选品、比价、供应链监控的核心引擎

Wed, 25 Mar 2026 17:34:00 +0800

在 B2B 电商数字化转型浪潮中，数据已成为企业决策的核心驱动力。1688 作为阿里巴巴旗下全球领先的批发采购平台，其开放的商品数据接口（API）正成为连接平台与企业系统的关键桥梁，为选品决策、智能比价、供应链优化提供全方位数据支撑。本文将从技术实现到商业价值，全面解析 1688 商品数据接口如何成为 B2B 业务的核心引擎。

一、核心接口矩阵：构建商品数据采集生态

1688 开放平台提供了完整的商品数据接口体系，覆盖从基础信息到深度分析的全链路需求：

接口名称	核心功能	适用场景	关键字段
alibaba.product.get	商品基础信息查询	商品详情展示、基础数据采集	商品 ID、标题、主图、类目、描述、价格区间
alibaba.offer.price.get	价格与折扣信息获取	比价分析、成本核算	批发价、零售价、起订量、阶梯价格、混批规则
alibaba.offer.spec.get	SKU 规格与库存查询	库存监控、多规格采购	SKU ID、规格名称、规格值、库存数量、预警阈值
alibaba.product.search	商品搜索与筛选	批量选品、市场分析	关键词、价格区间、销量排序、诚信通年限、发货地
alibaba.shop.get	店铺信息查询	供应商评估、资质审核	店铺 ID、诚信通年限、好评率、纠纷率、主营类目

这些接口采用 RESTful 风格设计，支持 HTTPS 协议传输，确保数据安全可靠，同时提供 OAuth2.0 认证机制和签名验证，保障接口调用的合法性与唯一性。

二、技术接入实战：从认证到数据落地的全流程

2.1 接入准备：四步获取接口调用权限

注册开发者账号：访问 1688 开放平台完成企业 / 个人开发者认证
创建应用：在控制台创建应用，获取 app_key 和 app_secret（核心凭证）
申请接口权限：在 API 列表中提交所需接口权限申请（基础权限免费，高并发需企业版）
获取 Access Token：通过 OAuth2.0 授权流程获取访问令牌（有效期 2 小时，需定时刷新）

2.2 签名机制：保障接口调用安全

1688 API 采用 MD5 签名验证机制，核心步骤如下：

import hashlib
import urllib.parse

def generate_sign(params, app_secret):
    # 1. 按 ASCII 升序排列所有参数（排除 sign）
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    # 2. 拼接为 key1=value1&key2=value2 格式
    sign_str = "&".join([f"{k}={urllib.parse.quote(str(v))}" for k, v in sorted_params])
    # 3. 首尾拼接 AppSecret
    sign_str = app_secret + sign_str + app_secret
    # 4. MD5 加密并转为大写
    sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()
    return sign

关键注意事项：

参数必须 URL 编码，中文需转为 %XX 格式
时间戳格式严格遵循 yyyy-MM-dd HH:mm:ss，与服务器时间误差不超过 5 分钟
签名时需包含所有请求参数（含公共参数：app_key、timestamp、format 等）

2.3 Python 实战：商品详情数据采集完整代码

以下代码实现通过 alibaba.product.get 接口获取商品详情，并解析核心数据：

import requestsimport jsonimport time# 配置参数APP_KEY = "your_app_key"APP_SECRET = "your_app_secret"ACCESS_TOKEN = "your_access_token"PRODUCT_ID = "678901234567"  # 目标商品 IDdef get_product_detail(product_id):    """获取商品详情数据"""
    url = "https://open.1688.com/api/param2/1/com.alibaba.product/alibaba.product.get"
    
    # 1. 构造请求参数
    params = {        "app_key": APP_KEY,        "access_token": ACCESS_TOKEN,        "format": "json",        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),        "productId": product_id,        "fields": "productId,title,description,picUrl,priceRange,minOrderQuantity"
    }    
    # 2. 生成签名
    params["sign"] = generate_sign(params, APP_SECRET)    
    # 3. 发送请求
    response = requests.get(url, params=params, timeout=10)    
    # 4. 解析响应
    if response.status_code == 200:
        result = json.loads(response.text)        if result.get("error_response"):            raise Exception(f"API 调用失败: {result['error_response']['msg']}")        return result["product_get_response"]["product"]    else:        raise Exception(f"HTTP 请求失败: {response.status_code}")# 执行采集if __name__ == "__main__":    try:
        product_data = get_product_detail(PRODUCT_ID)        print("商品详情数据:")        print(f"标题: {product_data['title']}")        print(f"价格区间: {product_data['priceRange']}")        print(f"起订量: {product_data['minOrderQuantity']}")        print(f"主图: {product_data['picUrl']}")    except Exception as e:        print(f"采集失败: {str(e)}")

三、三大应用场景深度解析：从数据到决策的价值转化

3.1 智能选品：数据驱动的采购决策革命

传统 B2B 选品依赖经验判断，易出现成本失控和市场适配偏差。通过 1688 商品数据接口，企业可实现：

多维度精准筛选：

# 选品条件示例：价格≤50元 + 起订量≤100件 + 诚信通≥3年 + 7天发货率≥90%search_params = {    "keyword": "办公文具",    "priceStart": 0,    "priceEnd": 50,    "minOrderQuantity": 100,    "memberLevel": 3,  # 诚信通 3 年以上
    "deliveryRate": 90,  # 7 天发货率 ≥90%
    "page": 1,    "pageSize": 50}

市场趋势分析：

监控热门类目商品增长趋势，提前布局潜力产品
分析竞品价格带分布，制定差异化定价策略
结合历史销售数据，预测季节性商品需求波动

3.2 智能比价：构建动态成本优化体系

1688 商品数据接口解决了传统比价效率低、误差大的痛点，实现采购成本的精准控制：

动态比价算法实现：

def calculate_optimal_price(products):    """计算最优采购方案（考虑起订量、价格、运费）"""
    optimal = None
    for p in products:        # 计算单位成本（含运费分摊）
        unit_cost = (p["price"] * p["minOrderQuantity"] + p["shippingFee"]) / p["minOrderQuantity"]
        p["unit_cost"] = unit_cost        
        # 筛选最优方案
        if not optimal or (p["unit_cost"] < optimal["unit_cost"] and p["stock"] >= p["minOrderQuantity"]):
            optimal = p    return optimal

核心价值：

实时监控同款商品不同供应商价格波动，设置降价提醒
结合起订量、运费、折扣规则，计算全链路采购成本
建立供应商价格数据库，识别价格异常波动，防范采购风险

3.3 供应链监控：打造可视化风险预警系统

1688 商品数据接口与供应链管理系统对接，实现从采购到库存的全流程可视化监控：

库存与履约监控方案：

实时库存追踪：通过 alibaba.offer.spec.get 接口定时获取 SKU 库存，设置库存预警阈值，避免缺货风险

供应商履约评估：

# 供应商评分模型def evaluate_supplier(supplier_data):
    score = 0
    # 诚信通年限（权重 30%）
    score += supplier_data["memberLevel"] * 6
    # 好评率（权重 25%）
    score += supplier_data["positiveRate"] * 0.25
    # 纠纷率（权重 20%，反向计分）
    score += (100 - supplier_data["disputeRate"]) * 0.2
    # 发货及时率（权重 25%）
    score += supplier_data["deliveryRate"] * 0.25
    return round(score, 2)

价格稳定性分析：通过 30 天价格标准差计算，识别价格波动大的供应商，降低供应链风险

四、避坑指南与最佳实践

4.1 常见技术问题与解决方案

问题类型	典型表现	解决方案
签名错误	返回 `invalid-signature`	1. 检查参数排序是否正确2. 验证 URL 编码是否完整3. 确认 AppSecret 拼接格式
权限不足	返回 `permission-denied`	1. 检查接口权限是否已申请2. 确认 AccessToken 是否有效3. 企业版接口需升级账号资质
限流问题	返回 `rate-limit-exceeded`	1. 实现接口调用频率控制（建议 ≤10 次 / 秒）2. 缓存重复请求数据3. 高并发场景申请专属 API 通道
数据延迟	返回数据与平台显示不一致	1. 合理设置缓存过期时间（建议 5-15 分钟）2. 关键数据实时请求，非关键数据定时同步

4.2 合规性与稳定性保障

合规采集原则：

严格遵守 1688 开放平台 API 使用协议，禁止未经授权的数据商业化
数据仅用于企业内部系统，不得泄露给第三方
避免高频调用同一接口，尊重平台限流规则

系统架构最佳实践：

plaintext

应用层 → 接口调用层（含签名/认证）→ 数据缓存层（Redis）→ 数据处理层 → 存储层（MySQL/ClickHouse）

引入消息队列（如 RabbitMQ）处理批量请求，削峰填谷
实现接口调用失败自动重试机制（建议 3 次，间隔 2 秒）
建立接口监控看板，实时预警调用异常

五、总结与展望

1688 商品数据接口已从单纯的数据获取工具，演变为 B2B 企业数字化转型的核心基础设施。通过接口赋能，企业可实现：

效率提升：采购流程自动化，人力成本降低 60% 以上
成本优化：动态比价体系，平均采购成本降低 15-25%
风险可控：供应链可视化监控，履约风险降低 40%
决策智能：数据驱动选品，新品成功率提升 30%

随着 AI 技术与 API 生态的深度融合，未来 1688 商品数据接口将支持更复杂的业务场景：如基于图像识别的相似商品推荐、自然语言处理的智能询盘生成、机器学习驱动的供应链风险预测等。对于 B2B 企业而言，掌握 1688 商品数据接口技术，已成为提升核心竞争力的必要条件。

下一步行动建议：

注册 1688 开放平台开发者账号，申请核心接口权限
搭建基础数据采集系统，实现商品数据的自动化获取
结合企业业务场景，开发智能选品、比价、供应链监控模块
持续优化系统性能，建立数据安全与合规保障机制

电商平台公开数据采集实践：基于合规接口的数据分析方案

Sun, 22 Mar 2026 15:59:55 +0800

编辑

在电商行业数字化转型加速的当下，数据已成为企业优化运营、精准营销、提升竞争力的核心资产。电商平台公开数据（如商品基础信息、公开评价摘要、行业类目数据等）的采集与分析，能够帮助企业洞察市场趋势、了解竞品动态、优化产品布局。但需明确：数据采集的前提是合规，严禁爬取平台非公开数据、侵犯用户隐私或违反平台 robots 协议，本文将聚焦“合规接口”为核心的采集方案，结合实操案例，分享电商公开数据采集的全流程实践。

一、方案核心原则：合规优先，拒绝违规爬取

电商平台公开数据采集的核心底线的是“合规”，违规爬取（如突破平台反爬机制、采集未公开数据、高频恶意请求等）不仅可能导致IP被封禁、账号受限，还可能触犯《网络安全法》《数据安全法》等相关法律法规，承担法律责任。本方案严格遵循以下合规原则：

仅采集平台明确公开的非敏感数据，不涉及用户隐私（如手机号、地址）、商业机密（如未公开的销量、利润）；
优先使用平台官方开放API、第三方合规数据接口，不使用爬虫程序破解平台反爬限制；
控制请求频率，遵循平台接口调用规范，不造成平台服务器负载压力；
采集的数据仅用于企业内部分析、市场调研，不用于非法传播、商业滥用。

二、合规接口选型：适配不同采集需求

电商公开数据采集的关键的是选择合规、稳定的接口，不同接口适配不同的采集场景，结合企业需求可分为三类，具体选型建议如下：

（一）平台官方开放API

主流电商平台（如淘宝、京东、拼多多等）均提供官方开放API，用于开发者合规获取平台公开数据，这是最安全、最稳定的采集方式。

适用场景：需要长期、批量采集某一平台的公开数据（如商品类目、公开评价、店铺基础信息等），适合企业级长期使用。

优势：合规性最高，数据准确性、稳定性强，接口更新有官方保障，无需担心反爬封禁；

注意事项：需完成平台开发者认证，部分API需申请开通权限，部分接口有调用次数限制（免费额度+付费升级），需严格遵循接口调用规范。

示例：淘宝开放平台的“商品搜索API”“店铺信息API”，可合规获取商品标题、价格、类目、店铺名称等公开信息。

（二）第三方合规数据接口

针对小型企业或个人开发者，若无需长期批量采集，或官方API权限申请复杂，可选择第三方合规数据服务提供商的接口（如万邦科技等）。

适用场景：短期采集、小批量数据获取，如临时的市场调研、竞品简单分析，无需投入过多精力对接官方API。

优势：接入门槛低，无需开发者认证，接口调用简单，支持多平台数据聚合（如同时采集淘宝、京东的公开商品数据）；

注意事项：需选择有合法资质、口碑良好的第三方平台，确认其数据来源合规，避免使用来源不明的接口，同时注意控制调用成本。

（三）自定义合规采集接口（基于公开数据渲染）

对于部分未提供官方API、且第三方接口覆盖不全的场景，可基于平台公开页面的渲染数据，开发自定义合规采集接口，核心是“模拟正常用户访问，不破解、不侵入”。

适用场景：小众电商平台、特定场景的公开数据采集（如某平台的行业趋势公开数据），且需严格控制请求频率，模拟正常用户行为。

优势：灵活性高，可适配特殊采集需求；

注意事项：需严格遵循平台 robots 协议，不采集隐藏数据，不使用多IP代理、恶意请求等方式，避免触发平台反爬机制，建议添加请求间隔（如1-2秒/次）。

三、全流程采集实践：基于Python的合规接口调用案例

本文以“第三方合规接口”为例，结合Python语言，实现电商公开商品数据的采集、解析与存储，全程遵循合规原则，适合新手入门实践。

（一）环境准备

1. 开发环境：Python 3.8+，推荐使用PyCharm；

2. 核心依赖库：requests（接口请求）、pandas（数据处理）、json（数据解析）、mysql-connector-python（数据存储，可选）；

3. 接口准备：在第三方合规数据平台（如聚合数据）申请“电商商品公开数据接口”，获取接口密钥（API Key），确认接口调用规范（请求频率、参数要求）。

（二）核心步骤：接口调用+数据解析+存储

1. 接口请求（合规控制）

核心是控制请求频率，携带合法参数，避免恶意请求。以下为示例代码（以聚合数据“电商商品搜索接口”为例）：

import requests import time import pandas as pd # 第三方接口信息（替换为自己的API Key） API_KEY = "your_api_key" API_URL = "https://apis.juhe.cn/ecommerce/search" def get_ecommerce_data(keyword, page=1, page_size=10): """ 调用第三方合规接口，获取电商公开商品数据 :param keyword: 搜索关键词（如“儿童玩具”） :param page: 分页页码 :param page_size: 每页数据量 :return: 解析后的商品数据列表 """ # 接口请求参数（遵循接口规范） params = { "key": API_KEY, "keyword": keyword, "page": page, "page_size": page_size, "platform": "taobao" # 可指定平台（淘宝、京东等） } try: # 发送请求，控制请求间隔（1秒/次，避免高频请求） time.sleep(1) response = requests.get(API_URL, params=params, timeout=10) response.raise_for_status() # 抛出请求异常（如404、500） data = response.json() # 接口返回校验（确认请求成功） if data["error_code"] == 0: return data["result"]["items"] # 返回商品数据列表 else: print(f"接口请求失败：{data['reason']}") return [] except Exception as e: print(f"请求异常：{str(e)}") return []

2. 数据解析（提取有效信息）

接口返回的数据多为JSON格式，需提取核心有效信息（如商品标题、价格、店铺名称、类目等），过滤无效数据，确保数据完整性。示例代码：

def parse_data(items): """ 解析商品数据，提取核心信息 :param items: 接口返回的商品数据列表 :return: 结构化数据列表 """ parsed_data = [] for item in items: # 提取公开的核心信息（不涉及敏感数据） product_info = { "商品标题": item.get("title", ""), "商品价格": item.get("price", 0.0), "店铺名称": item.get("shop_name", ""), "商品类目": item.get("category", ""), "公开评价数": item.get("comment_count", 0), "采集时间": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()) } # 过滤无效数据（如价格为0、标题为空的商品） if product_info["商品标题"] and product_info["商品价格"] > 0: parsed_data.append(product_info) return parsed_data

3. 数据存储（持久化管理）

将解析后的结构化数据存储到本地文件（CSV）或数据库（MySQL），方便后续分析使用。示例代码（存储为CSV文件）：

def save_data(parsed_data, save_path="ecommerce_data.csv"): """ 将解析后的数据存储为CSV文件 :param parsed_data: 结构化数据列表 :param save_path: 存储路径 """ if not parsed_data: print("无有效数据可存储") return # 转换为DataFrame，便于存储和后续分析 df = pd.DataFrame(parsed_data) # 追加存储（避免覆盖已有数据） df.to_csv(save_path, mode="a", index=False, header=not pd.io.common.file_exists(save_path), encoding="utf-8-sig") print(f"数据存储成功，共存储{len(parsed_data)}条商品数据") # 主函数：执行采集流程 if __name__ == "__main__": # 采集关键词（可根据需求修改） keywords = ["儿童玩具", "小学生文具"] # 分页采集（避免单页请求过多数据） for keyword in keywords: print(f"开始采集关键词：{keyword}") for page in range(1, 3): # 采集1-2页数据 items = get_ecommerce_data(keyword, page=page, page_size=10) parsed_data = parse_data(items) save_data(parsed_data) print("采集完成，数据已存储至ecommerce_data.csv")

四、数据清洗与数据分析应用

采集到的公开数据可能存在重复、缺失、异常等问题，需先进行清洗，再用于实际分析，以下为核心步骤：

（一）数据清洗

1. 去重：删除重复的商品数据（如同一商品ID重复采集）；

2. 补全：对缺失的非关键字段（如类目）进行填充，关键字段（如标题、价格）缺失的数据直接删除；

3. 去异常：删除价格异常（如远低于市场价、远高于市场价）、评价数异常的数据；

4. 标准化：统一数据格式（如价格保留2位小数、类目统一命名）。

（二）数据分析应用场景

基于合规采集的公开数据，可实现以下核心应用，为电商运营提供决策支持：

市场趋势分析：通过采集不同时间段的商品价格、类目分布数据，分析市场需求变化（如某类商品价格走势、热门类目占比）；
竞品分析：采集竞品商品的价格、评价、类目等数据，对比自身产品的优势与不足，优化产品定价和布局；
用户偏好分析：通过公开评价摘要（非隐私信息），提取用户对商品的核心需求和反馈，优化产品功能；
类目优化：分析不同类目的商品销量、评价情况，调整店铺类目布局，聚焦高需求、高好评的类目。

五、合规采集避坑指南

在电商公开数据采集过程中，容易出现合规风险和技术问题，结合实践经验，总结以下避坑要点：

拒绝“破解反爬”：不使用爬虫框架（如Scrapy）破解平台反爬机制，不使用代理IP批量请求、不伪造用户身份，避免IP封禁和法律风险；
严格控制请求频率：无论使用官方API还是第三方接口，均需遵循接口调用规范，避免高频请求给平台服务器造成压力，建议设置1-2秒/次的请求间隔；
明确数据用途：采集的数据仅用于企业内部分析、市场调研，不用于商业竞争、非法传播，不泄露采集到的公开数据；
定期检查接口状态：官方API和第三方接口可能会更新、调整，需定期检查接口调用情况，及时适配接口变化，避免采集失败；
规避敏感数据：严禁采集用户隐私（如手机号、收货地址、身份证号）、平台商业机密（如未公开的销量、利润、后台数据），仅采集页面公开的非敏感信息。

六、方案总结

电商平台公开数据采集的核心是“合规”，基于官方开放API、第三方合规接口的采集方案，既能够保证数据的准确性、稳定性，又能规避法律风险和技术风险。本文通过实操案例，完整展示了从接口选型、环境搭建、接口调用、数据解析、存储到数据分析的全流程，适合企业和开发者用于合规的市场调研、运营优化。

后续可根据实际需求，优化采集策略（如增加多平台数据采集、定时自动采集），深化数据分析（如结合可视化工具Tableau、Matplotlib实现数据可视化），让公开数据真正为电商运营赋能。同时，需始终坚守合规底线，随着数据监管政策的完善，持续优化采集方案，确保数据采集与使用的合法性、合规性。

淘宝开放平台 API 申请太难？第三方稳定 API 替代方案

Wed, 18 Mar 2026 16:19:47 +0800

在电商数据开发、竞品分析、价格监控等场景中，淘宝商品详情数据是核心刚需。但不少开发者反馈：淘宝开放平台（TOP）API 申请门槛高、流程繁琐、审核严格，个人 / 中小团队很难快速拿到可用权限。本文从实战角度，客观分析官方 API 的痛点，并给出第三方稳定 API 替代方案，全程技术视角、无硬广，帮你快速落地数据采集需求。

一、淘宝开放平台 API：申请难在哪？

1. 资质与审核门槛高

个人开发者：仅开放基础权限，商品详情、搜索等核心接口大多需要企业资质（营业执照、法人信息）才能申请。
应用审核：创建应用需详细填写用途、场景、数据使用范围，审核周期 1–3 个工作日，驳回率高。
权限分级：基础接口免费但限制多，高频 / 高级接口需额外申请、按调用量付费，且有 QPS 限制。

2. 接入与维护成本高

签名机制复杂：需按 TOP 规则生成sign、session，调试成本高。
接口迭代频繁：字段、参数、错误码常变，需持续跟进文档。
反爬与限流：官方对调用频率、IP、行为监控严格，易触发限流 / 封禁。

3. 适用场景受限

仅支持授权店铺数据：非自有店铺的公开商品数据，官方 API 获取难度大。
批量 / 高并发场景：免费额度低，扩容成本高，不适合大数据采集。

二、第三方稳定 API：替代方案的核心优势

第三方 API 是服务商基于合规渠道封装的标准化电商数据接口，直接提供商品详情、搜索、评论、店铺等数据，适合快速接入、低成本落地。

1. 接入极简，零门槛

无需企业资质、无需复杂审核，注册即可获取key调用。
统一接口规范：一套参数适配多平台，无需分别对接淘宝、京东、拼多多。
无签名 / 无复杂验签：直接 HTTP/HTTPS 请求，返回结构化 JSON。

2. 稳定可靠，抗反爬

服务商统一处理反爬、IP 池、验证码、风控，99%+ 可用性。
数据实时 / 准实时：价格、库存、销量动态更新，适合监控场景。
高并发支持：支持批量、异步、定时任务，满足大数据需求。

3. 成本可控，按需付费

按调用量计费，无最低消费，适合中小团队 / 个人测试。
套餐灵活：测试包、基础包、企业包，按需升级。
无隐性成本：无需维护服务器、反爬策略、数据清洗。

三、方案对比：官方 API vs 第三方 API vs 爬虫

对比维度	淘宝官方 API	第三方稳定 API	自主爬虫
申请难度	高（企业资质 + 审核）	低（注册即用）	中（需技术能力）
稳定性	极高（官方）	高（服务商保障）	低（易被封 / 反爬）
开发成本	中（签名 + 调试）	低（直接调用）	高（反爬 + 维护）
合规性	最高	高（合规渠道）	低（法律风险）
适用场景	自有店铺、合规刚需	快速开发、多平台、监控	小众 / 临时需求

四、第三方 API 实战：快速获取淘宝商品详情（Python 示例）

以通用第三方商品详情接口为例，演示如何一行代码获取完整商品数据（标题、价格、SKU、主图、详情、销量等）。

1. 接口说明

接口地址：https://api.example.com/item/get（示例域名，实际以服务商为准）
请求方式：GET/POST
必传参数：apikey、num_iid（淘宝商品 ID）

2. Python 代码示例

import requests# 配置参数API_KEY = "你的API_KEY"NUM_IID = "689076543210"  # 淘宝商品IDAPI_URL = "https://api.example.com/item/get"# 发起请求params = {    "apikey": API_KEY,    "num_iid": NUM_IID,    "fields": "title,price,sku,pic_url,detail_url,sales_count"  # 按需指定字段}
response = requests.get(API_URL, params=params)
data = response.json()# 输出结果if data.get("code") == 200:
    item = data.get("data", {})    print("商品标题:", item.get("title"))    print("商品价格:", item.get("price"))    print("SKU信息:", item.get("sku"))    print("主图链接:", item.get("pic_url"))else:    print("请求失败:", data.get("msg"))

3. 返回数据示例（JSON）

{    "code": 200,    "msg": "success",    "data": {        "num_iid": "689076543210",        "title": "2026新款无线蓝牙耳机",        "price": "199.00",        "sku": [{"颜色": "白色", "规格": "标准版", "price": "199.00"}],        "pic_url": "https://img.example.com/xxx.jpg",        "detail_url": "https://item.taobao.com/item.htm?id=xxx",        "sales_count": "12345",        "shop_name": "XX数码旗舰店"
    }
}

五、选择第三方 API 的注意事项

合规性优先：选择有正规资质、数据来源合规的服务商，避免法律风险。
稳定性测试：先申请免费测试额度，验证接口响应速度、数据准确性、可用性。
文档与售后：优先选择接口文档完善、提供技术支持的服务商，降低调试成本。
成本透明：确认计费模式（按次 / 包月）、是否有隐藏费用、是否支持退款。

六、总结

淘宝开放平台 API 虽合规，但申请难、接入慢、成本高，不适合快速开发与中小团队。第三方稳定 API 以低门槛、高稳定、低成本的优势，成为电商数据采集的主流替代方案。

建议：

个人 / 中小团队：优先选择第三方 API，快速落地需求。
企业级项目：可官方 + 第三方结合，自有店铺用官方，公开数据用第三方。

本文仅做技术方案分享，无任何商业推广。如需测试第三方 API，可通过正规服务商平台申请免费额度，按需选择。

淘宝商品详情字段解析：SKU、价格、库存接口全梳理

Mon, 16 Mar 2026 17:19:09 +0800

在电商数据采集、竞品分析、价格监控等场景中，淘宝商品详情数据是核心资产。本文聚焦淘宝开放平台商品详情接口的SKU、价格、库存三大核心字段，从接口调用到字段解析，再到实战代码与避坑指南，提供一套完整的技术方案，助力开发者高效获取与处理淘宝商品数据。

一、前置准备：接口接入基础

1.1 核心接口说明

淘宝开放平台提供两个核心接口获取商品详情数据：

表格

接口名称	接口方法	核心功能	适用场景
商品详情接口	taobao.item.get	获取商品完整信息（含基础信息、SKU、价格、库存）	商品详情页展示、数据采集
SKU 详情接口	taobao.item.sku.get	单独获取 SKU 列表及详情	库存监控、价格对比

1.2 接入三要素（必配）

AppKey：应用唯一标识，在淘宝开放平台注册应用后获取
AppSecret：应用密钥，用于接口请求签名加密，严禁泄露、严禁明文存储
商品 ID（num_iid）：淘宝商品唯一标识，可从商品链接中提取（如https://item.taobao.com/item.htm?id=123456789中的123456789）

1.3 签名机制（关键步骤）

淘宝 API 采用参数签名确保请求合法性，核心流程如下：

参数排序：将所有请求参数（公共参数 + 业务参数）按参数名 ASCII 码升序排序
拼接字符串：按key1=value1&key2=value2...格式拼接（值需 URL 编码）
首尾加盐：拼接为AppSecret + 拼接字符串 + AppSecret
加密处理：使用 MD5 或 HMAC-SHA256 加密，结果转大写
添加签名：将加密结果作为sign参数加入请求

二、SKU 字段深度解析

SKU（库存量单位）是多规格商品的最小销售单元，如颜色 + 尺码组合。在淘宝 API 返回结果中，SKU 信息通过skus字段数组返回。

2.1 SKU 核心字段表

表格

字段名	数据类型	说明	示例
sku_id	String	SKU 唯一标识，下单必备	4112264076
properties	String	属性组合 ID，格式为 "属性 ID: 属性值 ID;"	"1627207:28332;20509:28314;"（颜色：白色；尺码：M）
props_name	String	属性组合名称，可读性强	"颜色：白色；尺码：M"
sku_price	String	SKU 单独定价	"88.50"
quantity	Number	SKU 库存数量	100
sku_spec_id	String	规格 ID，部分接口返回	"123456"
sku_url	String	SKU 单独链接	"https://item.taobao.com/item.htm?id=xxx&skuId=yyy"

2.2 SKU 属性映射技巧

properties字段返回的是属性 ID 组合，需通过商品属性接口（taobao.item.props.get）获取属性名称映射表，实现 ID 到名称的转换：

# 属性映射示例props_map = {    "1627207": "颜色",    "28332": "白色",    "20509": "尺码",    "28314": "M"}# 解析properties字段def parse_sku_properties(properties_str, props_map):
    props = {}    for prop_pair in properties_str.split(';'):        if ':' in prop_pair:
            prop_id, value_id = prop_pair.split(':')
            prop_name = props_map.get(prop_id, prop_id)
            value_name = props_map.get(value_id, value_id)
            props[prop_name] = value_name    return props

三、价格字段解析：从基础价到最终成交价

淘宝商品价格体系复杂，包含基础价、SKU 价、优惠价等多个维度，需重点关注字段间的关联关系。

3.1 核心价格字段表

表格

字段名	数据类型	说明	优先级
price	String	商品基础价格（非 SKU 商品）	1（无 SKU 时）
sku_price	String	SKU 单独定价（多规格商品）	1（有 SKU 时）
promotion_price	String	促销价格（如满减、折扣）	2
final_price	String	最终成交价（优惠后）	3
price_range	String	价格区间（多 SKU 商品）	"89.00-159.00"
cost_price	String	成本价（商家可见）	仅特定权限返回

3.2 价格计算逻辑

多规格商品价格获取流程：

调用商品详情接口获取price_range（价格区间）
用户选择 SKU 后，通过sku_id获取对应sku_price
结合促销活动计算final_price = sku_price - 优惠金额
前端实时展示最终价格与库存状态

四、库存字段解析：精准掌握商品库存状态

库存数据直接影响下单流程与用户体验，需区分总库存、SKU 库存、锁定库存等概念。

4.1 库存核心字段表

表格

字段名	数据类型	说明	业务意义
stock	Number	商品总库存	全规格库存总和
quantity	Number	SKU 库存	单规格可用库存
lock_stock	Number	锁定库存（已下单未付款）	防止超卖，需申请权限获取
available_stock	Number	可用库存 = stock - lock_stock	实际可售数量
inventory_type	String	库存类型	"1"（普通库存）、"2"（预售库存）

4.2 库存同步策略

实时查询：用户下单前调用 SKU 接口获取最新库存
缓存优化：非实时场景可缓存库存数据，设置 5-15 分钟过期时间
库存预警：当 SKU 库存低于阈值（如 10）时触发补货提醒

五、实战代码：Python 调用示例

以下是完整的 Python 代码，实现淘宝商品详情接口调用、签名生成、数据解析全流程。

5.1 环境准备

pip install requests

5.2 完整代码实现

import requestsimport timeimport hashlibimport urllib.parseclass TaobaoItemAPI:    def __init__(self, app_key, app_secret):
        self.app_key = app_key
        self.app_secret = app_secret
        self.api_url = "https://eco.taobao.com/router/rest"
    
    def generate_sign(self, params):        """生成签名：按ASCII排序后加密"""
        # 1. 排序参数
        sorted_params = sorted(params.items(), key=lambda x: x[0])        # 2. 拼接字符串
        sign_str = self.app_secret + \                   "&".join([f"{key}{value}" for key, value in sorted_params]) + \
                   self.app_secret        # 3. MD5加密并转大写
        sign = hashlib.md5(sign_str.encode()).hexdigest().upper()        return sign    
    def get_item_detail(self, num_iid, fields="num_iid,title,price,skus,stock"):        """调用商品详情接口"""
        params = {            "method": "taobao.item.get",            "app_key": self.app_key,            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),            "format": "json",            "v": "2.0",            "sign_method": "md5",            "num_iid": num_iid,            "fields": fields
        }        
        # 生成签名
        params["sign"] = self.generate_sign(params)        
        # 发送请求
        response = requests.get(self.api_url, params=params, timeout=10)
        result = response.json()        
        if "error_response" in result:            raise Exception(f"API调用失败: {result['error_response']['msg']}")        
        return result["item_get_response"]["item"]    
    def get_sku_detail(self, num_iid, sku_id):        """调用SKU详情接口"""
        params = {            "method": "taobao.item.sku.get",            "app_key": self.app_key,            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),            "format": "json",            "v": "2.0",            "sign_method": "md5",            "num_iid": num_iid,            "sku_id": sku_id,            "fields": "sku_id,properties,props_name,sku_price,quantity"
        }
        
        params["sign"] = self.generate_sign(params)
        response = requests.get(self.api_url, params=params, timeout=10)
        result = response.json()        
        if "error_response" in result:            raise Exception(f"SKU调用失败: {result['error_response']['msg']}")        
        return result["item_sku_get_response"]["sku"]# 示例使用if __name__ == "__main__":
    APP_KEY = "你的AppKey"
    APP_SECRET = "你的AppSecret"
    ITEM_ID = "商品ID"
    SKU_ID = "SKU_ID"
    
    api = TaobaoItemAPI(APP_KEY, APP_SECRET)    
    # 获取商品详情
    item_detail = api.get_item_detail(ITEM_ID)    print("商品标题:", item_detail["title"])    print("商品价格:", item_detail["price"])    print("商品总库存:", item_detail["stock"])    
    # 解析SKU列表
    skus = item_detail.get("skus", {}).get("sku", [])    for sku in skus:        print(f"\nSKU ID: {sku['sku_id']}")        print(f"属性: {sku['props_name']}")        print(f"价格: {sku['sku_price']}")        print(f"库存: {sku['quantity']}")    
    # 获取单个SKU详情
    sku_detail = api.get_sku_detail(ITEM_ID, SKU_ID)    print("\n单个SKU详情:", sku_detail)

五、常见问题与避坑指南

5.1 签名错误（最常见问题）

解决方案：

严格按 ASCII 码排序所有参数（含公共参数和业务参数）
确保参数值 URL 编码正确（特殊字符如 &、= 需转义）
首尾拼接 AppSecret，加密后转大写
时间戳格式必须为 "YYYY-MM-DD HH:MM:SS"，与淘宝服务器时间误差不超过 5 分钟

5.2 SKU 价格与库存不匹配

原因分析：

商品正在参加促销活动，价格实时变动
库存同步延迟，建议调用 SKU 详情接口获取最新数据
部分商品设置了地区限售，导致库存显示异常

解决方案：

优先调用 taobao.item.sku.get 获取 SKU 实时数据
增加重试机制，处理网络延迟与接口超时
结合商品状态判断（如是否上架、是否限售）

5.3 字段缺失问题

解决方案：

在fields参数中明确指定需要的字段（如 "skus,stock,price"）
检查接口权限，部分字段（如 lock_stock）需申请额外权限
多规格商品需通过 SKU 接口获取完整的价格和库存数据

六、总结与最佳实践

6.1 核心总结

接口选择：商品列表页用 taobao.item.get 获取基础信息，商品详情页用 taobao.item.sku.get 获取 SKU 详情
字段优先级：SKU 商品优先使用 sku_price 和 quantity，非 SKU 商品使用 price 和 stock
数据安全：AppSecret 严禁泄露，建议存储在环境变量或加密配置文件中
合规性：遵守淘宝开放平台规则，合理控制调用频率，避免触发风控机制

6.2 最佳实践

字段按需获取：在fields参数中只指定需要的字段，减少数据传输量与解析成本
缓存策略：对商品基础信息设置 5-15 分钟缓存，SKU 库存数据实时获取
异常处理：增加接口调用重试机制，处理网络错误、超时、签名错误等异常情况
监控告警：对接口调用成功率、响应时间设置监控，及时发现问题