**Version: 202601**

# Get data analysis land page

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

Retrieve landing page analytics including page views, unique visitors, add-to-cart rate, checkout funnel, orders, sales, bounce rate, and average session duration, grouped by landing page URL.

## Request

**application/json**

**Body | Example**

**Body (required)**

- `begin_time` string (required)

  Start time, a Unix timestamp in seconds passed as a string, e.g. "1748736000"
- `end_time` string (required)

  End time, a Unix timestamp in seconds passed as a string, e.g. "1781481600". Should be greater than begin\_time
- `cursor` string

  Cursor for pagination
- `page_size` int32

  Page size for pagination

  **Default value:** `10`
- `page` int32

  Page number (1-based). Mutually exclusive with cursor
- `sort_by` string

  Field to sort by. Supported values:

  *   `pv`: Page views
  *   `uv`: Unique visitors
  *   `add_cart_uv`: Unique visitors who added to cart
  *   `begin_checkout_uv`: Unique visitors who began checkout
  *   `add_payment_info_uv`: Unique visitors who added payment info
  *   `orders`: Number of orders
  *   `sales`: Total sales amount
  *   `conversion_rate`: Conversion rate
  *   `escape_rate`: Bounce rate
  *   `avg_elapse`: Average time spent on page
  *   `product_uv`: Unique visitors who viewed a product detail page
  *   `order_customers`: Number of customers who placed an order
- `time_zone` int32

  Notice: Values outside the range -12 to 14 might lead to unexpected results in time-based calculations. Time zone offset (in hours) used for analysis. Recommended range: -12 to 14
- `sort_direction` string

  Sort order: asc (ascending), desc (descending)
- `dimensions` string[] (required)

  Dimensions to retrieve. Supported values:

  *   `land_url_path`: Landing page URL path
  *   `last_template_name`: Page type
  *   `last_referrer_show`: Last interactive source
  *   `last_referrer_first_show`: Traffic type
- `filters` string

  Advanced filter conditions as a JSON string, expressed as a nested filter tree:

  *   Array node `[ ... ]`: its children are combined with OR
  *   Object node `{ ... }`: its entries are combined with AND
  *   Leaf node: {"operator": "...", "value": ...} attached under a filter key The `value` type to send depends on the operator (operators are case-insensitive):
  *   `in`, `not in` -> value is an ARRAY, e.g. \["a", "b"\]. A scalar will NOT match, so always send an array for these operators.
  *   `like`, `not like` -> value is a STRING, e.g. "google"
  *   `=`, `>`, `>=`, `<`, `<=` -> value is a SCALAR (string or number), e.g. 10 value is auto-converted to the target field type. Common keys: `land_url_path`, `last_template_name` (page type), `last_referrer_show` (traffic channel), `last_referrer_first_show` (traffic type). Unknown keys or unsupported operators are silently ignored, so a filter "not taking effect" usually means a mistyped key/operator. e.g. AND: {"land\_url\_path": {"operator": "like", "value": "/"}} OR : \[{"last\_referrer\_show": {"operator": "like", "value": "google"}}, {"last\_referrer\_show": {"operator": "like", "value": "facebook"}}\]
- `filter_crawler_type` string

  Crawler-filtering policy that controls whether bot/crawler traffic is excluded from the statistics. Values:

  *   `no_filter_crawler`: do not filter; count all traffic (default)
  *   `official_crawler`: exclude known crawlers/bots

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

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `count` int32

    Total number of matching records
  - `last_updated_at` string

    Latest statistics update time, e.g. "2026-03-26 00:00:00"
  - `cursor` string

    Cursor for pagination
  - `has_more` boolean

    Whether there are more records
  - `data` object[]

    List of landing page analysis data items

    *   Array \[

    - `last_referrer_show` string

      Last interaction source, e.g. "Direct"
    - `land_url_path` string

      Landing page URL path, e.g. "/"
    - `last_template_name` string

      Page type display name, e.g. "Home Page"
    - `last_template_name_original` string

      Page type enum value, e.g. "index"
    - `pv` string

      Page views, formatted string, e.g. "3"
    - `uv` string

      Unique store visitors, formatted string, e.g. "1"
    - `conversion_rate` string

      Conversion rate, formatted string, e.g. "0.00%"
    - `add_cart_uv` string

      Users who added items to cart, formatted string
    - `begin_checkout_uv` string

      Users who initiated checkout, formatted string
    - `add_payment_info_uv` string

      Users who submitted payment information, formatted string
    - `orders` string

      Number of orders placed, formatted string
    - `sales` string

      Total sales amount, formatted string, e.g. "0.00"
    - `avg_elapse` string

      Average visit duration, formatted string, e.g. "22m42s"
    - `escape_rate` string

      Bounce rate, formatted string, e.g. "50.00%"
    - `pv_original` int32

      Page views, numeric value
    - `uv_original` int32

      Unique store visitors, numeric value
    - `conversion_rate_original` float

      Conversion rate, numeric value, e.g. 0
    - `add_cart_uv_original` int32

      Users who added items to cart, numeric value
    - `begin_checkout_uv_original` int32

      Users who initiated checkout, numeric value
    - `add_payment_info_uv_original` int32

      Users who submitted payment information, numeric value
    - `orders_original` int32

      Number of orders placed, numeric value
    - `sales_original` float

      Total sales amount, numeric value
    - `avg_elapse_original` float

      Average visit duration in microseconds, numeric value
    - `escape_rate_original` float

      Bounce rate, numeric value, e.g. 50 (represents 50%)
    - `last_referrer_first_show` string

      Traffic type
    - `product_uv` string

      Users who viewed a product detail page
    - `product_uv_original` int32

      Users who viewed a product detail page, numeric value
    - `order_customers` string

      Number of customers who placed an order
    - `order_customers_original` int32

      Number of customers who placed an order, numeric value
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "count": 0,
    "last_updated_at": "string",
    "cursor": "string",
    "has_more": true,
    "data": [
      {
        "last_referrer_show": "string",
        "land_url_path": "string",
        "last_template_name": "string",
        "last_template_name_original": "string",
        "pv": "string",
        "uv": "string",
        "conversion_rate": "string",
        "add_cart_uv": "string",
        "begin_checkout_uv": "string",
        "add_payment_info_uv": "string",
        "orders": "string",
        "sales": "string",
        "avg_elapse": "string",
        "escape_rate": "string",
        "pv_original": 0,
        "uv_original": 0,
        "conversion_rate_original": 0,
        "add_cart_uv_original": 0,
        "begin_checkout_uv_original": 0,
        "add_payment_info_uv_original": 0,
        "orders_original": 0,
        "sales_original": 0,
        "avg_elapse_original": 0,
        "escape_rate_original": 0,
        "last_referrer_first_show": "string",
        "product_uv": "string",
        "product_uv_original": 0,
        "order_customers": "string",
        "order_customers_original": 0
      }
    ]
  }
}
```