Skip to main content
原始 Markdown

列出产品分析

POST/{version}/api/get/product-analysis/list

分析产品表现

速率限制：每秒 5 次请求。

version: v2-4-2.

请求

路径参数

versionstring必需
examplev2-4-2

请求头

ApiKeystring必需
default{{ApiKey}}
exampleYOUR_API_KEY

请求体

application/json
start_datestring必需

The start date range of the event in ISO format, e.g. 1970-01-01, the time zone should be consistent with your store settings.

end_datestring必需

The end date of the event in ISO format, e.g. 1970-01-01, the time zone should be consistent with your store settings.If you want to see the data for 1970-01-01, please enter 1970-01-02.

filtersarray [object]nullable

Filter criteria, currently supported options:

1. column=variant_id, operation=equal, values=product variant ID

子字段
columnstring
operationstring
valuesarray [string]
子字段
string
sortsarray [object]nullable

The default order is revenue desc.

子字段
columnstring

product_spend

revenue

product_added_to_cart_count

product_added_to_cart_user_count

checkout_started_count

checkout_started_user_count

product_viewed_count

product_viewed_user_count

payment_info_submitted_count

payment_info_submitted_user_count

checkout_shipping_info_submitted_count

checkout_shipping_info_submitted_user_count

checkout_address_info_submitted_count

checkout_address_info_submitted_user_count

checkout_contact_info_submitted_count

checkout_contact_info_submitted_user_count

checkout_completed_count

checkout_completed_user_count

product_average_quantity

product_quantity

roas

new_customer_roas

cpa

atc_to_purchase

uv_atc_to_purchase

orderstring

asc

desc

pageinteger必需

The min is 1

page_sizeinteger必需

The range is 1 to 100

请求示例
JSON
{
  "start_date": "2025-05-15",
  "end_date": "2025-05-21",
  "filters": [
    {
      "column": "variant_id",
      "operation": "equal",
      "values": [
        "43323899117824"
      ]
    }
  ],
  "sorts": [
    {
      "column": "revenue",
      "order": "desc"
    }
  ],
  "page": "1",
  "page_size": "20"
}

响应

响应体

application/json
codeinteger必需

1:success; < 0:failed

messagestring必需
dataobject必需
子字段
totalinteger必需

total

page_sizeinteger必需

page size

recordsarray [object]必需
子字段
product_namestring

product name

revenueinteger

revenue

product_viewed_countinteger

product viewed count

product_viewed_user_countinteger

product viewed user count

product_added_to_cart_countinteger

product added to cart count

product_added_to_cart_user_countinteger

product added to cart user count

checkout_started_countinteger

checkout started count

checkout_started_user_countinteger

checkout started user count

payment_info_submitted_countinteger

payment info submitted count

payment_info_submitted_user_countinteger

payment info submitted user count

checkout_shipping_info_submitted_countinteger
checkout_shipping_info_submitted_user_countinteger
checkout_address_info_submitted_countinteger
checkout_address_info_submitted_user_countinteger
checkout_contact_info_submitted_countinteger
checkout_contact_info_submitted_user_countinteger
checkout_completed_countinteger
checkout_completed_user_countinteger
product_spendinteger
product_quantityinteger
product_average_quantityinteger
roasinteger
new_customer_roasinteger
cpainteger
atc_to_purchaseinteger
uv_atc_to_purchaseinteger

响应头