**版本：202601**

# 根据 SKU 获取数据分析

**POST** `/openapi/2026-01/data-analysis/sku`

通过 SKU 维度分析商品，提供详细的销售数据洞察。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `begin_time` string (required)

  开始时间，Unix 时间戳（秒），以字符串形式传递，例如 "1748736000"
- `end_time` string (required)

  结束时间，Unix 时间戳（秒），以字符串形式传递，例如 "1781481600"；应大于 begin\_time
- `cursor` string

  分页游标
- `page_size` int32

  每页记录数

  **可选值：** `>= 1` and `<= 500`

  **默认值：** `10`
- `page` int32

  页码（从 1 开始），与 cursor 互斥
- `sort_by` string

  排序字段，可选值：

  *   `variant_op_updated_at`：子款式最后操作更新时间
  *   `views_count`：浏览次数
  *   `add_to_cart_count`：加购次数
  *   `order_count`：订单数量
  *   `sales_total`：总销售额
  *   `net_sales_total`：净销售额
  *   `add_to_cart_rate`：加购率
  *   `add_to_cart_conversion_rate`：加购转化率
  *   `sales_count`：销售数量
  *   `views_rate`：浏览占比
- `time_zone` int32

  时区偏移（小时）；推荐范围 -12 至 14
- `sort_direction` string

  排序方向，可选值：`asc`（升序）、`desc`（降序）
- `collection_id` string

  按专辑 ID 筛选
- `sales_platform` string

  销售渠道筛选，可选值：

  *   `shopping_action`：Google Shopping Action
  *   `shoplazza`：在线商店
  *   `mocart`：Mocart
- `keyword` string

  搜索关键词；将按 title、ID、brief、SKU、SPU、tags、note 进行模糊匹配
- `search_model` string

  搜索模式，可选值：`base`（默认，基础模式）、`advanced`（高级模式，启用下方附加筛选字段）
- `collection_name` string

  按专辑名称筛选
- `title` string

  按商品标题筛选
- `tag_list` string

  按商品标签筛选
- `category` string

  按商品分类筛选
- `sub_category` boolean

  是否包含所有子分类层级下的商品
- `cost_price_min` string

  最低成本价，例如 `1.99`
- `cost_price_max` string

  最高成本价，例如 `8.99`
- `product_note` string

  按商品备注筛选
- `vendor` string

  按供应商名称筛选
- `created_at_min_at` string

  筛选创建时间不早于该时间点的商品；例如 `2026-04-01 00:00:00`
- `created_at_max_at` string

  筛选创建时间不晚于该时间点的商品；例如 `2026-04-04 00:00:00`
- `filter_crawler_type` string

  爬虫过滤策略，控制统计是否剔除爬虫/机器人流量。可选值：

  *   `no_filter_crawler`：不过滤，统计全部流量（默认）
  *   `official_crawler`：过滤掉已知爬虫/机器人

```json
{
  "begin_time": "string",
  "end_time": "string",
  "cursor": "string",
  "page_size": 10,
  "page": 0,
  "sort_by": "string",
  "time_zone": 0,
  "sort_direction": "string",
  "collection_id": "string",
  "sales_platform": "string",
  "keyword": "string",
  "search_model": "string",
  "collection_name": "string",
  "title": "string",
  "tag_list": "string",
  "category": "string",
  "sub_category": true,
  "cost_price_min": "string",
  "cost_price_max": "string",
  "product_note": "string",
  "vendor": "string",
  "created_at_min_at": "string",
  "created_at_max_at": "string",
  "filter_crawler_type": "string"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `count` int32

    记录总数
  - `last_updated_at` string

    统计数据最后更新时间，例如 `2026-03-26 00:00:00`
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录
  - `data` object[]

    子款式级销售数据列表

    *   Array \[

    - `product_id` string

      商品 ID
    - `variant_id` string

      子款式 ID
    - `title` string

      商品标题
    - `brief` string

      商品副标题/简要描述
    - `variant_title` string

      子款式标题，如尺码或颜色组合
    - `sku` string

      库存量单位（SKU）编码
    - `spu` string

      标准商品单元（SPU）编码
    - `image` string

      商品图片文件名
    - `seo_url` string

      包含子款式参数的 SEO 友好商品 URL 路径
    - `price` float

      子款式价格（店铺货币计价）
    - `variant_op_updated_at` string

      子款式最后操作更新时间（ISO-8601 格式）
    - `sales_count` int32

      已售商品数量
    - `sales_total` float

      总销售金额
    - `net_sales_total` float

      扣除退款后的净销售额
    - `order_count` int32

      包含该子款式的订单数量
    - `refund_count` int32

      退款交易数量
    - `views_count_original` int32

      商品详情页浏览量，数值型
    - `view_client_count` int32

      商品详情页的唯一访客数
    - `add_to_cart_count_original` int32

      加购事件次数，数值型
    - `add_cart_client_count` int32

      将该子款式加入购物车的唯一用户数
    - `transform_rate_original` float

      访问到下单的转化率，数值型，如 100（表示 100%）
    - `add_to_cart_conversion_rate_original` float

      加购到下单的转化率，数值型，如 100（表示 100%）
    - `published_at` string

      商品首次上架时间（ISO-8601 格式）
    - `refund_quantity` int32

      已退款商品总数量
    - `add_to_cart_rate_original` float

      加购率（占商品页面浏览量的百分比），数值型
    - `views_rate_original` float

      该子款式浏览量在所有商品浏览量中的占比，数值型
    - `opened_orders` int32

      未处理/待处理订单数量
    - `refund_orders` int32

      已全额退款的订单数量
    - `transform_rate` string

      访问到下单的转化率，格式化字符串，如 "100.00%"
    - `add_to_cart_conversion_rate` string

      加购到下单的转化率，格式化字符串，如 "100.00%"
    - `add_to_cart_rate` string

      加购率，格式化字符串，如 "100.00%"
    - `views_rate` string

      商品总浏览量占比，格式化字符串，如 "100.00%"
    - `views_count` string

      商品详情页浏览量，格式化字符串，如 "1"
    - `add_to_cart_count` string

      加购次数，格式化字符串，如 "1"
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "count": 0,
    "last_updated_at": "string",
    "cursor": "string",
    "has_more": true,
    "data": [
      {
        "product_id": "string",
        "variant_id": "string",
        "title": "string",
        "brief": "string",
        "variant_title": "string",
        "sku": "string",
        "spu": "string",
        "image": "string",
        "seo_url": "string",
        "price": 0,
        "variant_op_updated_at": "string",
        "sales_count": 0,
        "sales_total": 0,
        "net_sales_total": 0,
        "order_count": 0,
        "refund_count": 0,
        "views_count_original": 0,
        "view_client_count": 0,
        "add_to_cart_count_original": 0,
        "add_cart_client_count": 0,
        "transform_rate_original": 0,
        "add_to_cart_conversion_rate_original": 0,
        "published_at": "string",
        "refund_quantity": 0,
        "add_to_cart_rate_original": 0,
        "views_rate_original": 0,
        "opened_orders": 0,
        "refund_orders": 0,
        "transform_rate": "string",
        "add_to_cart_conversion_rate": "string",
        "add_to_cart_rate": "string",
        "views_rate": "string",
        "views_count": "string",
        "add_to_cart_count": "string"
      }
    ]
  }
}
```