一、官方标准商品详情接口(最核心)
1. taobao.item.get(通用商品详情)
接口标识:
taobao.item.get适用:淘宝 / 天猫商品,商家 / 开发者自用,获取完整商品详情
核心能力:
基础信息:
num_iid、title、price、pic_url、volume、locationSKU 全量:
skus(含sku_id、price、stock、properties_name)详情内容:
desc(商品描述)、detail_url、视频、属性店铺信息:
nick、seller_id、店铺评分必填参数:
num_iid:商品 ID(从链接提取)fields:指定返回字段(如num_iid,title,price,skus,pic_url)优势:数据最全、官方权威、稳定性最高
适用场景:商品同步、详情页搭建、价格 / 库存监控、SKU 分析
2. taobao.item.sku.get(仅获取 SKU 详情)
接口标识:
taobao.item.sku.get适用:只需要SKU 规格、价格、库存,不需要商品主信息
核心参数:
num_iid、sku_id(可选,查单个 SKU)优势:轻量、速度快、流量消耗小
场景:SKU 价格监控、库存预警、规格对比
二、淘宝客(联盟)专用详情接口(推广 / 返利场景)
1. taobao.tbk.item.info.get(淘宝客商品详情)
接口标识:
taobao.tbk.item.info.get适用:淘宝客 / 返利 / 导购平台,获取带佣金、优惠券的商品信息
核心能力:
基础详情:标题、价格、主图、销量
推广信息:
commission_rate(佣金率)、coupon_info(优惠券)、tk_total_sales(淘客销量)推广链接:
click_url(淘客跳转链接)核心参数:
num_iids(支持多 ID 逗号分隔,批量查询)优势:专为推广设计、自带佣金 / 优惠券、支持批量
场景:导购 APP、返利网站、选品工具、推广链接生成
2. taobao.tbk.item.details.get(淘宝客商品详情增强版)
接口标识:
taobao.tbk.item.details.get适用:需要更丰富淘客维度(如邮费、属性图、活动标签)
额外字段:
real_post_fee(邮费)、property_image_list(属性图)、promotion_type(活动类型)场景:精细化选品、价格 + 邮费 + 佣金综合比价
三、批量 / 补充 / 搜索类接口(配套使用)
1. taobao.items.list.get(批量获取商品列表)
接口标识:
taobao.items.list.get适用:按店铺 / 类目 / 时间批量拉取商品基础信息
参数:
seller_nicks(店铺昵称)、cid(类目 ID)、page_no/page_size场景:店铺商品全量同步、类目商品监控、店铺数据采集
2. taobao.item.search(商品搜索 + 详情)
接口标识:
taobao.item.search适用:关键词搜索商品,并获取搜索结果中的商品基础详情
参数:
q(关键词)、page_no、page_size、fields返回:
num_iid、title、price、pic_url、volume、provcity场景:关键词选品、竞品分析、市场调研
四、接口对比与选型建议(快速决策)
| 接口 | 身份要求 | 数据范围 | 核心优势 | 最佳场景 |
|---|---|---|---|---|
| taobao.item.get | 普通开发者 / 商家 | 最全(含 SKU / 详情 / 店铺) | 权威、完整 | 商品详情页、数据同步、SKU 监控 |
| taobao.tbk.item.info.get | 淘宝客联盟 | 基础 + 佣金 + 优惠券 | 推广友好、批量 | 导购、返利、淘客选品 |
| taobao.item.sku.get | 普通开发者 | 仅 SKU | 轻量、高效 | SKU 价格 / 库存监控 |
| taobao.item.search | 普通开发者 | 搜索结果 + 基础详情 | 关键词检索 | 选品、竞品、市场分析 |
五、调用与返回要点(避坑)
- 公共参数(所有接口必须)
method:接口名(如taobao.item.get)app_key/app_secret:开放平台应用凭证timestamp:时间戳(YYYY-MM-DD HH:MM:SS)sign:MD5 签名(参数按 ASCII 排序后加密)format:json(推荐)v:2.0- 标准成功返回结构
{
"item_get_response": { // 接口名+_response
"item": { /* 商品详情数据 */ },
"request_id": "xxx"
}}错误返回(必须处理)
{
"error_response": {
"code": 10001,
"msg": "Invalid signature",
"sub_code": "isv.sign-invalid"
}}六、下一步
taobao.item.get或taobao.tbk.item.info.get),给你写一套可直接运行的 Python 调用 + 解析 + 保存到 Excel的完整代码吗?