跳到主要内容

优惠券

接口: https://app.partnerboost.com/api.php?mod=coupon&op=coupon_list

认证:Partner API 认证

版本历史

  • V1.1 — 2022/08/03 — 新增本接口
  • V1.2 — 2023/08/22 — 必填参数 id/mid/track 改为可选
  • V1.3 — 2024/03/05 — 新增返回参数:creative_idbrand_idrestrictionskeywordsimagethumbnailsmart_url

必填参数

Key说明
tokenCoupon Token

可选参数

Key说明
brand_type3 种品牌类型:D2C、Amazon、Indirect
brand_id品牌 ID,一串数字,如 66303
mcid品牌唯一标识,一串字符,如 ulike0
track追踪链接中的 Track Code
type优惠券类型:coupon 或 deal
country优惠券可用国家
origin_category提供优惠券的商家分类
level等级 1–4,1 最高;等级越高更新越频繁
lang优惠券语言
per_page每页条数,默认 50,最多 2000
page当前页码,从 1 开始,默认 1
created_at创建时间,格式:YYYY-MM-DD
updated_at更新时间,格式:YYYY-MM-DD
start_at开始时间,格式:YYYY-MM-DD
end_at结束时间,格式:YYYY-MM-DD

返回字段

Key说明
id优惠券 ID
creative_id素材 ID
brand_id品牌 ID,一串数字,如 66303
mcid品牌唯一标识,一串字符,如 ulike0
restrictions优惠券使用限制
keywords优惠券关键词
image优惠券图片
thumbnail优惠券缩略图
smart_url优惠券活动智能追踪链接
advertiser_name商家名称
coupon_name优惠券名称
coupon_code优惠码
description描述
click_url优惠券活动追踪链接
origin_url优惠券原始链接
store_domain主机域名
type类型:coupon 或 deal
country可用国家
origin_category商家分类
level等级 1–4
lang语言
start_at开始日期
end_at结束日期
created_at创建时间
updated_at更新时间