根据 SPU 获取数据分析

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

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

请求

application/json

请求体

请求体必填

typestring必填

分析对象类型，可选值：product、variant、collection

begin_timestring必填

开始时间：Unix 时间戳（秒），以字符串形式传递（例如 "1748736000"）；需小于 end_time，通常取目标时区当天 0 点

end_timestring必填

结束时间：Unix 时间戳（秒），以字符串形式传递（例如 "1781481600"）；需大于 begin_time，通常取次日时区当天 0 点

cursorstring

分页游标

page_sizeint32
每页记录数
默认值： 10
time_zoneint32

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

sort_bystring
排序字段，可选值：
• created_at：商品创建时间
• first_published_at：首次上架时间
• published_at：最近上架时间
• product_op_updated_at：商品最后操作更新时间
• order_count：订单数量
• sales_count：销售数量
• sales_total：总销售额
• net_sales_total：净销售额
• discount：折扣金额
• tax：税费金额
• views_count：浏览次数
• add_to_cart_count：加购次数
• add_to_cart_rate：加购率
• view_client_count：独立浏览用户数
• add_cart_client_count：独立加购用户数
• add_to_cart_conversion_rate：加购转化率
• transform_rate：整体转化率
sort_directionstring

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

collection_idstring

专辑 ID（传入后将按该专辑筛选结果）

keywordstring

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

search_modelstring

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

filterstring

高级筛选条件（JSON 字符串）；仅当 search_model 为 advanced 时生效

结构为扁平 JSON 对象：每个筛选 key 对应一个叶子 {"operator": "...", "value": ...}， 多个 key 之间为 AND（本接口不支持 OR 组合）。

要传的 value 类型由 operator 决定（大小写不敏感）：

• in / not in -> value 为字符串数组，例如 ["SPU001", "SPU002"]
• like / not like -> value 为字符串，例如 "shirt"
• = > >= < <= -> value 为标量（字符串或数字），例如 10

key 与 value 的对应：

• 列表类 spu sku product_id title tag_list -> 数组
• 区间类 price_min/price_max、cost_price_min/cost_price_max、compare_at_price_min/compare_at_price_max、created_at_min/created_at_max、updated_at_min/updated_at_max -> 标量
• 布尔类 published sub_category -> "true" / "false"
• 其他 collection_id keyword vendor category product_note sales_platform -> 字符串

未识别的 key 会被静默忽略（请求仍返回 200），筛选「不生效」时优先核对 key 拼写。

例如：{"spu": {"operator": "in", "value": ["SPU001", "SPU002"]}}

with_impressionboolean

是否在返回中包含曝光数据

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

示例

{
  "type": "string",
  "begin_time": "string",
  "end_time": "string",
  "cursor": "string",
  "page_size": 10,
  "time_zone": 0,
  "sort_by": "string",
  "sort_direction": "string",
  "collection_id": "string",
  "keyword": "string",
  "search_model": "string",
  "filter": "string",
  "with_impression": true,
  "filter_crawler_type": "string"
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

data object[]

数据列表

Array [

utm_sourcestring

UTM 来源

utm_mediumstring

UTM 媒介

utm_campaignstring

UTM 活动名称

utm_termstring

UTM 关键词

utm_contentstring

UTM 内容

imagestring

图片

titlestring

标题

order_count_originalint32

原始订单数量

sales_count_originalint32

原始销售数量

sales_total_originalfloat

原始总销售额

net_sales_total_originalfloat

原始净销售额

discount_originalfloat

原始折扣金额

tax_originalfloat

原始税费金额

views_count_originalint32

原始浏览次数

add_to_cart_count_originalint32

原始加购次数

views_rate_originalfloat

原始浏览率

add_to_cart_rate_originalfloat

原始加购率

view_client_count_originalint32

原始浏览客户端数量

add_cart_client_count_originalint32

原始加购客户端数量

add_to_cart_conversion_rate_originalfloat

原始加购转化率

transform_rate_originalfloat

原始转化率

product_idstring

商品 ID

briefstring

简要描述

spustring

SPU（标准商品单元）

collectionstring

所属专辑

created_atstring

创建时间（ISO-8601 格式）

first_published_atstring

首次上架时间（ISO-8601 格式）

published_atstring

上架时间（ISO-8601 格式）

product_op_updated_atstring

商品最后操作更新时间（ISO-8601 格式）

publishedboolean

是否已上架

duty_total_originalint32

原始关税总额

order_countstring

订单数量

sales_countstring

销售数量

sales_totalstring

总销售额

net_sales_totalstring

净销售额

discountstring

折扣金额

taxstring

税费

views_countstring

浏览次数

add_to_cart_countstring

加购次数

views_ratestring

浏览率

add_to_cart_ratestring

加购率

view_client_countstring

浏览客户端数量

add_cart_client_countstring

加购客户端数量

add_to_cart_conversion_ratestring

加购到下单转化率

transform_ratestring

转化率

duty_totalstring

关税总额

seo_urlstring

SEO 友好 URL

impressionstring

曝光次数

]

countint32

记录总数

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "data": [
      {
        "utm_source": "string",
        "utm_medium": "string",
        "utm_campaign": "string",
        "utm_term": "string",
        "utm_content": "string",
        "image": "string",
        "title": "string",
        "order_count_original": 0,
        "sales_count_original": 0,
        "sales_total_original": 0,
        "net_sales_total_original": 0,
        "discount_original": 0,
        "tax_original": 0,
        "views_count_original": 0,
        "add_to_cart_count_original": 0,
        "views_rate_original": 0,
        "add_to_cart_rate_original": 0,
        "view_client_count_original": 0,
        "add_cart_client_count_original": 0,
        "add_to_cart_conversion_rate_original": 0,
        "transform_rate_original": 0,
        "product_id": "string",
        "brief": "string",
        "spu": "string",
        "collection": "string",
        "created_at": "string",
        "first_published_at": "string",
        "published_at": "string",
        "product_op_updated_at": "string",
        "published": true,
        "duty_total_original": 0,
        "order_count": "string",
        "sales_count": "string",
        "sales_total": "string",
        "net_sales_total": "string",
        "discount": "string",
        "tax": "string",
        "views_count": "string",
        "add_to_cart_count": "string",
        "views_rate": "string",
        "add_to_cart_rate": "string",
        "view_client_count": "string",
        "add_cart_client_count": "string",
        "add_to_cart_conversion_rate": "string",
        "transform_rate": "string",
        "duty_total": "string",
        "seo_url": "string",
        "impression": "string"
      }
    ],
    "count": 0,
    "cursor": "string",
    "has_more": true
  }
}