一、接口总览
淘宝天猫核心商用两大接口:
关键词搜索商品:
taobao.item.search
按关键词、类目、价格、销量分页搜商品,返回商品列表基础信息商品详情查询:
taobao.item.get
根据商品 ID,获取标题、价格、SKU、参数、主图、销量、一件代发、精选货源等全量详情
二、商品详情API接口使用方法
商品详情API接口允许开发者通过调用API的方式,获取商品的详细信息,如标题、价格、图片、描述等。以下是具体的使用步骤:
构建HTTP请求:根据API文档构建HTTP请求,通常包括请求URL、请求方法(GET或POST)、必要的请求头和查询参数。查询参数中需要包含AppKey、AppSecret以及商品ID等。
发送请求并处理响应:使用HTTP客户端库(如Python的requests库)发送请求,并处理返回的JSON数据。返回的数据通常包含商品的详细信息。
以下是一个使用Python获取商品详情的示例代码:
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
# 配置参数 API_URL = "o0b.cn/ibrad"
url = "https://api-gw.cn/taobao/item_review/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=736096815126&data=&page=1&version=1"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)三. 核心返回字段
标题、上下架状态、一口价、市场价、销量、SKU 规格列表、商品详情图、品牌、材质参数、发货地、售后保障、活动价标签
四、报错说明 & 避坑指南
Invalid method 不合法 ApiName
taobao.item.search是老版名称,现在开放平台已下线需改用官方新版搜索接口或使用第三方聚合封装接口
Invalid app Key
app_key /app_secret 错误、未创建应用、应用未审核通过
个人开发者很多高级接口无权限,必须企业认证
常见字段解释(你常用的)
one_psale: true→ 支持一件代发is_jxhy: false→ 非精选货源普通商品
五、适配业务说明
可直接支持:
淘宝 / 天猫 关键词批量搜货
单商品全量详情抓取
同步价格、销量、主图、SKU、一件代发标签
对接代购、代采、跨境独立站、ERP 铺货系统
六、总结
淘宝/天猫的商品API接口为电商数据采集提供了官方合规的通道。开发者通过完成账号注册、权限申请、签名实现即可快速接入。taobao.items.search适用于关键词搜索选品,taobao.item.get适用于商品详情同步与价格监控。在实际应用中,建议结合本地缓存和分页循环策略,在遵守平台频率限制的前提下实现高效稳定的数据采集。
