当前位置：淘客联盟接口开发文档（旧版） > 淘宝商品详情页

淘宝天猫商品详情图文介绍和店铺信息API

在你的APP或公众号中，如果要调用淘宝天猫商品详情，最好的方式是通过你的客户端，用jsonp等方式调用H5接口，

如果你不方便使用H5接口，可以使用本站为您提供的商品详情接口，获取卖家店铺信息和产品图片介绍信息。用法如下：

淘宝天猫商品详情图片介绍+店铺信息API：

【调用权限】全能卡可调用

【频率限制】200次/分钟。若有调整请参考VIP群通告

【特别声明】产品详情接口是难度高的接口，即使花生日记、美逛等主流APP，都没有完美解决该问题，部分产品不一定有返回图文详情。并且为了稳定性，请所有调用本接口的会员，务必按需调用，对于乱用的会员以及倒卖的会员，我们有权停止其权限。

【强烈推荐】出于稳定性考虑，请在您的应用中使用缓存，不需要相同产品重复调用。

一、商品详情接口功能（店铺信息/产品介绍/主图视频/SKU）

1、获取商品详情图：即产品的详细介绍详情。
2、获取卖家店铺信息：包括：店铺shopID、店铺头像、卖家评分等等。
3、获取产品综合信息：最新评论、SKU、实时销量、评价关键字、分类和顶级分类等信息
4、获取淘宝/天猫商品主图视频信息

接口：

http://apipro.vephp.com/itemdetail?vekey=xxx&para=产品id&shoptype=B或C

参数：

para ：必须，需指定淘宝或天猫产品ID，比如 572920146516

shoptype : 必须，指定产品类型，可选值 B 代表是天猫产品，或 C代表淘宝集市产品，一般来源于高佣转链返回值中user_type或其它接口中指定的产品类型值。当你的详情页产品转链接口返回值中user_type值有两种情况，和shoptype对应关系分别是：

当user_type值为0表示是淘宝商品，对应shoptype=C；
如果user_type值为1表示天猫商城，则shoptype=B，

以下参数均为可选，默认0，可指定1。

onlytitle：可选（默认0，可指定1），只要产品标题，将只返回标题和产品主图，如果您不需要其它返回值，可直接使用本参数，效率高。

moreinfo ：可选，若指定为1，增加获取店铺信息（店铺LOGO，评分等）、SKU、销量、商品评价关键字。

needsku：可选，默认接口不返回SKU信息，如果你需要商品SKU，则传递本参数。

onlydetail：可选，只要产品详情介绍。这时指定本参数则 moreinfo参数和onlyglobalinfo参数失效。

onlyglobalinfo：可选，只要商品概要，指定本参数则 onlydetail失效。执行效率更高。启用本参数则同时moreinfo为真。

示例1：只想要店铺信息：传递moreinfo=1和onlyglobalinfo=1参数，配合使用高效调用：

http://apipro.vephp.com/itemdetail?vekey=xxx&para=573853907998&shoptype=B&moreinfo=1&onlyglobalinfo=1

示例2：只想要淘宝天猫产品详情，不想要其它店铺和评价等更多信息：

http://apipro.vephp.com/itemdetail?vekey=xxx&para=573853907998&shoptype=B&onlydetail=1

【如何高效使用详情接口】

在您的APP中，如果您一次性获取店铺介绍和产品图片详情介绍信息，信息量较大，可能稍微性能没有单次获取的快，

推荐做法：

1、先在您的APP详情页上方，展示主图、价格、优惠券，并先调用店铺信息，可以快速取得返回值，

在API中添加onlyglobalinfo参数，如下：

http://apipro.vephp.com/itemdetail?vekey=xxxx&para=产品ID&moreinfo=1&shoptype=B或C&onlyglobalinfo=1

2、在店铺信息下方，展示一条通栏，通栏文字“查看产品介绍”，这时有两种做法：方式一是按钮方式触发，也就是客人点了开始调用图片介绍详情。方式二是客户下拉到这里，APP自动调用。

通过以上两步，可以避免一次获取所有店铺和详情信息而可能导致的延迟。

二、详情接口返回值：

商品详情介绍接口返回值示例：

以下是一个商品详情接口返回值的字段含义说明：

以下字段内容是完整示例，实例使用中不一定全部返回，取决于您的参数。

关键字段是“item_detail”，是淘宝详情介绍图列表。同时，video是产品主图视频字段。

【特别说明】 item_detail 和 video 字段不一定有值，请做好程序的判断。

完整字段含义说明：

{
"error": "0", //不为0表示失败，0表示获取成功
"msg": "获取产品详情成功",
"debugCode": "10001" //维易内部调试码，无需理睬
"isHtml": 0, //反映item_detail字段是HTML还是JSON格式内容
"data": {
"title": "2019夏季新款女装修身显瘦温柔风裙子收腰气质中长碎花雪纺连衣裙",
"subtitle": "", //subtitle不一定有值，它一般是淘宝或天猫产品的副标题，通常是一些卖点说明，出现在淘宝/天猫的详情页标题下方位置，如“100%棉打底衫工厂直供收藏加购先发货”
"shoptype": "C", //店铺类型，B代表天猫商城，C代表淘宝集市
"categoryId": "50010850", //二级分类
"rootCategoryId": "16", //顶级分类
"images": [ //主图
"//img.alicdn.com/imgextra/i2/695924102/TB1EgWpEStYBeNjSspkXXbU8VXa_!!0-item_pic.jpg",
          ......
],
"baseinfo": [
{
"材质": "醋纤"
},......
],
"comment": {
"commenttotal": "163", //总评论数
"newcomment": [ //最新评论
{
"content": "上身效果超级赞，裙子垂感十足，大爱的衣衣，非常喜欢",
"userName": "w**9",
......
"isVip": "true"
}
],
"keywords": [] //如果有评论提炼关键字，则会反馈在这里，一般常见于天猫产品。
},
"shopProm": [],    //店铺促销
"sellCount": "15", //实时销量
"reserve_price": "888", //原价
"zk_final_price": "158", //折后价，即淘宝、天猫真实售价
"has_sku": "false", //是否有SKU，只有指定needsku参数，才会出现SKU
"express": { //运费，这里freeshipping不包含边远地区，比如新疆、西藏等，仅供参考
"from": "浙江杭州",
"postage": "快递: 免运费",
"freeshipping": "不包邮"
},
"seller": { //卖家信息
"userId": "695924102",
"shopId": "66293913",  //店铺ID
"shopName": "辰墨家",
"shopUrl": "tmall://page.tm/shop?item_id=573853907998&shopId=66293913",
"taoShopUrl": "//shop.m.taobao.com/shop/shop_index.htm?user_id=695924102&item_id=573853907998",
"shopIcon": "//img.alicdn.com/imgextra//15/63/TB1SCyOKCzqK1RjSZFjSuvlCFXa.jpg", //店铺头像
"fans": "2.7万", //店铺粉丝数
"certIcon": "//gw.alicdn.com/tfs/TB1zgzmlZLJ8KJjy0FnXXcFDpXa-171-148.png",
"certText": "金牌卖家",
"isShowCertIcon": true,
"allItemCount": "120",
"showShopLinkIcon": false,
"shopCard": "本店共120件宝贝在热卖",
"sellerType": "C",
"shopType": "C",  //卖家类型：B-天猫商城， C-淘宝集市
"evaluates": [  //店铺评分
{
"title": "宝贝描述",
"score": "4.7 ",
"type": "desc",
"level": "-1",
"levelText": "低",
},
{
"title": "卖家服务",
"score": "4.8 ",
"type": "serv",
"level": "0",
"levelText": "平",
},
{
"title": "物流服务",
"score": "4.8 ",
"type": "post",
"level": "0",
"levelText": "平",
}
],
"sellerNick": "麟主流",
"creditLevel": "13",
"creditLevelIcon": "//gw.alicdn.com/tfs/TB1Bw2CixrI8KJjy0FpXXb5hVXa-132-24.png",
"starts": "2011-04-20 13:06:24",
"goodRatePercentage": "98.77%", //店铺好评率
"fbt2User": "麟主流",
"simpleShopDOStatus": "1"
},
//商品详情，有两种格式：文本和JSON格式，如果指定了onlyhtml参数，则只返回文本HTML格式
"item_detail": [  //商品介绍信息
"//img.alicdn.com/imgextra/i4/695924102/TB2TD8klk7mBKNjSZFyXXbydFXa_!!695924102.jpg",
".....",
],
"video": //商品视频信息和主图视频URL地址，不一定有本项
            [
              {
              "model": {
              "componentTitle": {
              "text": "宝贝视频"
              },
              "thumbnail": "//img.alicdn.com/bao/uploaded/i2/TB11GEfukzoK1RjSZFlSuui4VXa.jpg",
              "videoId": "215125460677",
              "videoUrl": "https://cloud.video.taobao.com/play/u/834886515/p/2/e/6/t/1/215125460677.mp4?appKey=7596",
              "title": "使用教程",
              "subTitle": "核桃夹",
              "spm": "a2141.7631564.1999020245"
              },
              "styles": {
              "size": {
              "height": "348",
              "width": "620"
              },
              "backgroundColor": "#ffffff",
              "lineColor": "#ff5000",
              "titleColor": "#051b28"
              }
              }
            ]
}
}
}

维易淘宝客CMS
高佣/订单接口

接口列表

淘宝天猫商品详情图文介绍和店铺信息API

淘宝天猫商品详情图片介绍+店铺信息API：

一、商品详情接口功能（店铺信息/产品介绍/主图视频/SKU）

【如何高效使用详情接口】

二、详情接口返回值：

会员请加QQ群交流

会员请加QQ群交流：