根据 SKU 获取数据分析

POST 
/openapi/2026-07/data-analysis/sku

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

请求

application/json

请求体

请求体必填

begin_timestring必填

开始时间，Unix 时间戳（秒），以字符串形式传递，例如 "1748736000"

end_timestring必填

结束时间，Unix 时间戳（秒），以字符串形式传递，例如 "1781481600"；应大于 begin_time

cursorstring

分页游标

page_sizeint32
每页记录数
可选值： >= 1 and <= 500
默认值： 10
sort_bystring
排序字段，可选值：
• 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_zoneint32

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

sort_directionstring

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

collection_idstring

专辑 ID

sales_platformstring
销售平台筛选，可选值：
• shopping_action：Google Shopping Action
• shoplazza：在线商店
• mocart：Mocart
keywordstring

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

search_modelstring

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

collection_namestring

专辑名称

titlestring

按商品标题筛选

tag_liststring

按商品标签筛选

categorystring

按商品分类筛选

sub_categoryboolean

是否包含子分类下的商品

cost_price_minstring

最低成本价

cost_price_maxstring

最高成本价

product_notestring

商品备注

vendorstring

供应商名称

created_at_min_atstring

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

created_at_max_atstring

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

filter_crawler_typestring
爬虫过滤策略，控制统计是否剔除爬虫/机器人流量。可选值：
• no_filter_crawler：不过滤，统计全部流量（默认）
• official_crawler：过滤掉已知爬虫/机器人

示例

{
  "begin_time": "string",
  "end_time": "string",
  "cursor": "string",
  "page_size": 10,
  "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

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
countint32
记录总数
last_updated_atstring
统计数据最后更新时间，例如 2026-03-26 00:00:00
cursorstring
分页游标
has_moreboolean
是否有更多记录
data object[]
子款式级销售数据列表
Array [
product_idstring
商品 ID
variant_idstring
子款式 ID
titlestring
商品标题
briefstring
商品副标题/简要描述
variant_titlestring
子款式标题，如尺码或颜色组合
skustring
SKU
spustring
标准商品单元（SPU）编码
imagestring
商品图片文件名
seo_urlstring
包含子款式参数的 SEO 友好商品 URL 路径
pricefloat
子款式价格（店铺货币计价）
variant_op_updated_atstring
子款式最后操作更新时间（ISO-8601 格式）
sales_countint32
已售商品数量
sales_totalfloat
总销售金额
net_sales_totalfloat
扣除退款后的净销售额
order_countint32
包含该子款式的订单数量
refund_countint32
退款交易数量
views_count_originalint32
商品详情页浏览量，数值型
view_client_countint32
商品详情页的唯一访客数
add_to_cart_count_originalint32
加购事件次数，数值型
add_cart_client_countint32
将该子款式加入购物车的唯一用户数
transform_rate_originalfloat
访问到下单的转化率，数值型，如 100（表示 100%）
add_to_cart_conversion_rate_originalfloat
加购到下单的转化率，数值型，如 100（表示 100%）
published_atstring
商品首次上架时间（ISO-8601 格式）
refund_quantityint32
已退款商品总数量
add_to_cart_rate_originalfloat
加购率（占商品页面浏览量的百分比），数值型
views_rate_originalfloat
该子款式浏览量在所有商品浏览量中的占比，数值型
opened_ordersint32
未处理/待处理订单数量
refund_ordersint32
已全额退款的订单数量
transform_ratestring
访问到下单的转化率，格式化字符串，如 "100.00%"
add_to_cart_conversion_ratestring
加购到下单的转化率，格式化字符串，如 "100.00%"
add_to_cart_ratestring
加购率，格式化字符串，如 "100.00%"
views_ratestring
商品总浏览量占比，格式化字符串，如 "100.00%"
views_countstring
商品详情页浏览量，格式化字符串，如 "1"
add_to_cart_countstring
加购次数，格式化字符串，如 "1"
]

示例

{
  "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"
      }
    ]
  }
}