一、API接口实战
1、取商品链接中的商品id,即在id=后面的那串数字904667085507,这是商品的唯一标识。
2、将商品id传入获取商品详情接口item_get中,拿到商品详情信息。
curl
https://api-seaver.cn/taobao/item_get_pro/?key=your_api_key&
&num_iid=904667085507&cache=no&&lang=zh-CN&secret=your_secret
3、接收API返回数据,响应数据。
"item": {
"num_iid": "904667085507",
"title": "JKJS【花信风】人丝交织提花 短袖t恤女2025新款新中式上衣夏",
"desc_short": "",
"price": "299",
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "299",
"nick": "JKJS新国风女装",
"num": "360",
"min_num": 0,
"detail_url": "https://item.taobao.com/item.htm?id=904667085507",
"pic_url": "https://img.alicdn.com/bao/uploaded/i3/75866652/O1CN013NGKde1z0fgmsiGyx_!!75866652.jpg",
"brand": "JK&JS",
"brandId": "",
"rootCatId": "",
"cid": "50000671",
"crumbs": [],
"created_time": "",
"modified_time": "",
"delist_time": "",
"desc": "<div><img src=\"https://img.alicdn.com/imgextra/i2/75866652/O1CN01rGXUBk1z0ffu2jAOn_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i2/75866652/O1CN01twVly71z0ffquAgOS_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i1/75866652/O1CN017rU4dP1z0ffqIrQWC_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i2/75866652/O1CN012yWld21z0fgEBe9QY_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i4/75866652/O1CN01joDGvV1z0ffu2kJ56_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i3/75866652/O1CN01JvuEnT1z0ffqIobsO_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i2/75866652/O1CN01lxSUgx1z0ffuQpiRE_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i2/75866652/O1CN01kOT79n1z0ffsKfzoM_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i4/75866652/O1CN01JySahN1z0ffr0zMWt_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i2/75866652/O1CN017B68KM1z0fftVlS8s_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i2/75866652/O1CN01J3F80N1z0ffsAS3K9_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i4/75866652/O1CN01kCeQpz1z0ffqIp0r5_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i4/75866652/O1CN01qjnHr41z0ffsibsQz_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i1/75866652/O1CN01zFQCex1z0fftVkNe0_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i4/75866652/O1CN01Sm0CVE1z0fftYQGtE_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i4/75866652/O1CN01D9sNZ21z0ffs9DqAk_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i1/75866652/O1CN018moigP1z0ffqIpgVe_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i1/75866652/O1CN014hAklK1z0fftYPGbE_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i4/75866652/O1CN01gvaHkn1z0ffqIs25t_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i3/75866652/O1CN01Lt6Ywz1z0ffsidDfe_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i2/75866652/O1CN01Kho9i11z0ffu2lz9l_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i4/75866652/O1CN01b9iQjN1z0ffu2m7TX_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i2/75866652/O1CN01Cd9jwH1z0ffqIslpQ_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i4/75866652/O1CN01JWF5681z0ffu2kJEi_!!75866652.jpg\"></div><div><img src=\"https://img.alicdn.com/imgextra/i4/75866652/O1CN01Qq8e0G1z0ffqIpt2Q_!!75866652.jpg\"></div>",
"desc_img": [
"https://img.alicdn.com/imgextra/i2/75866652/O1CN01rGXUBk1z0ffu2jAOn_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i2/75866652/O1CN01twVly71z0ffquAgOS_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i1/75866652/O1CN017rU4dP1z0ffqIrQWC_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i2/75866652/O1CN012yWld21z0fgEBe9QY_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i4/75866652/O1CN01joDGvV1z0ffu2kJ56_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i3/75866652/O1CN01JvuEnT1z0ffqIobsO_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i2/75866652/O1CN01lxSUgx1z0ffuQpiRE_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i2/75866652/O1CN01kOT79n1z0ffsKfzoM_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i4/75866652/O1CN01JySahN1z0ffr0zMWt_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i2/75866652/O1CN017B68KM1z0fftVlS8s_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i2/75866652/O1CN01J3F80N1z0ffsAS3K9_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i4/75866652/O1CN01kCeQpz1z0ffqIp0r5_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i4/75866652/O1CN01qjnHr41z0ffsibsQz_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i1/75866652/O1CN01zFQCex1z0fftVkNe0_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i4/75866652/O1CN01Sm0CVE1z0fftYQGtE_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i4/75866652/O1CN01D9sNZ21z0ffs9DqAk_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i1/75866652/O1CN018moigP1z0ffqIpgVe_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i1/75866652/O1CN014hAklK1z0fftYPGbE_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i4/75866652/O1CN01gvaHkn1z0ffqIs25t_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i3/75866652/O1CN01Lt6Ywz1z0ffsidDfe_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i2/75866652/O1CN01Kho9i11z0ffu2lz9l_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i4/75866652/O1CN01b9iQjN1z0ffu2m7TX_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i2/75866652/O1CN01Cd9jwH1z0ffqIslpQ_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i4/75866652/O1CN01JWF5681z0ffu2kJEi_!!75866652.jpg",
"https://img.alicdn.com/imgextra/i4/75866652/O1CN01Qq8e0G1z0ffqIpt2Q_!!75866652.jpg"
],
"item_imgs": [
{
"url": "https://img.alicdn.com/bao/uploaded/i3/75866652/O1CN013NGKde1z0fgmsiGyx_!!75866652.jpg"
},
{
"url": "https://img.alicdn.com/bao/uploaded/i1/75866652/O1CN01io6qMI1z0ffsiXqly_!!75866652.jpg"
},
{
"url": "https://img.alicdn.com/bao/uploaded/i2/75866652/O1CN01wokmZu1z0ffsAPu7a_!!75866652.jpg"
},
{
"url": "https://img.alicdn.com/bao/uploaded/i2/75866652/O1CN01e29FuS1z0ffs9BcnQ_!!75866652.jpg"
},
{
"url": "https://img.alicdn.com/bao/uploaded/i3/75866652/O1CN01Doe0I31z0fgDKwEUp_!!75866652.jpg"
}
],
"item_weight": "",
"item_size": "",
"location": "浙江杭州",
"post_fee": "0.00",
"express_fee": "0.00",
"ems_fee": "",
"shipping_to": "",
"has_discount": "",
"video": {
"url": "https://cloud.video.taobao.com/play/u/75866652/p/2/e/6/t/1/513862786003.mp4?appKey=38829"
},
"is_virtual": "",
"sample_id": "",
"is_promotion": "false",
"props_name": "20509:28314:尺码:S;1627207:4104877:主要颜色:浅紫色 T恤;20509:28315:尺码:M;1627207:4104877:主要颜色:浅紫色 T恤;20509:28316:尺码:L;1627207:4104877:主要颜色:浅紫色 T恤;20509:28317:尺码:XL;1627207:4104877:主要颜色:浅紫色 T恤;20509:28314:尺码:S;1627207:445152355:主要颜色:浅紫色. 半身裙;20509:28315:尺码:M;1627207:445152355:主要颜色:浅紫色. 半身裙;20509:28316:尺码:L;1627207:445152355:主要颜色:浅紫色. 半身裙;20509:28317:尺码:XL;1627207:445152355:主要颜色:浅紫色. 半身裙",
"prop_imgs": {
"prop_img": [
{
"properties": "1627207:4104877",
"url": "//img.alicdn.com/bao/uploaded/i2/75866652/O1CN016jsyxL1z0fgDLUCm8_!!75866652.jpg"
},
{
"properties": "1627207:445152355",
"url": "//img.alicdn.com/bao/uploaded/i4/75866652/O1CN01A88lR31z0fgCQSHhD_!!75866652.jpg"
}
]
},
"property_alias": "509:28314:尺码:S;1627207:4104877:主要颜色:浅紫色 T恤;20509:28315:尺码:M;1627207:4104877:主要颜色:浅紫色 T恤;20509:28316:尺码:L;1627207:4104877:主要颜色:浅紫色 T恤;20509:28317:尺码:XL;1627207:4104877:主要颜色:浅紫色 T恤;20509:28314:尺码:S;1627207:445152355:主要颜色:浅紫色. 半身裙;20509:28315:尺码:M;1627207:445152355:主要颜色:浅紫色. 半身裙;20509:28316:尺码:L;1627207:445152355:主要颜色:浅紫色. 半身裙;20509:28317:尺码:XL;1627207:445152355:主要颜色:浅紫色. 半身裙",
"props": [
{
"name": "品牌",
"value": "JK&JS"
},
{
"name": "流行元素",
"value": "刺绣/绣花"
},
{
"name": "风格",
"value": "通勤"
},
{
"name": "通勤",
"value": "简约"
},
{
"name": "服装版型",
"value": "宽松型"
},
{
"name": "吊牌价",
"value": "799元"
},
{
"name": "图案文化",
"value": "花卉"
},
{
"name": "袖型",
"value": "短袖"
},
{
"name": "是否连帽",
"value": "不连帽"
},
{
"name": "材质成分",
"value": "聚酯纤维51.3% 粘胶纤维(粘纤)43.9% 聚酰胺纤维(锦纶)4.8%"
},
{
"name": "面料工艺",
"value": "刺绣"
},
{
"name": "货号",
"value": "JKP5025903"
},
{
"name": "适用年龄",
"value": "18-35岁"
},
{
"name": "适用季节",
"value": "春季"
},
{
"name": "产地",
"value": "中国"
},
{
"name": "厚薄",
"value": "常规"
},
{
"name": "上市年份季节",
"value": "2025年春季"
},
{
"name": "袖长",
"value": "无袖"
},
{
"name": "领型",
"value": "立领"
},
{
"name": "衣长",
"value": "常规款"
},
{
"name": "图案",
"value": "植物花卉"
},
{
"name": "尺码",
"value": "S, M, L, XL"
},
{
"name": "主要颜色",
"value": "浅紫色, 浅紫色."
}
],
"total_sold": 0,
"skus": {
"sku": [
{
"price": "299",
"total_price": 0,
"orginal_price": "299",
"properties": "20509:28314;1627207:4104877",
"properties_name": "20509:28314:尺码:S;1627207:4104877:主要颜色:浅紫色 T恤",
"quantity": "50",
"sku_id": "5762938020117"
},
{
"price": "299",
"total_price": 0,
"orginal_price": "299",
"properties": "20509:28315;1627207:4104877",
"properties_name": "20509:28315:尺码:M;1627207:4104877:主要颜色:浅紫色 T恤",
"quantity": "30",
"sku_id": "5762938020118"
},
{
"price": "299",
"total_price": 0,
"orginal_price": "299",
"properties": "20509:28316;1627207:4104877",
"properties_name": "20509:28316:尺码:L;1627207:4104877:主要颜色:浅紫色 T恤",
"quantity": "50",
"sku_id": "5762938020119"
},
{
"price": "299",
"total_price": 0,
"orginal_price": "299",
"properties": "20509:28317;1627207:4104877",
"properties_name": "20509:28317:尺码:XL;1627207:4104877:主要颜色:浅紫色 T恤",
"quantity": "60",
"sku_id": "5762938020120"
},
{
"price": "329",
"total_price": 0,
"orginal_price": "329",
"properties": "20509:28314;1627207:445152355",
"properties_name": "20509:28314:尺码:S;1627207:445152355:主要颜色:浅紫色. 半身裙",
"quantity": "40",
"sku_id": "5780221576048"
},
{
"price": "329",
"total_price": 0,
"orginal_price": "329",
"properties": "20509:28315;1627207:445152355",
"properties_name": "20509:28315:尺码:M;1627207:445152355:主要颜色:浅紫色. 半身裙",
"quantity": "30",
"sku_id": "5780221576049"
},
{
"price": "329",
"total_price": 0,
"orginal_price": "329",
"properties": "20509:28316;1627207:445152355",
"properties_name": "20509:28316:尺码:L;1627207:445152355:主要颜色:浅紫色. 半身裙",
"quantity": "50",
"sku_id": "5780221576050"
},
{
"price": "329",
"total_price": 0,
"orginal_price": "329",
"properties": "20509:28317;1627207:445152355",
"properties_name": "20509:28317:尺码:XL;1627207:445152355:主要颜色:浅紫色. 半身裙",
"quantity": "50",
"sku_id": "5780221576051"
}
]
},
"seller_id": "75866652",
"sales": 0,
"shop_id": "59284714",
"props_list": {
"20509:28314": "尺码:S",
"1627207:4104877": "主要颜色:浅紫色 T恤",
"20509:28315": "尺码:M",
"20509:28316": "尺码:L",
"20509:28317": "尺码:XL",
"1627207:445152355": "主要颜色:浅紫色. 半身裙"
},
"seller_info": {
"nick": "JKJS新国风女装",
"sid": "59284714",
"title": "JKJS新国风女装",
"zhuy": "https://shop59284714.taobao.com/",
"shop_name": "JKJS新国风女装"
},
"tmall": false,
"error": "",
"warning": "",
"url_log": [],
"fav_count": "",
"fans_count": "",
"freight": "",
"_ddf": "gab",
"props_img": {
"1627207:4104877": "//img.alicdn.com/bao/uploaded/i2/75866652/O1CN016jsyxL1z0fgDLUCm8_!!75866652.jpg",
"1627207:445152355": "//img.alicdn.com/bao/uploaded/i4/75866652/O1CN01A88lR31z0fgCQSHhD_!!75866652.jpg"
}
},
"secache": "8f434cb9ff23fd421d1c3847097a2b7c",
"secache_time": 1750054200,
"secache_date": "2025-06-16 14:10:00",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
二、接口技术规范与数据格式
淘宝商品详情 API 采用 RESTful 架构风格,以 HTTP 协议作为通信基础。开发者通过发送 GET 或 POST 请求到指定的 API 端点,获取商品数据。请求参数需按照平台规定的格式进行设置,常见参数包括商品 ID(必要参数,用于指定要获取详情的商品)、fields(指定返回的数据字段,可按需筛选,如 “title,price,sales”)、timestamp(请求时间戳,用于防止请求被重放攻击)等。
在数据返回格式上,淘宝商品详情 API 支持 JSON 和 XML 两种主流格式,开发者可在请求参数中通过 “format” 字段进行指定,默认返回 JSON 格式。JSON 格式数据结构清晰、轻量级,便于在各种编程语言中解析。例如,一个典型的商品价格和名称信息的 JSON 返回数据如下:
TypeScript
取消自动换行复制
{
"item": {
"title": "时尚纯棉短袖T恤",
"price": "99.00"
},
"code": 0,
"msg": "success"
}
三、接口调用实战(以 Python 为例)
以 Python 语言为例,借助requests库进行淘宝商品详情 API 的调用,具体代码如下:
TypeScript
取消自动换行复制
import requests
import hashlib
import time
# 替换为自己的AppKey和AppSecret
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
url = "https://api.taobao.com/router/rest"
# 商品ID
item_id = "1234567890"
params = {
"method": "taobao.item.get",
"app_key": app_key,
"item_id": item_id,
"fields": "title,price,sales",
"timestamp": time.strftime('%Y-%m-%d %H:%M:%S', time.localtime()),
"format": "json",
"v": "2.0"
}
# 生成签名
params = sorted(params.items(), key=lambda d: d[0], reverse=False)
query = ""
for key, value in params:
query += key + str(value)
string_to_sign = app_secret + query + app_secret
sign = hashlib.md5(string_to_sign.encode()).hexdigest().upper()
params.append(("sign", sign))
# 发送请求
response = requests.post(url, data=params)
print(response.json())
上述代码中,首先设置了必要的参数,包括 AppKey、商品 ID 等;接着按照平台规定的签名规则,对请求参数进行排序、拼接并生成 MD5 签名;最后通过requests库发送 POST 请求,获取并打印接口返回的商品数据。
四、常见问题与解决方案
- 签名错误:签名是接口调用身份验证的关键,若出现签名错误,需检查参数顺序是否正确、时间戳是否有效、AppSecret 是否填写正确。可使用平台提供的签名调试工具,对比生成的签名与平台预期签名的差异。
- 频率限制:为防止恶意调用,淘宝对 API 接口设置了调用频率限制。若超过限制,会返回错误码。开发者可通过优化代码,合并同类请求,减少不必要的调用;也可根据业务需求,申请更高的调用频率权限。
- 数据缺失:若返回数据中缺少部分字段,需检查请求参数中 “fields” 字段是否正确设置,是否涵盖所需数据字段;同时,确认该字段是否在接口权限范围内。
淘宝商品详情 API 接口为开发者提供了高效获取商品数据的途径,通过熟悉申请流程、掌握技术规范、实践接口调用以及解决常见问题,开发者能够充分发挥该接口的价值,为电商数据应用开发提供坚实的数据支持。