**版本：202601**

# 查询数据分析

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

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

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `begin_time` string (required)

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

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

  查询指标列表，根据所请求的维度分为两组： 自定义指标（搭配自定义维度使用）：

  *   `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`：销售额
- `cursor` string

  分页游标
- `page_size` int32

  每页记录数

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

  页码（从 1 开始），与 cursor 互斥
- `time_zone` int32

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

  排序字段
- `sort_direction` string

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

  日期分组方式，可选值：`dt_by_hour`（按小时）、`dt_by_day`（按天）
- `dimension` string[]

  查询维度列表，分为两组： 自定义维度：

  *   `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
- `filter_crawler_type` string

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

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

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

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `data` object[]

    数据列表

    *   Array \[

    - `date_time` string

      日期和时间
    - `country_abbr` string

      国家缩写
    - `country_code` string

      国家代码（如 CN）
    - `utm_source` string

      UTM 来源
    - `utm_medium` string

      UTM 媒介
    - `utm_campaign` string

      UTM 活动名称
    - `utm_term` string

      UTM 关键词
    - `utm_content` string

      UTM 内容
    - `pv` int32

      页面浏览次数
    - `uv` int32

      唯一访客数
    - `add_cart_uv` int32

      加购唯一访客数
    - `add_cart_qty` int32

      加购数量
    - `add_payment_info_uv` int32

      提交支付信息唯一访客数
    - `begin_checkout_pv` int32

      发起结账页面浏览次数
    - `begin_checkout_uv` int32

      发起结账唯一访客数
    - `orders` int32

      订单数量
    - `sales` float

      销售额
    - `conversion_rate` float

      转化率
    - `impression` int32

      曝光次数
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录
  - `count` int32

    全部页的总记录数

```json
{
  "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,
    "count": 0
  }
}
```