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

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

在你的APP或公众号中,如果要调用淘宝天猫商品详情,则可以使用此商品详情接口,获取:


1、卖家店铺信息

2、产品图片介绍信息。


【特别说明】本接口仅限查询淘客商品的图文详情介绍,如果你需要查询非淘客商品的图文详情,请查看http://wsd.591hufu.com/doc/quanwangtuwen 




【特别声明——使用必读】

本接口是赠送给核心接口会员按需使用,不提供给采集者使用。

接口自带“防采集自动冻结接口权限”功能,请不要使用采集方式调用本接口,否则被系统加进冻结队列,我们不再解冻你的权限,也不退款。当你使用该接口意味着知晓此条款。


1.什么是“按需使用”?

即按你的应用场景需要调用:当你的客户进入你的APP或网站等应用的详情页时,可能有需要看图文介绍再决定是否购买,当你的客户决定查看图文介绍时再调用接口,即按您的客户需要实时调用。

这种方式加上缓存,可以大幅度降低调用频率。


2.什么是“采集方式”?

有的会员大批量采集调用接口,保存到自己网站数据库上,这种就是采集方式,实际上这种方式没有用处,商品有效期过后就会被联盟下架,你采集的详情可能完全不会被访问到,但却浪费了大量的接口资源。完全没有必要采集。


评论和详情接口都是特殊接口,严禁采集方式调用,一旦被系统加入冻结队列,都停止权限且不退还余额!

请共同维护好接口,停止采集,感谢支持!


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


【调用权限】核心会员卡可调用,限查询淘客商品。

【频率限制】280次/分钟。如果需要更高的频率,请使用全网专用卡(含非淘客商品)。

【稳定说明】本接口是赠送给核心接口会员使用,产品详情和评论接口是难度高的接口,为保持稳定,请在您的应用中使用缓存,不需要相同产品重复调用。本接口可能视具体情况适当调整频率。

【查询范围】仅限查询淘客产品“图文介绍和店铺信息”,并非全淘宝天猫产品都可查。如果你要获得全网商品和SKU信息,请使用全网详情专用卡。


一、商品详情接口功能(店铺信息+产品图文介绍)

1、获取商品详情图:即产品的详细介绍详情。如果产品只有文字介绍,则不返回详情。

2、获取卖家店铺信息:包括:店铺shopID、店铺头像、卖家评分等等。

接口:

http://api.vephp.com/itemdetail?vekey=xxx&para=产品id

参数:

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

infoType:可选,获取信息类型:1(默认)店铺信息和图文介绍全要,2-只要店铺信息,3-只要图文信息。如果你只需要单项信息请选2或3,效率更高。

pcClient:可选值0(默认)或1,是否为PC端的图文信息。默认0表示返回移动端的图文信息。1表示要PC端的。

picType:可选,表示图片的格式,可选1或2。默认1表示返回的图片地址字段item_detail值为干净的图片地址,2表示带HTML的图片代码。



示例1:

http://api.vephp.com/itemdetail?vekey=xxx&para=573853907998


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

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

推荐做法:

1、先在您的APP详情页上方,展示主图、价格、优惠券,这些信息可以通过高佣转链接口快速取得返回值,

当客户下拉到图文详情区时再调用本接口。

2、在一些网站应用上,可能初始不需要展示店铺和图文详情,这时可以做一个按钮方式触发,也就是客人点了开始调用图片介绍详情。


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


二、店铺和图文详情接口返回值:

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

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


以下字段内容是完整示例,重点说明:

“item_detail”字段是淘宝详情介绍图列表。【重要】当产品介绍含有文字时,这时item_detail强制为html格式。比如:https://detail.tmall.com/item.htm?id=635099446239 书籍,此时picType参数失效

“shopInfo”是店铺摘要信息。包括:店铺shopID、店铺头像、卖家评分等等


【特别说明】 

因接口特殊,item_detail 和 shopInfo 字段不一定有值,请做好程序的判断。


完整字段含义说明:

{

    "error": "0",   //不为0表示失败,0表示获取成功

    "msg": "获取产品详情成功",

    "debugCode": "10001" //维易内部调试码,无需理睬

    "data": {

        "title": "2019夏季新款女装修身显瘦温柔风裙子收腰气质中长碎花雪纺连衣裙",

        "subtitle": "", //subtitle不一定有值,它一般是淘宝或天猫产品的副标题,通常是一些卖点说明,出现在淘宝/天猫的详情页标题下方位置,如“100%棉打底衫 工厂直供  收藏加购先发货”

  

        "item_detail": [  //图文介绍

         //【重要】当产品介绍含有文字时,这时item_detail强制为html格式。比如:https://detail.tmall.com/item.htm?id=635099446239 书籍,此时picType参数失效,

            "http://img.alicdn.com/imge....jpg",

            "http://img.alicdn.com/imgex...2.jpg",

             ....

        ],

        "shopInfo": {  //店铺信息

            "shopId": 105142999,   //店铺ID

            "sellerId": "1725579592",   //卖家ID

            "shop_icon": "https://wwc.alicdn.com/avat..",   //店铺ICON头像

            "shop_name": "saronala莎欧娜拉旗舰店",

            "item_score": 490,    //店铺产品评分,490表示4.9分

            "service_score": 480,   //服务评分,480表示4.8分

            "delivery_score": 480,   //物流评分

            "shop_url": "https://store.taobao.com/?shop_id=105142999"   //店铺网址

        }

    }

}


返回值图示:

 

客服