维易淘客联盟接口开发文档:淘宝商品详情页

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

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

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


【特别强调】

1、请不要使用采集方式,或批量疯狂调用方式使用本接口,一经发现立即封号

正确使用方法:请在你的客户打开你的详情页时再调用本接口,不要烂用。

不要使用采集入库方式:因为商品有几百万,你的客户看你的商品只是极小一部分,绝大多数你采集的商品和它的评论不会被访问到,采集评论入库导致你消耗了大量的接口资源,导致接口不稳定或不能访问。是完全没有必要的调用方式。

2、本接口不稳定。有较大机率没有返回值。


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


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

【频率限制】150次/分钟。若有调整请参考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"

                    }

                }

            ]

         }

    }

}


 

客服

关注