Skip to main content
Version: 202607

Get data analysis land page

POST 
/openapi/2026-07/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​

Bodyrequired

    begin_timestringrequired

    Start time, a Unix timestamp in seconds passed as a string, e.g. "1748736000"

    end_timestringrequired

    End time, a Unix timestamp in seconds passed as a string, e.g. "1781481600". Should be greater than begin_time

    cursorstring

    Cursor for pagination

    page_sizeint32

    Page size for pagination

    Default value: 10
    sort_bystring

    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
    time_zoneint32

    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_directionstring

    Sort order: asc (ascending), desc (descending)

    dimensionsstring[]required

    Dimensions to retrieve. Supported values:

    • land_url_path: Landing page URL path
    • last_template_name: Page type
    • last_referrer_show: Last interactive source
    filtersstring

    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. 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_typestring

    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

Responses​

OK

Schema
    codestring

    error code

    messagestring

    error message

    data object
    countint32

    Total number of matching records

    last_updated_atstring

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

    cursorstring

    Cursor for pagination

    has_moreboolean

    Whether there are more records

    data object[]

    List of landing page analysis data items

  • Array [
    • last_referrer_showstring

    Last interaction source, e.g. "Direct"

    land_url_pathstring

    Landing page URL path, e.g. "/"

    last_template_namestring

    Page type display name, e.g. "Home Page"

    last_template_name_originalstring

    Page type enum value, e.g. "index"

    pvstring

    Page views, formatted string, e.g. "3"

    uvstring

    Unique store visitors, formatted string, e.g. "1"

    conversion_ratestring

    Conversion rate, formatted string, e.g. "0.00%"

    add_cart_uvstring

    Users who added items to cart, formatted string

    begin_checkout_uvstring

    Users who initiated checkout, formatted string

    add_payment_info_uvstring

    Users who submitted payment information, formatted string

    ordersstring

    Number of orders placed, formatted string

    salesstring

    Total sales amount, formatted string, e.g. "0.00"

    avg_elapsestring

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

    escape_ratestring

    Bounce rate, formatted string, e.g. "50.00%"

    pv_originalint32

    Page views, numeric value

    uv_originalint32

    Unique store visitors, numeric value

    conversion_rate_originalfloat

    Conversion rate, numeric value, e.g. 0

    add_cart_uv_originalint32

    Users who added items to cart, numeric value

    begin_checkout_uv_originalint32

    Users who initiated checkout, numeric value

    add_payment_info_uv_originalint32

    Users who submitted payment information, numeric value

    orders_originalint32

    Number of orders placed, numeric value

    sales_originalfloat

    Total sales amount, numeric value

    avg_elapse_originalfloat

    Average visit duration in microseconds, numeric value

    escape_rate_originalfloat

    Bounce rate, numeric value, e.g. 50 (represents 50%)

  • ]