接口列表

当前位置：淘客联盟接口开发文档（旧版） > 店铺优惠券

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

迁移提示这是旧版文档，最新文档请点击这里查看

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

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

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

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

【接口使用】

http://api.veapi.cn/tbk/shopcoupon?vekey=xxx&itemid=626132884654

【参数说明】

itemid：必选，要查询的淘宝或天猫的商品ID

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

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

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

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

http://api.veapi.cn/tbk/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拼到它后面，实现有券。

如图：

维易淘宝客API
高佣/订单接口