优惠券-营销统计列表

接口信息

• 接口地址: {your-site-url}/api/skill/coupon/get-all-coupon-statistics
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET
• 说明: 此接口用于获取所有优惠券的统计数据列表。每个子项为单个优惠券的统计数据信息，包含统计指标和关联的优惠券基本信息。支持时间范围筛选和分页。

认证

请求头中需要携带 skill-access-token：

请求参数 (Query String)

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/coupon/get-all-coupon-statistics?created_at_begin=2026-05-05&created_at_end=2026-06-04&pageNum=1&pageSize=20' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 18,
                "shop_id": 15,
                "coupon_id": 69,
                "tem_use_count": 0,
                "used_count": 2,
                "base_discount_amount": "20.00",
                "base_order_amount": "2728.25",
                "order_product_count": 6,
                "average_unit_amount": "1364.13",
                "average_product_count": "3.00",
                "created_at": "2026-06-04 10:03:18",
                "updated_at": "2026-06-04 10:10:13",
                "coupon": {
                    "id": 69,
                    "code": "LX4ABQ14",
                    "minimum_requirements_type": 2,
                    "prerequisite_subtotal": "50.00",
                    "prerequisite_quantity": 0,
                    "value_type": 1,
                    "value": "10.00",
                    "title": "terry coupon"
                }
            }
        ],
        "total": 1,
        "pageSize": 20,
        "totalPage": 1
    },
    "message": "success"
}

返回字段说明

list 子项 - 统计字段

list 子项 - coupon 关联的优惠券基本信息

注意事项

1. 该接口按优惠券维度返回每条优惠券的统计数据，与 优惠券-全部优惠券-汇总统计 （返回汇总值）不同
2. created_at_begin / created_at_end 的时间范围作用于订单召回时间和优惠券使用时间两个维度
3. coupon 对象为优惠券的基本信息，便于展示时关联优惠券标题、码等
4. 各类金额均为基础货币