查询数据分析

POST 
/openapi/2026-07/data-analysis

获取指定时间范围和维度的数据分析结果。

请求

application/json

请求体

请求体必填

begin_timestring必填

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

end_timestring必填

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

indicatorstring[]必填
查询指标列表，根据所请求的维度分为两组： 自定义指标（搭配自定义维度使用）：
• pv：页面浏览次数
• uv：独立访客数
• add_cart_uv：加购独立访客数
• add_cart_qty：加购数量
• add_payment_info_uv：提交支付信息独立访客数
• begin_checkout_pv：发起结账页面浏览次数
• begin_checkout_uv：发起结账独立访客数
• orders：订单数量
• sales：销售额
• conversion_rate：转化率
• impression：曝光次数 UTM 指标（搭配 UTM 维度使用）：
• pv：页面浏览次数
• uv：独立访客数
• add_cart_uv：加购独立访客数
• begin_checkout_pv：发起结账页面浏览次数
• begin_checkout_uv：发起结账独立访客数
• orders：订单数量
• sales：销售额
cursorstring

分页游标

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

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

sort_bystring

排序字段

sort_directionstring

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

dt_bystring

日期分组方式，可选值：dt_by_hour（按小时）、dt_by_day（按天）

dimensionstring[]
查询维度列表，分为两组： 自定义维度：
• country_code：国家代码 UTM 维度：
• utm_source：UTM 来源
• utm_medium：UTM 媒介
• utm_term：UTM 关键词
• utm_campaign：UTM 活动名称
• utm_content：UTM 活动内容
filters object
简单等值筛选，键为维度名、值为要精确匹配的内容，例如 {"country_code": "US"} 每个条目为一个等值条件，多个条目之间为 AND；仅支持 dimension 字段枚举内的键，未识别 的键将被忽略。
property name*string

示例

{
  "begin_time": "string",
  "end_time": "string",
  "indicator": [
    "string"
  ],
  "cursor": "string",
  "page_size": 10,
  "time_zone": 0,
  "sort_by": "string",
  "sort_direction": "string",
  "dt_by": "string",
  "dimension": [
    "string"
  ],
  "filters": {}
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

data object[]

数据列表

Array [

date_timestring

日期和时间

country_abbrstring

国家缩写

country_codestring

国家代码（如 CN）

utm_sourcestring

UTM 来源

utm_mediumstring

UTM 媒介

utm_campaignstring

UTM 活动名称

utm_termstring

UTM 关键词

utm_contentstring

UTM 内容

pvint32

页面浏览次数

uvint32

唯一访客数

add_cart_uvint32

加购唯一访客数

add_cart_qtyint32

加购数量

add_payment_info_uvint32

提交支付信息唯一访客数

begin_checkout_pvint32

发起结账页面浏览次数

begin_checkout_uvint32

发起结账唯一访客数

ordersint32

订单数量

salesfloat

销售额

conversion_ratefloat

转化率

impressionint32

曝光次数

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "data": [
      {
        "date_time": "string",
        "country_abbr": "string",
        "country_code": "string",
        "utm_source": "string",
        "utm_medium": "string",
        "utm_campaign": "string",
        "utm_term": "string",
        "utm_content": "string",
        "pv": 0,
        "uv": 0,
        "add_cart_uv": 0,
        "add_cart_qty": 0,
        "add_payment_info_uv": 0,
        "begin_checkout_pv": 0,
        "begin_checkout_uv": 0,
        "orders": 0,
        "sales": 0,
        "conversion_rate": 0,
        "impression": 0
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}