维易淘客联盟接口开发文档:双11专用API

双11预售API-超级红包-愿望清单-预售列表

本文档为2019年天猫双11预售商品接口:

包含:

1、预售商品库列表

2、预售商品库搜索,

3、超级红包接口

4、愿望清单和愿望广场


【特别提示】双11期间,请会员尽量用这里的接口,

这样您可以在获得产品佣金同时,从联盟给团队的奖励中获得更多奖金


推广预售商品的优势:

1.用户支付预售定金后可以自动帮助购买用户创建愿望清单,而愿望清单通过分享可以无限透传;

2.预售定金单具有最高的结算权限,结算优先级为:预售定金单>淘礼金>超级红包>cps

3.预售定金单可以提前推广下单;

因此,每一个预售定金单都能帮用户赚取更多的佣金,裂变更多的用户。

淘客在双11活动期间重中之重就是推广双11的预售商品!


一、双11预售商品列表接口:

【使用权限】核心全能会员卡、超级会员卡

【使用场景】在您的APP、网站等双11商品展示区调用,输出全部的双11预售商品。

【预售接口】

http://api.vephp.com/presale?vekey=xxx&page_no=1&page_size=20&materialId=xxx

【参数说明】

vekey 是您接入该接口的维易接口密钥,在会员中心授权页获取

materialId 可选,物料ID,默认26257,你可以使用下文各类预售物料ID,获取不同的预售商品列表,参考下文。

page_no 分页

page_size 每页输出的预售商品数,默认20个商品。

【返回值说明】

预售商品接口返回值含义和字段类型,参考

https://open.taobao.com/api.htm?spm=a219a.7386797.0.0.17c2669aBLBHVg&source=search&docId=37884&docType=2


二、双11预售商品搜索接口:

【使用权限】核心全能会员卡、超级会员卡

【使用场景】在您的APP、网站搜索功能中,使搜索结果列表返回的商品均为预售商品。

【预售搜索接口】

已整合进超级搜索接口(super)http://wsd.591hufu.com/doc/chaojisousuojiekou

在该接口中添加presale参数即可。

【搜索返回值】

在搜索接口中增加了presale参数后,将在返回值中增加以下预售商品的字段:

【双11参数——仅双11大促时有】

presale_discount_fee_text: 预售商品-商品优惠信息,如“付定金立减20元”

presale_tail_end_time: 预售商品-付定金结束时间(毫秒)

presale_tail_start_time:预售商品-付尾款开始时间(毫秒)

presale_end_time:预售商品-付定金结束时间(毫秒)

presale_start_time:预售商品-付定金开始时间(毫秒)

presale_deposit: 预售商品-定金(元)


三、双11超级红包API:

【使用权限】核心全能会员卡、超级会员卡

【接口用法】生成维易活动推广链接接口即可生成超级红包接口,接口地址:http://wsd.591hufu.com/doc/guanfanghuodonglianjie

其中1539329391766是超级的活动ID,是固定的:

http://api.vephp.com/activitylink?vekey=xxx&activityId=1539329391766&pid=mm_111_222_333&relationId=123456

【注】1539329391766是固定的,不要更改

生成超级红包推广链接后,可以再调用淘口令接口封装成淘口令,接口地址:

http://wsd.591hufu.com/doc/shengchengtaokouling


四、愿望清单:

为您的客户创建愿望清单,愿望清单如图:

【使用权限】核心全能会员卡、超级会员卡

【接口用法】生成双11愿望清单,以及清单产品查询。接口:

1、创建愿望清单:每个客户可以创建多个愿望清单。

http://api.vephp.com/wishupdate?vekey=xxx&wishid=xxx&itemids=xxx&pid=..&relationId=...

参数:

(1)wishid 可选,当您已经有愿望清单时,可以指定该值,把新生成的清单覆盖旧的清单产品。如果不指定该参数,则创建新清单。

(2)itemids 必选,为清单创建产品列表,最少3个以上产品ID,格式如:601056197768,557894724044,600375008180

(3)pid 可选,指定你的PID,如果不提供本参数,则使用你会员中心预设的PID

(4)relationId 可选,提供你的客户的渠道ID,使清单和你的客户绑定。

【返回值】

{

    "error": "0",   //如果创建失败,则不为0

    "msg": "愿望清单生成成功!",

    "data": {

        "wish_list_id": "2004337234",  //生成的清单ID

        "wish_list_url": "https://mo.m.taobao.com/taokeapp/wishes/list.html?..." //清单地址

    }

}

2、查询愿望清单:本接口将查询指定清单ID的产品列表

http://api.vephp.com/wishlist?vekey=xxx&wishid=2004337234

参数:

wishid 可选,指定要查询的清单ID下的产品,如不提供该参数,则查询该帐号下所有清单ID的产品。

【返回值】

如下例,查询的是2004337234该清单产品列表

{

    "error": "0",

    "msg": "愿望清单生成成功!",

    "data": [

        {

            "item_id_list": {

                "string": [  //清单产品ID列表

                    "591038764869",

                    "598079959720",

                    "563392434345"

                ]

            },

            "wish_list_id": "2004337234",

            "wish_list_url": "https://mo.m.taobao.com/tao..."

        }

    ]

}


五、天猫双11主要的预售清单接口

以下精选的预售专题,使用不同物料ID,调用接口(参考上文第一节)

http://api.vephp.com/presale?materialId=xxx&vekey=....

把下面表格中不同的物料ID,传给参数materialId,即可获取不同预售清单。


1、[预售实时热销清单]

亮点:全网实时热销爆款精选推荐,2小时实时更新。

场景:适合淘客做选品也适直接面向消费者推广页面

时间:1020-1110

消费者端页面链接:

物料ID(materialId参数)

综合

女装

食品

美妆个护

家居家装

数码家电

母婴

鞋包配饰

男装

内衣

运动户外

26200

26512

26516

26518

26513

26514

26515

26517

26519

26520

26521


2、[预售高佣(大额券)清单]

亮点:高佣、带优惠券的淘宝联盟精选商品库中的热销推荐,2小时实时更新。

场景:适合淘客做选品(高佣选品)也适直接面向消费者推广页面(大额券)

时间:1020-1110

物料ID(materialId参数)

综合

女装

食品

美妆个护

家居家装

数码家电

母婴

鞋包配饰

男装

内衣

运动户外

26203

26563

26567

26569

26564

26565

26566

26568

26570

26571

26572



3、[预售行业尖货清单]

亮点:天猫行业定向招商极致爆款

场景:适合淘客做选品也适直接面向消费者推广页面

时间:1020-1110

物料ID(materialId参数)

综合

女装

食品

美妆个护

家居家装

数码家电

母婴

鞋包配饰

男装

内衣

运动户外

天猫国际

26481

26595

26599

26601

26596

26597

26598

26600

26602

26603

26604

26605

 


4、[预售超级大牌清单]

亮点:天猫双11TOP品牌爆款集合

场景:适合淘客做选品也适直接面向消费者推广页面

时间:1020-1110

物料ID(materialId参数)

综合

女装

食品

美妆个护

家居家装

数码家电

母婴

鞋包配饰

男装

内衣

运动户外

天猫国际

苏宁易购

26483

26628

26632

26634

26629

26630

26631

26633

26635

26636

26637

26638

26725

 

客服