维易淘客联盟接口开发文档:店铺优惠券

淘宝天猫店铺优惠券查询接口

本接口可以帮助淘客查询商品可用的店铺券。为您的客户提供更实惠的券选择。

接口功能:查询商品对应的可用店铺券。


一、淘宝天猫店铺优惠券查询接口

【调用权限】店铺券查询专用点卡

【接口使用】

http://api.vephp.com/shopcoupon?vekey=xxx&itemid=626132884654

【参数说明】

itemid:必选,要查询的淘宝或天猫的商品ID

sellerId:可选,店铺ID,在淘客接口中搜索或高佣转链详情接口有此参数值


二、店铺券查询接口返回值:

接口返回和手淘产品详情页的领券功能显示的优惠券一样,即为该商品可用的店铺优惠券(注意不是产品单品券)。

以下是商品626132884654查询的店铺券结果:


http://api.vephp.com/shopcoupon?vekey=xxx&itemid=626132884654

执行结果:

{

    "error": "0",

    "msg": "店铺优惠券查询成功!",

    "coupons_total": 1,  //店铺优惠券数量

    "has_coupon_prom": 1,   //是否有店铺满减活动,1表示有,0表示没有

    "data": [

        {

            "subTitles": [

                "有效期至2021.03.31 23:59"

            ],

            "effectiveTime": 1614614400000,   //有效期

            "titles": [

                "满199使用"   //使用条件

            ],

            "type": 1,

            "uuid": "de5b3aaebe87400c83a0232217bc8a7d",   //券ID

            "logoImageUrl": "https://gw.alicdn.com/tfs/TB19Nsthbr1gK0jSZR0XXbP8XXa-498-90.png",

            "promotionUniqueId": "de5b3aaebe87400c83a0232217bc8a7d",

            "priceCurrency": "¥",

            "applyText": "立即领取",

            "uuid4Cal": "de5b3aaebe87400c83a0232217bc8a7d",

            "priceText": "5",   //优惠券面额:减5元(满199元)

            "unEffectiveTime": 1617206399000,   //有效期

            "bgUrl": "https://gw.alicdn.com/tfs/TB1UZgNf7T2gK0jSZFkXXcIQFXa-1428-288.png"

        },

         ........  //其它券略掉

        {

            "priceDes": "起",

            "priceCurrency": "¥",

            "subTitles": [

                "距到期仅剩2天"

            ],

            "applyUrl": "//h5.m.taobao.com/shopb/shopactivity.html?activityId=15626565363&sellerId=2271279753&source=2&spm=W-a211f8.10431435&scm=20140619.detail.dpb.0",

            "effectiveTime": 1615704560000,

            "titles": [],

            "type": 1007,

            "items": [   //店铺满减活动

                {

                    "actionType": "4",

                    "actionValue": "8",

                    "title": "满35元,省8元",

                    "gifts": [],

                    "promotionUniqueId": "15626565363-1"

                },

                {

                    "actionType": "4",

                    "actionValue": "11",

                    "title": "满41.9元,省11元",

                    "gifts": [],

                    "promotionUniqueId": "15626565363-2"

                },

                {

                    "actionType": "4",

                    "actionValue": "14",

                    "title": "满47.9元,省14元",

                    "gifts": [],

                    "promotionUniqueId": "15626565363-3"

                },

                {

                    "actionType": "4",

                    "actionValue": "19",

                    "title": "满53.9元,省19元",

                    "gifts": [],

                    "promotionUniqueId": "15626565363-4"

                }

            ],

            "priceText": "8",

            "unEffectiveTime": 1615856399000,

            "logoImageUrl": "https://gw.alicdn.com/tfs/TB1a.3vheH2gK0jSZJnXXaT1FXa-498-90.png",

            "bgUrl": "https://gw.alicdn.com/tfs/TB1rPY7gkT2gK0jSZFkXXcIQFXa-714-142.png"

        }

    ]

}


可以在手淘端产品详情页看到这些优惠券,如图:


如果有店铺满减活动,则结果如下:

以商品ID :38134950905 为例,有满4000元减600元活动。

{

    "error": "0",

    "msg": "店铺优惠券查询成功!",

    "coupons_total": 0,

    "has_coupon_prom": 1,

    "data": [

        {

            "priceCurrency": "¥",

            "subTitles": [

                "距到期仅剩3天"

            ],

            "applyUrl": "//h5.m.taobao.com/shopb/shopactivity.html?activityId=16626807583&sellerId=595397331&source=2&spm=W-a211f8.10431435&scm=20140619.detail.dpb.0",

            "effectiveTime": 1617204851000,

            "titles": [],

            "type": 1007,

            "items": [

                {

                    "actionType": "4",

                    "actionValue": "600",

                    "title": "满4000元,省600元",

                    "gifts": [],

                    "promotionUniqueId": "16626807583-1"

                }

            ],

            "priceText": "600",

            "unEffectiveTime": 1618502399000,

            "logoImageUrl": "https://gw.alicdn.com/tfs/TB1a.3vheH2gK0jSZJnXXaT1FXa-498-90.png",

            "bgUrl": "https://gw.alicdn.com/tfs/TB1rPY7gkT2gK0jSZFkXXcIQFXa-714-142.png"

        }

    ]

}


满减在手淘上显示:


如果有赠品,则返回如下:

{

    "error": "0",

    "msg": "店铺优惠券查询成功!",

    "coupons_total": 0,

    "has_coupon_prom": 1,

    "data": [

        {

            "subTitles": [

                "有效期至2021.06.01 00:00"

            ],

            "applyUrl": "//h5.m.taobao.com/shopb/shopactivity.html?activityId=18487071808&sellerId=1767192580&source=2&spm=W-a211f8.10431435&scm=20140619.detail.dpb.0",

            "effectiveTime": 1611072000000,

            "activityLogo": "https://gw.alicdn.com/tfs/TB1R7zPgNn1gK0jSZKPXXXvUXXa-168-168.png",

            "titles": [],

            "type": 1007,

            "items": [

                {

                    "actionType": "131080",

                    "title": "满2件,领超值赠品(赠完即止)",

                    "gifts": [

                        {

                            "picUrl": "//img.alicdn.com/imgextra/i4/1767192580/O1CN01h0jJdT1UvgVUmfajW_!!2-item_pic.png",

                            "name": "窑变蓝兔毫",

                            "id": "637042766886",

                            "title": "窑变陶瓷功夫茶具套装家用整套蓝兔毫简约泡茶器茶壶杯子",

                            "jumpUrl": "https://detail.tmall.com/item.htm?id=637042766886"

                        }

                    ],

                    "promotionUniqueId": "18487071808-1"

                }

            ],

            "unEffectiveTime": 1622476800000,

            "logoImageUrl": "https://gw.alicdn.com/tfs/TB1H4kshoD1gK0jSZFGXXbd3FXa-498-90.png",

            "bgUrl": "https://gw.alicdn.com/tfs/TB1rPY7gkT2gK0jSZFkXXcIQFXa-714-142.png"

        }

    ]

}


手淘上显示为:


三、店铺券如何使用?

通过上面接口取得券信自息后,可以接在拼装在淘客商品二合一领券页链接后,也可以直接拼接成店铺优惠券领取链接,在PC端领取。

如:

1、直接在PC上取券(需要登录淘宝天猫):

以下只是例子,请把 activity_id seller_id 参数换成新的。

https://taoquan.taobao.com/coupon/unify_apply_result_tmall.htm?success=false&need_check=false&need_ok=true&activity_id=a193b56e052643719c788f4bb983c54a&seller_id=3538683476

打开页面可领取。


2、直接在淘客商品二合一领券页链接后面加activityId参数,如:

商品:https://item.taobao.com/item.htm?id=23883488910

默认单品券为满18元减5元,二合一链接为:

https://uland.taobao.com/coupon/edetail?e=aofRcWByBLIbwa0ArmopK9dmXiDhg%2BmQXmFKNv7IlMYb3RSls5eFe4PO1%2Fx2sWd1xwGwtHJmqGx65Jmwg7uAgQAiCtVOu0vMkGH6wWCd7AJ2zIbJA0ocBS3%2FM4lAwO%2BXrOugqOzy%2BV3F8WVlIJ68AEy5otPERvyno4uTMKfHYjAMW8kuaGjDkHqVXNQKelMhYgSDYA7FPLBNCI5rN9wQRA%3D%3D&traceId=0bb625ec16143045052791940ea698&union_lens=lensId:TAPI@1614304505@2105ac63_07e7_177dc0bede7_71ce@01

该店有一个满69元减10元的优惠券,券ID是 b0367b7a84c24aadb78f41564cbdc381

拼接后如下:

https://uland.taobao.com/coupon/edetail?e=aofRcWByBLIbwa0ArmopK9dmXiDhg%2BmQXmFKNv7IlMYb3RSls5eFe4PO1%2Fx2sWd1xwGwtHJmqGx65Jmwg7uAgQAiCtVOu0vMkGH6wWCd7AJ2zIbJA0ocBS3%2FM4lAwO%2BXrOugqOzy%2BV3F8WVlIJ68AEy5otPERvyno4uTMKfHYjAMW8kuaGjDkHqVXNQKelMhYgSDYA7FPLBNCI5rN9wQRA%3D%3D&traceId=0bb625ec16143045052791940ea698&union_lens=lensId:TAPI@1614304505@2105ac63_07e7_177dc0bede7_71ce@01&activityId=b0367b7a84c24aadb78f41564cbdc381

这样就切换了优惠券。

当然,如果淘客商品没有优惠券,维易高佣接口或超级搜索接口会返回original_uland_link字段,可以把券ID拼到它后面,实现有券。

如图:

 

客服