获取淘宝商品详情数据API对接完全指南

admin4周前 (10-10)淘宝API74

本文提供淘宝商品详情数据的完整API对接方案，包含商品标题、价格、详情、主图、店铺等信息。

1、获取商品价格详情API：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版本

请求参数

请求参数：num_iid=652874751412&is_promotion=1

参数说明：num_iid:淘宝商品ID
is_promotion:是否获取取促销价

响应参数

名称	类型	必须	示例值	描述
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
crumbs	Mix	0	[]	导航菜单
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[]	商品图片
item_weight	String	0
item_size	String	0
location	String	0		发货地
express_fee	Float	0	0.00	快递费用
ems_fee	Float	0		EMS费用
post_fee	Float	0		物流费用
shipping_to	String	0		发货至
has_discount	Boolean	0	false	是否有优惠
video	video[]	0		商品视频
is_virtual	String	0
is_promotion	Boolean	0	false	是否促销
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	[]

2、item_video-获得淘宝商品视频

请求参数

请求参数：num_iid=906637149849

参数说明：num_iid:淘宝商品ID

响应参数

Version: Date:2025-06-17

名称	类型	必须	示例值	描述
item	item[]	1		宝贝视频数据【仅保障视频参数】
num_iid	Bigint	1	906637149849	宝贝ID
title	String	0	【爆款推荐】巨好看！软底人字拖
detail_url	String	1	http://item.taobao.com/item.htm?id=906637149849	宝贝链接
price	Float	0	45.9	价格
orginal_price	String	0	45.9	原价
num	Int	0	3836	库存
pic_url	String	0	http://img.alicdn.com/imgextra/i1/181441304/O1CN01nh2zTN1LVHVzbBH9w_!!181441304.jpg	宝贝图片
brand	String	0	南在南方	品牌名称
cid	Int	0	201276457
props	Mix	0	[{ "name": "产地","value": "中国" }]	商品属性
item_imgs	Mix	0	item_imgs[]	商品图片
video	String	1	http://cloud.video.taobao.com/play/u/181441304/p/2/e/6/t/1/514242949225.mp4?appKey=38829	商品视频
seller_id	Int	0	181441304	卖家ID

响应示例

{    "item": {        "num_iid": "906637149849",        "title": "【爆款推荐】巨好看！软底人字拖",        "detail_url": "http://item.taobao.com/item.htm?id=906637149849",        "pic_url": "http://img.alicdn.com/imgextra/i1/181441304/O1CN01nh2zTN1LVHVzbBH9w_!!181441304.jpg",        "price": "45.9",        "orginal_price": 45.9,        "cid": 201276457,        "item_imgs": [
            {                "url": "http://img.alicdn.com/imgextra/i1/181441304/O1CN01nh2zTN1LVHVzbBH9w_!!181441304.jpg"
            }
        ],        "brand": "南在南方",        "props": [
            {                "name": "品牌",                "value": "南在南方"
            },
            {                "name": "风格",                "value": "休闲"
            },
            {                "name": "里料材质",                "value": "PU"
            },
            {                "name": "尺码",                "value": "35,40,37,36,38,39"
            },
            {                "name": "销售渠道类型",                "value": "纯电商(只在线上销售)"
            },
            {                "name": "适用对象",                "value": "青年"
            },
            {                "name": "适合场合",                "value": "日常"
            },
            {                "name": "帮面材质",                "value": "PU"
            },
            {                "name": "鞋制作工艺",                "value": "胶粘鞋"
            },
            {                "name": "后跟高",                "value": "中跟(3-5cm)"
            },
            {                "name": "上市年份季节",                "value": "2025年夏季"
            },
            {                "name": "产地",                "value": "中国"
            },
            {                "name": "鞋垫材质",                "value": "PU"
            },
            {                "name": "跟底款式",                "value": "平底"
            },
            {                "name": "图案",                "value": "纯色"
            },
            {                "name": "鞋底材质",                "value": "橡胶"
            },
            {                "name": "鞋靴闭合方式",                "value": "一脚蹬"
            },
            {                "name": "颜色分类",                "value": "银色,紫色,黑色,紫色升级版,黑色升级版,米色升级版,银色升级版,米色"
            }
        ],        "num": "200",        "seller_id": "181441304",        "video": {            "url": "http://cloud.video.taobao.com/play/u/181441304/p/2/e/6/t/1/514242949225.mp4?appKey=38829"
        }
    },
}

返回列表

上一篇：淘宝开放平台（TOP）API 入门教程：从原理到实战（附代码示例）

下一篇：电商选品新逻辑：基于淘宝评论 API 的用户需求挖掘与爆款特征预测模型