淘宝商品详情接口是阿里巴巴集团淘宝平台为开发者及商家提供的一项强大而灵活的数据服务接口。该接口旨在帮助第三方应用、电商平台、数据分析公司等合作伙伴高效、准确地获取淘宝商品的详细信息,从而丰富其平台内容、提升用户体验、优化商品推荐策略或进行市场趋势分析。
核心功能介绍:
-
商品基本信息获取:通过商品ID或特定查询条件,接口能够返回商品的标题、价格、库存、销量、评价数量、商品描述、主图及详情图等基本信息,帮助用户全面了解商品情况。
-
规格属性查询:支持查询商品的规格属性信息,如颜色、尺码、材质等,这对于需要展示商品多规格选项的电商平台尤为重要,能够提升用户选购的便捷性和满意度。
-
促销信息展示:接口还能返回商品的当前促销信息,如优惠券、满减活动、限时折扣等,帮助用户及时把握购物时机,享受更多优惠。
-
物流及售后服务:提供商品的发货地、运费模板、退换货政策等物流及售后服务信息,增强用户对商品购买的信心,促进交易达成。
-
用户评价及问答:接口支持获取商品的用户评价内容、评分及问答信息,这些信息对于潜在买家来说极具参考价值,有助于形成购买决策。
-
动态更新:淘宝商品详情接口支持实时或定时更新商品信息,确保合作伙伴获取的数据始终是最新的,减少因信息滞后导致的用户流失。
-
安全稳定:接口采用高可用性架构设计,确保数据传输的安全性和稳定性,同时提供详尽的API文档和技术支持,降低开发难度,提升接入效率。
通过淘宝商品详情接口,合作伙伴能够轻松实现与淘宝平台的无缝对接,快速构建或优化自身的商品展示、搜索、推荐等功能,为用户提供更加丰富、便捷、个性化的购物体验。
taobao.item_get
请求地址:https://api-gw.服务器.cn/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:是否获取取促销价
测试示例
响应示例
item: {
num_iid: "708162850148",
title: "儿童秋千室内家用免打孔室外单杠吊床摇篮感统户外帆布室外荡秋千",
desc_short: "",
price: "34.8",
total_price: "",
suggestive_price: "",
orginal_price: 37.2,
nick: "天天特卖工厂店",
num: "200",
detail_url: "https://item.taobao.com/item.htm?id=708162850148",
pic_url: "//img.alicdn.com/imgextra/i4/3937219703/O1CN01Bn9mP02LY1zuQJC1D_!!3937219703-0-C2M.jpg",
brand: "布洛赫",
brandId: "",
rootCatId: "",
cid: 50013905,
desc: "<img src="img.alicdn.com/imgextra/i3/O1CN01Eh4EuG1ODoyZvkltA_!!6000000001672-2-tps-1125-231.png"/><img src="img.alicdn.com/imgextra/i2/2215265496293/O1CN01v9hsIs1wMFG3K0jzT_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i4/2215265496293/O1CN01uKVBvA1wMFGDWNX7g_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i4/2215265496293/O1CN018js9Pf1wMFGAjUZsx_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i2/2215265496293/O1CN015UXL4T1wMFGA2jEcq_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i1/2215265496293/O1CN01gkpxDG1wMFG3K2Loy_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i2/2215265496293/O1CN01mdlT0n1wMFFxHVdoc_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i1/2215265496293/O1CN01AuEkMu1wMFGFNfbMV_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i1/2215265496293/O1CN010XWbHH1wMFG6DK4ST_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i3/2215265496293/O1CN01BCk3nw1wMFG9HxlO3_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i1/2215265496293/O1CN01Y79Ou21wMFGDWOfpX_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i2/2215265496293/O1CN01lSA9yS1wMFG1xq7Co_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i2/2215265496293/O1CN01ym2Gj51wMFG6AsPcn_!!2215265496293-0-scmitem176000.jpg"/><img src="img.alicdn.com/imgextra/i1/2215265496293/O1CN014JOSEw1wMFG85OLqt_!!2215265496293-0-scmitem176000.jpg"/>",
item_imgs: [
{
url: "//img.alicdn.com/imgextra/i4/3937219703/O1CN01Bn9mP02LY1zuQJC1D_!!3937219703-0-C2M.jpg"
},
{
url: "//img.alicdn.com/imgextra/i3/3937219703/O1CN01LMuok82LY1qRWubfR_!!3937219703.jpg"
},
{
url: "//img.alicdn.com/imgextra/i4/3937219703/O1CN0170AXgV2LY1qKDqH5J_!!3937219703.jpg"
},
{
url: "//img.alicdn.com/imgextra/i1/3937219703/O1CN01p7fLww2LY1qQSIhPy_!!3937219703.jpg"
},
{
url: "//img.alicdn.com/imgextra/i2/3937219703/O1CN01xxtxyE2LY1qI3OSND_!!3937219703.jpg"
}
],
item_weight: "",
post_fee: 0,
freight: "",
express_fee: "",
ems_fee: "",
shipping_to: "",
video: {
url: "https://cloud.video.taobao.com/play/u/3937219703/p/2/e/6/t/1/399249640294.mp4?appKey=38829"
},
sample_id: "",
props_name: "1627207:23736807642:颜色分类:蓝格加固秋千含配件套装【无室内单杠】;1627207:23736807643:颜色分类:黄格加固秋千含配件套装【无室内单杠】;1627207:23736807644:颜色分类:粉格加固秋千含配件套装【无室内单杠】;1627207:23736807645:颜色分类:蓝格加固秋千【无配件+无室内单杠】",
prop_imgs: {
prop_img: [
{
properties: "1627207:23736807642",
url: "http://img.alicdn.com/imgextra/i2/3937219703/O1CN01hX0NhL2LY1qPnWHRF_!!3937219703.jpg"
},
{
properties: "1627207:23736807643",
url: "http://img.alicdn.com/imgextra/i4/3937219703/O1CN01hQw7n32LY1qKcO0pA_!!3937219703.jpg"
},
{
properties: "1627207:23736807644",
url: "http://img.alicdn.com/imgextra/i2/3937219703/O1CN01BjWDSf2LY1qG0FXAQ_!!3937219703.jpg"
},
{
properties: "1627207:23736807645",
url: "http://img.alicdn.com/imgextra/i3/3937219703/O1CN01QsQ1fE2LY1qSPW88S_!!3937219703.jpg"
}
]
},
props_imgs: {
prop_img: [
{
properties: "1627207:23736807642",
url: "http://img.alicdn.com/imgextra/i2/3937219703/O1CN01hX0NhL2LY1qPnWHRF_!!3937219703.jpg"
},
{
properties: "1627207:23736807643",
url: "http://img.alicdn.com/imgextra/i4/3937219703/O1CN01hQw7n32LY1qKcO0pA_!!3937219703.jpg"
},
{
properties: "1627207:23736807644",
url: "http://img.alicdn.com/imgextra/i2/3937219703/O1CN01BjWDSf2LY1qG0FXAQ_!!3937219703.jpg"
},
{
properties: "1627207:23736807645",
url: "http://img.alicdn.com/imgextra/i3/3937219703/O1CN01QsQ1fE2LY1qSPW88S_!!3937219703.jpg"
}
]
},
property_alias: "",
props: [
{
name: "品牌",
value: "布洛赫"
},
{
name: "产地",
value: "中国"
},
{
name: "颜色分类",
value: "蓝格加固秋千含配件套装【无室内单杠】 黄格加固秋千含配件套装【无室内单杠】 粉格加固秋千含配件套装【无室内单杠】 蓝格加固秋千【无配件+无室内单杠】"
},
{
name: "吊牌价",
value: "99"
},
{
name: "上市时间",
value: "2023年春季"
},
{
name: "货号",
value: "BLH-4"
},
{
name: "运动户外项目",
value: "自驾游 野餐烧烤"
},
{
name: "是否商场同款",
value: "否"
},
{
name: "销售渠道类型",
value: "纯电商(只在线上销售)"
}
],
total_sold: "-1",
skus: {
sku: [
{
price: 34.8,
total_price: 0,
orginal_price: 52.2,
properties: "1627207:23736807642",
properties_name: "1627207:23736807642:颜色分类:蓝格加固秋千含配件套装【无室内单杠】",
quantity: 200,
sku_id: "5142393746932"
},
{
price: 34.8,
total_price: 0,
orginal_price: 52.2,
properties: "1627207:23736807643",
properties_name: "1627207:23736807643:颜色分类:黄格加固秋千含配件套装【无室内单杠】",
quantity: 200,
sku_id: "5142393746933"
},
{
price: 34.8,
total_price: 0,
orginal_price: 52.2,
properties: "1627207:23736807644",
properties_name: "1627207:23736807644:颜色分类:粉格加固秋千含配件套装【无室内单杠】",
quantity: 200,
sku_id: "5142393746934"
},
{
price: 34.8,
total_price: 0,
orginal_price: 37.2,
properties: "1627207:23736807645",
properties_name: "1627207:23736807645:颜色分类:蓝格加固秋千【无配件+无室内单杠】",
quantity: 200,
sku_id: "5142393746935"
}
]
},
seller_id: "3937219703",
sales: 100,
shop_id: "465965982",
props_list: {
1627207:23736807642: "颜色分类:蓝格加固秋千含配件套装【无室内单杠】",
1627207:23736807643: "颜色分类:黄格加固秋千含配件套装【无室内单杠】",
1627207:23736807644: "颜色分类:粉格加固秋千含配件套装【无室内单杠】",
1627207:23736807645: "颜色分类:蓝格加固秋千【无配件+无室内单杠】"
},
seller_info: {
nick: "天天特卖工厂店",
item_score: 4.67574,
score_p: 4.75174,
delivery_score: 4.77609,
shop_type: "",
user_num_id: "3937219703",
sid: null,
title: "",
zhuy: "https://shop465965982.taobao.com",
cert: null,
open_time: "",
credit_score: null,
shop_name: "天天特卖工厂店"
},
tmall: true,
error: "",
location: "安徽合肥",
data_from: "ha2",
ship_time: null,
props_img: {
1627207:23736807642: "http://img.alicdn.com/imgextra/i2/3937219703/O1CN01hX0NhL2LY1qPnWHRF_!!3937219703.jpg",
1627207:23736807643: "http://img.alicdn.com/imgextra/i4/3937219703/O1CN01hQw7n32LY1qKcO0pA_!!3937219703.jpg",
1627207:23736807644: "http://img.alicdn.com/imgextra/i2/3937219703/O1CN01BjWDSf2LY1qG0FXAQ_!!3937219703.jpg",
1627207:23736807645: "http://img.alicdn.com/imgextra/i3/3937219703/O1CN01QsQ1fE2LY1qSPW88S_!!3937219703.jpg"
},
desc_img: [
"img.alicdn.com/imgextra/i3/O1CN01Eh4EuG1ODoyZvkltA_!!6000000001672-2-tps-1125-231.png",
"img.alicdn.com/imgextra/i2/2215265496293/O1CN01v9hsIs1wMFG3K0jzT_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i4/2215265496293/O1CN01uKVBvA1wMFGDWNX7g_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i4/2215265496293/O1CN018js9Pf1wMFGAjUZsx_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i2/2215265496293/O1CN015UXL4T1wMFGA2jEcq_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i1/2215265496293/O1CN01gkpxDG1wMFG3K2Loy_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i2/2215265496293/O1CN01mdlT0n1wMFFxHVdoc_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i1/2215265496293/O1CN01AuEkMu1wMFGFNfbMV_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i1/2215265496293/O1CN010XWbHH1wMFG6DK4ST_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i3/2215265496293/O1CN01BCk3nw1wMFG9HxlO3_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i1/2215265496293/O1CN01Y79Ou21wMFGDWOfpX_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i2/2215265496293/O1CN01lSA9yS1wMFG1xq7Co_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i2/2215265496293/O1CN01ym2Gj51wMFG6AsPcn_!!2215265496293-0-scmitem176000.jpg",
"img.alicdn.com/imgextra/i1/2215265496293/O1CN014JOSEw1wMFG85OLqt_!!2215265496293-0-scmitem176000.jpg"
]
},
响应参数解析
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 | 价格(当商品价格为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 | [] |