接口: 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_id、brand_id、restrictions、keywords、image、thumbnail、smart_url
必填参数
可选参数
| Key | 说明 |
|---|
brand_type | 3 种品牌类型: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 | 更新时间 |