店铺-商品变体-销售统计

数据 - 获取商品变体销售排行

接口信息

• 接口地址: {your-site-url}/api/skill/data/get-product-variant-ranking-data
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET
• 说明: 此接口用于获取商品变体（规格）维度的销售排行数据。仅 B2C 店铺支持，B2B 店铺不支持。与商品排行不同，此接口按变体维度统计。默认按销量降序排列，支持排序和分页。

认证

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

请求参数 (Query String)

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/data/get-product-variant-ranking-data?quantum=month&begin_date=2026-05-05 07:54:31&end_date=2026-06-04 07:54:31' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "product_id": 7043,
                "variant_id": 48958,
                "product_sale_count": "3",
                "product_sale_amount": "237.00",
                "product_info": {
                    "id": 48958,
                    "product_id": 7043,
                    "title": "Diamond Detail In Gold Vermeil M / Black",
                    "image_id": 40979,
                    "image": {
                        "id": 40979,
                        "src": "/product/15/image/2026/05/23/c95f68bbf27f44d98b6882e6d8a1a301.jpg"
                    },
                    "status": 1,
                    "is_deleted": 2
                }
            }
        ],
        "total": 7,
        "pageSize": 20,
        "totalPage": 1
    },
    "message": "success"
}

返回字段说明

list 子项字段

product_info 字段

product_info.image 字段

注意事项

1. 与 店铺-商品-销售统计 不同，此接口按变体维度统计，一个商品的多个变体会分别列出
2. 默认按 product_sale_count（销量）降序排列
3. sort 可为 product_sale_count 或 product_sale_amount
4. direction 为 asc 或 desc
5. begin_date 和 end_date 格式为 YYYY-MM-DD HH:mm:ss