版本：202201
根据 SPU 获取数据分析
POST/openapi/2024-07/data-analysis/spu
通过 SPU、SKU 或专辑维度分析商品，提供详细的销售数据洞察。
请求
- application/json
- 请求体
- 示例
请求体
typestring必填
Analysis mode
- product: Displays sales by spu
- variant: Queries sales by sku
- collection: Album page report
begin_timeint64必填
The starting timestamp (in seconds) for retrieving analysis data. Must be a valid Unix timestamp and less than end_time. Logic
end_timeint64必填
The ending timestamp (in seconds) for retrieving analysis data. Must be a valid Unix timestamp and greater than begin_time.
tzfloat必填
Time zone, e.g. 8
pageint32
Page number
limitint32
Limit per page, default 50, max 500
sort_bystring
Sort field
sort_directionstring
Sorting direction: asc (ascending) or desc (descending).
collection_idstring
The Collection ID uniquely identifies a group of products within a collection. When the collection id is passed, it is filtered based on the collection ID
keywordstring
When the keyword is not empty, the product is filtered. Keywords will vaguely match these fields of the product: title, id, brief, sku, spu, tags， note
search_modelstring
The filtering mode can be base or advanced. The default value is base. If you select advanced, the filters filter takes effect
filtersjson
Conditions for advanced filtering mode
{
"type": "string",
"begin_time": 0,
"end_time": 0,
"tz": 0,
"page": 0,
"limit": 0,
"sort_by": "string",
"sort_direction": "string",
"collection_id": "string",
"keyword": "string",
"search_model": "string",
"filters": "string"
}
响应
- 200
- 400
200
- application/json
- 数据结构
- 示例
- Result
数据结构
- Array [
- ]
codestring
示例：
200messagestring
示例：
OKcountinteger
默认值：
0示例：
3data object[]
utm_sourcestring
示例：
utm_mediumstring
示例：
utm_campaignstring
示例：
utm_termstring
示例：
utm_contentstring
示例：
imagestring
示例：
free/5d4c48f9e65ffab9e73efbf1fd37a0f3.jpgtitlestring
示例：
test1order_count_originalinteger
默认值：
0示例：
1sales_count_originalinteger
默认值：
0示例：
1sales_total_originalinteger
默认值：
0示例：
20net_sales_total_originalinteger
默认值：
0示例：
19discount_originalinteger
默认值：
0示例：
1tax_originalinteger
默认值：
0示例：
0views_count_originalinteger
默认值：
0示例：
1add_to_cart_count_originalinteger
默认值：
0示例：
1views_rate_originalinteger
默认值：
0示例：
50add_to_cart_rate_originalinteger
默认值：
0示例：
25view_client_count_originalinteger
默认值：
0示例：
1add_cart_client_count_originalinteger
默认值：
0示例：
1add_to_cart_conversion_rate_originalinteger
默认值：
0示例：
100transform_rate_originalinteger
默认值：
0示例：
100product_idstring
示例：
e2da343c-182c-4908-b009-557cea226829briefstring
示例：
spustring
示例：
123collectionstring
示例：
Collectionx_2022-06-2709created_atstring
示例：
2022-03-24 19:18:44first_published_atstring
示例：
published_atstring
示例：
2022-03-24 19:18:44product_op_updated_atstring
示例：
2023-08-21 15:43:34publishedboolean
默认值：
true示例：
trueorder_countstring
示例：
1sales_countstring
示例：
1sales_totalstring
示例：
20.00net_sales_totalstring
示例：
19.00discountstring
示例：
1.00taxstring
示例：
0.00views_countstring
示例：
1add_to_cart_countstring
示例：
1views_ratestring
示例：
50.00%add_to_cart_ratestring
示例：
25.00%view_client_countstring
示例：
1add_cart_client_countstring
示例：
1add_to_cart_conversion_ratestring
示例：
100.00%transform_ratestring
示例：
100.00%seo_urlstring
示例：
/products/test1{
"code": "200",
"message": "OK",
"count": 3,
"data": [
{
"utm_source": "",
"utm_medium": "",
"utm_campaign": "",
"utm_term": "",
"utm_content": "",
"image": "free/5d4c48f9e65ffab9e73efbf1fd37a0f3.jpg",
"title": "test1",
"order_count_original": 1,
"sales_count_original": 1,
"sales_total_original": 20,
"net_sales_total_original": 19,
"discount_original": 1,
"tax_original": 0,
"views_count_original": 1,
"add_to_cart_count_original": 1,
"views_rate_original": 50,
"add_to_cart_rate_original": 25,
"view_client_count_original": 1,
"add_cart_client_count_original": 1,
"add_to_cart_conversion_rate_original": 100,
"transform_rate_original": 100,
"product_id": "e2da343c-182c-4908-b009-557cea226829",
"brief": "",
"spu": "123",
"collection": "Collectionx_2022-06-2709",
"created_at": "2022-03-24 19:18:44",
"first_published_at": "",
"published_at": "2022-03-24 19:18:44",
"product_op_updated_at": "2023-08-21 15:43:34",
"published": true,
"order_count": "1",
"sales_count": "1",
"sales_total": "20.00",
"net_sales_total": "19.00",
"discount": "1.00",
"tax": "0.00",
"views_count": "1",
"add_to_cart_count": "1",
"views_rate": "50.00%",
"add_to_cart_rate": "25.00%",
"view_client_count": "1",
"add_cart_client_count": "1",
"add_to_cart_conversion_rate": "100.00%",
"transform_rate": "100.00%",
"seo_url": "/products/test1"
}
]
}
{
"code": "200",
"message": "OK",
"count": 3,
"data": [
{
"utm_source": "",
"utm_medium": "",
"utm_campaign": "",
"utm_term": "",
"utm_content": "",
"image": "free/5d4c48f9e65ffab9e73efbf1fd37a0f3.jpg",
"title": "test1",
"order_count_original": 1,
"sales_count_original": 1,
"sales_total_original": 20,
"net_sales_total_original": 19,
"discount_original": 1,
"tax_original": 0,
"views_count_original": 1,
"add_to_cart_count_original": 1,
"views_rate_original": 50,
"add_to_cart_rate_original": 25,
"view_client_count_original": 1,
"add_cart_client_count_original": 1,
"add_to_cart_conversion_rate_original": 100,
"transform_rate_original": 100,
"product_id": "e2da343c-182c-4908-b009-557cea226829",
"brief": "",
"spu": "123",
"collection": "Collectionx_2022-06-2709",
"created_at": "2022-03-24 19:18:44",
"first_published_at": "",
"published_at": "2022-03-24 19:18:44",
"product_op_updated_at": "2023-08-21 15:43:34",
"published": true,
"order_count": "1",
"sales_count": "1",
"sales_total": "20.00",
"net_sales_total": "19.00",
"discount": "1.00",
"tax": "0.00",
"views_count": "1",
"add_to_cart_count": "1",
"views_rate": "50.00%",
"add_to_cart_rate": "25.00%",
"view_client_count": "1",
"add_cart_client_count": "1",
"add_to_cart_conversion_rate": "100.00%",
"transform_rate": "100.00%",
"seo_url": "/products/test1"
}
]
}
400
- application/json
无 Schema