- 西柚洞察OPENAPI-V2接入指引
- 西柚洞察OPENAPI接入指引（已归档）
- Release Notes
- 西柚洞察OPENAPI-V1接入指引（该接入已归档）
- asins
- asinSearchTerms
- searchTerms
- client
- 市场洞察
- foundation
获取类目季节性分析
POST
/v1/marketInsights/seasonInfo/impactAnalysis
本接口按处理次数计费。每处理 1 个类目计为 5 Credits 消耗
○ 公式：Credit 消耗 = 5
○ 示例：请求包含 1 个类目，将消耗 5 Credits
○ 调用前请先通过“生成类目洞察资源”接口创建资源，并在“查询市场资源状态”返回
success 后使用对应的 resourceId。○
seasonality.months 用于绘制全年 12 个月的季节性分布；salesComparison 用于展示旺淡季销量倍数；forecast.items 用于展示未来月份预测。请求参数
Header 参数
Body 参数application/json必填
示例
{
"resourceId": "3cdd069d0jj1f754",
"categoryId": "us_202605_87_akde91",
"country": "US"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.xydc.com/v1/marketInsights/seasonInfo/impactAnalysis' \
--header 'X-Auth-Version: 2.0' \
--header 'X-Api-Key: your_api_key' \
--header 'Content-Type: application/json' \
--data '{
"resourceId": "3cdd069d0jj1f754",
"categoryId": "us_202605_87_akde91",
"country": "US"
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"seasonality": {
"isSeasonal": true,
"currentMonth": 7,
"currentSeason": "off",
"months": [
{
"month": 1,
"seasonType": "shoulder",
"salesMultiplier": "1.00"
},
{
"month": 2,
"seasonType": "off",
"salesMultiplier": "0.82"
},
{
"month": 3,
"seasonType": "off",
"salesMultiplier": "0.78"
},
{
"month": 4,
"seasonType": "off",
"salesMultiplier": "0.75"
},
{
"month": 5,
"seasonType": "off",
"salesMultiplier": "0.72"
},
{
"month": 6,
"seasonType": "off",
"salesMultiplier": "0.70"
},
{
"month": 7,
"seasonType": "off",
"salesMultiplier": "0.73"
},
{
"month": 8,
"seasonType": "off",
"salesMultiplier": "0.80"
},
{
"month": 9,
"seasonType": "shoulder",
"salesMultiplier": "0.95"
},
{
"month": 10,
"seasonType": "shoulder",
"salesMultiplier": "1.05"
},
{
"month": 11,
"seasonType": "peak",
"salesMultiplier": "1.35"
},
{
"month": 12,
"seasonType": "peak",
"salesMultiplier": "1.48"
}
]
},
"salesComparison": {
"peakAvgMonthlySales": 4600,
"offAvgMonthlySales": 1000,
"peakToOffSalesRatio": "4.6"
},
"forecast": {
"baseMonth": 7,
"items": [
{
"month": 8,
"changeRate": "0.17"
},
{
"month": 9,
"changeRate": "0.34"
},
{
"month": 10,
"changeRate": "0.76"
}
]
}
}修改于 2026-07-28 09:28:58