淘宝/天猫获得淘宝商品详情 API 返回值说明
item_get-获得淘宝商品详情 API测试工具
taobao.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:是否获取取促销价
响应参数
Version: Date:2022-04-04
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
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 | 价格 |
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 | [] |
响应示例
php
items: {
page: "1",
real_total_results: "19346",
total_results: "19346",
page_size: 13,
pagecount: "200",
data_from: "cdy",
item: [
{
title: "新鲜苹果山西运城10斤装",
pic_url: "https://img.alicdn.com/imgextra/O1CN015isNYQ1ZJHaRItgjq_!!0-item_pic.jpg",
promotion_price: "13.80",
orginal_price: "13.80",
price: "13.80",
sales: 8,
num_iid: "597694921428",
detail_url: "https://item.taobao.com/item.htm?id=597694921428"
},
{
title: "御品一园阿克苏冰糖心苹果脆甜",
pic_url: "https://img.alicdn.com/imgextra/O1CN01Maezzk1ZJHdUEHJYf_!!0-item_pic.jpg",
promotion_price: "27.80",
orginal_price: "27.80",
price: "27.80",
sales: 0,
num_iid: "762533561619",
detail_url: "https://item.taobao.com/item.htm?id=762533561619"
},
{
title: "冰糖心苹果新鲜红富士山西",
pic_url: "https://img.alicdn.com/imgextra/O1CN01SZ2Tz21ZJHQpgY9xL_!!0-item_pic.jpg",
promotion_price: "18.80",
orginal_price: "18.80",
price: "18.80",
sales: 0,
num_iid: "656143609768",
detail_url: "https://item.taobao.com/item.htm?id=656143609768"
},
{
title: "精品大果!山西红富士苹果10斤装",
pic_url: "https://img.alicdn.com/imgextra/O1CN01FPqvWE21CEkPmu4Vq_!!0-item_pic.jpg",
promotion_price: "78.00",
orginal_price: "78.00",
price: "78.00",
sales: 24,
num_iid: "687749747444",
detail_url: "https://item.taobao.com/item.htm?id=687749747444"
},
{
title: "正宗烟台红富士苹果!精选大果",
pic_url: "https://img.alicdn.com/imgextra/O1CN01185K5m2IicFyZMMrM_!!0-item_pic.jpg",
promotion_price: "88.00",
orginal_price: "88.00",
price: "88.00",
sales: 35,
num_iid: "749196617923",
detail_url: "https://item.taobao.com/item.htm?id=749196617923"
},
{
title: "新鲜现摘甘肃天水花牛苹果",
pic_url: "https://img.alicdn.com/imgextra/O1CN01GaJFB41ywXmgHb9aa_!!0-item_pic.jpg",
promotion_price: "188.00",
orginal_price: "188.00",
price: "188.00",
sales: 0,
num_iid: "641695424052",
detail_url: "https://item.taobao.com/item.htm?id=641695424052"
},
{
title: "今年头茬红富士苹果超值大果",
pic_url: "https://img.alicdn.com/imgextra/O1CN01ofnHY42IicFzfUSf0_!!0-item_pic.jpg",
promotion_price: "88.00",
orginal_price: "88.00",
price: "88.00",
sales: 0,
num_iid: "731714740339",
detail_url: "https://item.taobao.com/item.htm?id=731714740339"
},
{
title: "【香脆甜】大凉山盐源丑苹果",
pic_url: "https://img.alicdn.com/imgextra/O1CN01gaMyEI1Tj2B9oRyCE_!!0-item_pic.jpg",
promotion_price: "49.90",
orginal_price: "49.90",
price: "49.90",
sales: 6,
num_iid: "743695971640",
detail_url: "https://item.taobao.com/item.htm?id=743695971640"
},
{
title: "冰糖心苹果丨很脆甜丨很好吃",
pic_url: "https://img.alicdn.com/imgextra/O1CN01MDg14q1j0dfCKApmW_!!2-item_pic.png",
promotion_price: "68.00",
orginal_price: "68.00",
price: "68.00",
sales: 6,
num_iid: "740246958099",
detail_url: "https://item.taobao.com/item.htm?id=740246958099"
},
{
title: "正宗洛川红富士苹果9斤",
pic_url: "https://img.alicdn.com/imgextra/O1CN01vWv0h22IicFBnmBnc_!!0-item_pic.jpg",
promotion_price: "88.00",
orginal_price: "88.00",
price: "88.00",
sales: 14,
num_iid: "742229720702",
detail_url: "https://item.taobao.com/item.htm?id=742229720702"
},
{
title: "【脆甜多汁】烟台红富士苹果",
pic_url: "https://img.alicdn.com/imgextra/O1CN01ErXPZQ1RkkS9nM9uF_!!0-item_pic.jpg",
promotion_price: "99.00",
orginal_price: "99.00",
price: "99.00",
sales: 10,
num_iid: "760201811558",
detail_url: "https://item.taobao.com/item.htm?id=760201811558"
},
{
title: "【正宗奶油富士】85#大果活动中",
pic_url: "https://img.alicdn.com/imgextra/O1CN01Wm69uh1RkkR5SQTnH_!!0-item_pic.jpg",
promotion_price: "88.00",
orginal_price: "88.00",
price: "88.00",
sales: 3,
num_iid: "747124302056",
detail_url: "https://item.taobao.com/item.htm?id=747124302056"
},
{
title: "高山红富士苹果脆甜多汁产地直发陕西正宗山地苹果带箱10斤整箱",
pic_url: "https://img.alicdn.com/imgextra/O1CN010UxkE52LY1wstKkQb_!!3937219703-0-C2M.jpg",
promotion_price: "10.05",
orginal_price: "10.05",
price: "10.05",
sales: 0,
num_iid: "765099133016",
detail_url: "https://item.taobao.com/item.htm?id=765099133016"
}
],
item_weight_update: 0
},
error_code: "0000",