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

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

在你的APP或公众号中,如果要调用淘宝天猫商品详情,则可以使用此商品详情接口,获取卖家店铺信息和产品图片介绍信息。

用法如下:


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

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

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


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

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

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


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

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


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

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


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


【调用权限】核心会员卡可调用

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

【稳定说明】本接口是赠送给核心接口会员使用,产品详情和评论接口是难度高的接口,即使花生日记、美逛等主流APP,都没有完美解决该问题,为保持稳定,请在您的应用中使用缓存,不需要相同产品重复调用。

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


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

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

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

接口:

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

参数:

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



示例1:

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


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

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

推荐做法:

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

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

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


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


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

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

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


以下字段内容是完整示例:

“item_detail”字段是淘宝详情介绍图列表。如果产品只有文字介绍,则不返回详情

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


【特别说明】 

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


完整字段含义说明:

{

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

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

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

    "data": {

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

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

  

        "item_detail": [  //图文介绍

            "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"   //店铺网址

        }

    }

}


返回值图示:

 

客服